Claude Code×Teams 会議トランスクリプトで議事録|権限だけでは取れない理由

Teams 会議の文字起こしを Graph で取り、Claude API で決定事項と担当つきのタスクに分ける手順です。アプリの権限のほかに、既定でオフのトランスクリプト API アクセスなど管理者の設定を開けます。

この記事をシェア:
目次 クリックで開く

この記事の要点

  1. Microsoft Graph の会議トランスクリプト API で文字起こし(WebVTT)を取り、Claude API に JSON の形を指定して渡すと、決定事項と担当・期日つきのタスクに分けられます。Planner への登録とメールの送信も、同じ Graph でできます。
  2. アプリの権限(OnlineMeetingTranscript.Read.All と管理者の同意)だけでは取れません。開催者ごとのアプリケーション アクセス ポリシーと、テナント全体の[トランスクリプト API アクセス](既定でオフ)を、Teams の管理者に設定してもらう必要があります。担当者を発言から拾うなら[話者属性を含める]も要ります。
  3. スクリプトは下書きまでにして、人が担当と期日を確かめてから Planner に登録し、メールで送ります。Teams Premium か Copilot のライセンスがある人には、Teams の要約とファシリテーターという Microsoft の機能もあります。

作例のスクリプトがすること

1. 取るGraph で会議を探し、文字起こし(WebVTT)を取る
2. 読む話者と発言に分け、同じ人の続きをまとめる
3. 分けるClaude API で決定事項・タスク・未決・リスクの JSON に
4. 人が確かめるminutes.json の担当・期日・要確認を直す
5. 登録・送信Planner にタスク、議事録をメールで

1 の前に、管理者の設定が要る。設定が済んでいないと 403 で止まるか、文字起こしが取れない

出典:Microsoft Learn「Get callTranscript」、Claude「構造化出力」、Microsoft Learn「Create plannerTask」

Teams 会議の文字起こしは、Microsoft Graph の API でスクリプトから取り出せます。取り出した WebVTT を Claude API に渡し、返す JSON の形を指定すれば、決定事項、担当と期日のついたタスク、未決のことに分けた議事録の下書きになります。スクリプトは Claude Code に頼めば短く書けます。手間がかかるのはその手前の、管理者の設定です。

当社は、Claude Code の導入と Microsoft 365 の運用の両方を手がけています。この記事は、Teams 会議の議事録とタスクを自動で作りたい担当の方と、その許可を出す Teams・Microsoft Entra の管理者に向けて書いています。扱うのは予定表から作った会議の文字起こしで、その場で始めた通話(アドホック通話)、会議に参加するボット、録画のファイルは扱いません。

コードを書かない人の始め方と、任せていい仕事の線引きを、動画にまとめています↓↓

作例:定例会議1本の文字起こしから、決定事項と担当つきのタスクを作る

この記事では、例を1つに決めて最後まで使います。流れは次のとおりです。社内の定例会議を1本、文字起こしをオンにして開き、終わったあとにその文字起こしから議事録の下書きを作ります。人が担当と期日を確かめてから、タスクを Planner の決まったプランに登録し、議事録を出席者にメールで送ります。会議の中身や人名は説明のための架空のもので、特定の会社の運用ではありません。

作る前に、Microsoft の機能で足りるかを見ておきます(下の図)。Teams Premium か Copilot のライセンスを出席者が持っているなら、Teams の要約とファシリテーターで、AI のメモやフォローアップ タスクまで出ます。会議のメモに手でタスクを書いて Planner に登録する方法は、Teams×Planner×Outlook|会議で決めた作業の置き場所と期限を持つ人で書いています。ライセンスを配らない場合や、議事録の形と登録先を自社で決めたい場合に、この記事の作り方が要ります。

会議の文字起こしから要約とタスクを作る3つの道

Teams の要約・ファシリテーター

Teams の画面で。開発なし

  • インテリジェント要約:Teams Premium(アドオン)か Microsoft Copilot のライセンス。AI のメモとフォローアップ タスク。対応言語で文字起こしした5分以上の会議
  • ファシリテーター:Microsoft Copilot のライセンス。[同期に同意する]で Planner へ。プレビューの機能を含む
  • 要約の形は Microsoft が決める

Meeting AI Insights API

Graph で。Copilot の結果を取り出す

  • 要約・アクション項目・メンションを API で取れる
  • Microsoft 365 Copilot のライセンスを持つ利用者の分だけ
  • 取り出した後の登録先は自分で作る

文字起こし+Claude API(この記事)

Graph と Claude API で。スクリプトを作る

  • Copilot のライセンスは要らない。Claude API は使った分の従量
  • 議事録の形・確かめ方・登録先を自分で決める
  • 管理者がアプリの権限と Teams の設定を許可する

出典:Microsoft サポート「Microsoft Teams の要約」、「Microsoft Teams 会議のファシリテーター」、Microsoft Learn「Meeting AI Insights API」

前提:Microsoft Entra にアプリを登録し、アプリの権限を付ける

だれもサインインしていないスクリプトから取るので、権限は「アプリケーションの許可」を使います。Microsoft Entra 管理センターの[アプリの登録]でアプリを作り、[API のアクセス許可]→[アクセス許可の追加]→[Microsoft Graph]→[アプリケーションのアクセス許可]で権限を足し、管理者が[管理者の同意の付与]を押します(Microsoft Learn「Web API にアクセスするようにクライアント アプリケーションを構成する」)。スクリプトはスコープに https://graph.microsoft.com/.default を指定してトークンを取ります(Microsoft Learn「デーモン アプリのトークンを取得する」)。作例は分かりやすさのためにクライアント シークレットで書いていますが、Microsoft は本番では証明書を勧めています(Microsoft Learn「資格情報を追加する」)。

作例で使う Graph の API と、最小の特権として示されているアプリケーションの許可
API(作例で使う所)アプリケーションの許可何に使うか
GET /users/{開催者}/onlineMeetings?$filter=JoinWebUrl eq '…'OnlineMeetings.Read.All参加リンクから会議の ID を引く(Get onlineMeeting)
GET …/onlineMeetings/{会議}/transcriptsOnlineMeetingTranscript.Read.All会議の文字起こしの一覧(List transcripts)
GET …/transcripts/{文字起こし}/content同上文字起こしの本文(Get callTranscript)
POST /planner/tasksTasks.ReadWrite.Allタスクの登録(Create plannerTask)
POST /users/{送る人}/sendMailMail.Send議事録のメール(user: sendMail)

アプリの権限は組織の全員に届きます。OnlineMeetingTranscript.Read.All は「すべてのオンライン会議のすべての文字起こしを読む」、Mail.Send は「どの利用者としてもメールを送る」、Tasks.ReadWrite.All は「組織の全員のタスクを作成・読み取り・更新・削除する」権限です(Microsoft Learn「Microsoft Graph のアクセス許可のリファレンス」)。下書きを作るだけなら、上の2行(会議と文字起こしを読む権限)で足ります。登録と送信の権限は、下書きを人が何回か確かめてから足せます。会議ごとに許可を出す OnlineMeetingTranscript.Read.Chat(リソース固有の同意)もありますが、対象は予定されたプライベートのチャット会議だけで、チャネル会議には使えません(List transcripts)。

アプリの権限を付けても、まだ取れない。管理者が開ける4つの設定

権限を付けて同意しても、スクリプトはまだ止まります。文字起こしの API は、Graph の権限のほかに Teams の側の設定で守られているからです。開けるのは開発する人ではなく、Teams の管理者です。アクセス ポリシーと会議ポリシーは、作例なら定例会議の開催者1人の分で足ります。[トランスクリプト API アクセス]と[話者属性を含める]はテナント全体の設定で、オンにすると、文字起こしの権限を持つほかのアプリにも効きます。アプリごとの許可やブロックは、Microsoft Entra 管理センターで各アプリの API のアクセス許可として管理します(Microsoft Learn「Teams 会議のトランスクリプト API アクセスを管理する」)。

文字起こしを取るまでに、だれがどこで何を開けるか

Entra の管理者Microsoft Entra 管理センター
アプリの登録アプリケーションの許可を足す
管理者の同意の付与付けた権限に組織として同意する
Teams の管理者(1)PowerShell・開催者ごと
アプリケーション アクセス ポリシーアプリの ID を入れたポリシーを作り、開催者に付与する。反映まで最大30分
Teams の管理者(2)Teams 管理センター[会議]→[会議の設定]・テナント全体
トランスクリプト API アクセス[Microsoft Graph アクセス]をオン(既定はオフ)
話者属性を含める[構成]からオン(既定はオフ)
Teams の管理者(3)Teams 管理センター[会議]→[会議ポリシー]・利用者ごと
文字起こし開催者と、文字起こしを始める人の両方のポリシーでオン(新しいポリシーは既定でオン)

話者属性のほかは、設定されていないとスクリプトの側では回避できない(話者属性は、話者なしの形式で取り直せる)

出典:Microsoft Learn「オンライン会議へのアプリケーション アクセスを構成する」、「Teams 会議のトランスクリプト API アクセスを管理する」、「Teams 会議の文字起こしとキャプションを管理する」

1. アプリケーション アクセス ポリシー:どの開催者の会議を読めるか

ポリシーを付与された利用者の代わりに、ポリシーに入れたアプリが会議と文字起こしを取れるようになります。要求の URL の /users/{ユーザー ID} に入れるのは、その利用者の ID です(Microsoft Learn「オンライン会議へのアプリケーション アクセスを構成する」)。

管理者が実行する PowerShell(公式ページの手順の形。名前と ID は自社のものに)

New-CsApplicationAccessPolicy -Identity Minutes-App-Policy -AppIds "<アプリの クライアント ID>" -Description "議事録の下書きを作るアプリ"
Grant-CsApplicationAccessPolicy -PolicyName Minutes-App-Policy -Identity "<開催者の ユーザー(オブジェクト) ID>"

-Global でテナント全体に付与することもできますが、読める会議が組織の全員に広がります。文字起こしを読む権限の強さに見合うのは、作例のように開催者を指定する付け方です。変更が効くまで最大30分かかります。ポリシーが付いていないと、No application access policy found for this app の 403 が返ります。

2. トランスクリプト API アクセス:既定でオフ

オフのあいだは、アプリの権限があっても文字起こしに触れられません。管理者が[Microsoft Graph アクセス]をオンにします。PowerShell なら次の1行で、-Identity Global のとおり組織全体にかかります。

管理者が実行する PowerShell(公式ページの例。話者属性もまとめてオンにする)

Set-CsTeamsMeetingConfiguration -EnableGraphTranscriptAccess true -EnableAttributedTranscripts true -Identity Global

オフのままだと、一覧・本文・変更通知の購読のどれも 403 になり、innerError.code に GraphAccessToTranscriptsDisabled が入ります。要求の側で回避する方法は無く、管理者が有効にするまで続きます(Microsoft Learn「Get callTranscript」)。この管理者の設定と話者なしの形式は、2026年7月末から効くようになりました。前から動いていたスクリプトがこのエラーを返し始めたなら、まずここを疑います。

3. 話者属性を含める:担当者を発言から拾うなら必要

オフのまま話者つきの text/vtt を頼むと SpeakerAttributionNotAllowed の 403 が返ります。話者なしの形式で頼み直せば取れます(Get callTranscript)。作例のスクリプトもそう動きます。ただ、話者が無いと「田中さん、移行の対象を来週までに」がだれの発言かを Claude は読み取れません。担当者を下書きに入れたいならオンにしてもらい、オンにできない会社では担当者の欄を人が埋める前提で動かします。

4. 会議ポリシーの[文字起こし]:開催者と始めた人の両方

このポリシーがオフで文字起こしが作られていなければ、エラーではなく、一覧が空で返ります。PowerShell では Set-CsTeamsMeetingPolicy の -AllowTranscription です。開催者が会議で Microsoft Copilot をオフにすると、録画と文字起こしもオフになる点にも気をつけます(Microsoft Learn「Teams 会議の文字起こしとキャプションを管理する」)。

文字起こしを取る API と、2つの形式

設定が済んだら、作例のスクリプトは Graph を3回呼びます。参加リンク(joinWebUrl)から会議の ID を引き、文字起こしの一覧を取り、いちばん新しい文字起こしの本文を取ります(Get onlineMeeting、List transcripts、Get callTranscript)。

作例で呼ぶ順(参加リンクは URL エンコードして渡す)

GET https://graph.microsoft.com/v1.0/users/{開催者のユーザー ID}/onlineMeetings?$filter=JoinWebUrl eq '{参加リンク}'
GET https://graph.microsoft.com/v1.0/users/{開催者のユーザー ID}/onlineMeetings/{会議 ID}/transcripts
GET https://graph.microsoft.com/v1.0/users/{開催者のユーザー ID}/onlineMeetings/{会議 ID}/transcripts/{文字起こし ID}/content
Accept: text/vtt

作例のスクリプトが呼ぶ順と、要る権限・止まったときの応答

1. 会議の ID

onlineMeetings を参加リンクで引く

権限:OnlineMeetings.Read.All

止まると:ポリシーが無いと 403 No application access policy found for this app

2. 一覧

transcripts の一覧

権限:OnlineMeetingTranscript.Read.All

止まると:API アクセスがオフなら 403 GraphAccessToTranscriptsDisabled。文字起こしが無ければ空

3. 本文

content を text/vtt で取る

権限:同上

止まると:話者属性がオフなら 403 SpeakerAttributionNotAllowed。話者なしの形式で取り直す

4. 要約

Claude API の構造化出力

要るもの:Claude の API キー(従量)

止まると:stop_reason が end_turn でなければ止める(拒否・max_tokens)

5. 登録

Planner にタスク、議事録をメールで

権限:Tasks.ReadWrite.All、Mail.Send

止まると:Planner は 400・403・404。メールの 202 は受け付けただけ

出典:Get onlineMeeting、List transcripts、Get callTranscript、Claude「構造化出力」、Create plannerTask、user: sendMail

文字起こしの本文の2つの形式

text/vtt(既定)

話者つき

  • 時刻と <v 話者> のタグがついた WebVTT
  • Accept ヘッダーか、クエリの format の指定で選ぶ
  • [話者属性を含める]がオフだと 403(SpeakerAttributionNotAllowed)

application/vnd.microsoft.graph.transcript+text

話者なし

  • 時刻つきの発言。話者の情報は無い
  • Accept ヘッダーでだけ選べる
  • 話者属性の設定では止まらない(トランスクリプト API アクセスは要る)

出典:Microsoft Learn「Get callTranscript」。以前あった docx の形式は2023年5月31日に廃止

Get callTranscript の応答の例(Microsoft Learn のまま)

WEBVTT

00:00:16.246 --> 00:00:17.726
<v User Name>This is a transcript test.</v>

取れない会議もあります。create onlineMeeting の API で作って予定表の予定に結びついていない会議と、期限切れの会議です(List transcripts)。期限は会議の種類で違います。定例会議のような定期の会議なら、終了日があれば終了日か最後の回から60日の遅いほう、終了日が無ければ最後に参加・更新してから1年です。この表は今、パブリック プレビューの印つきです(Microsoft Learn「Microsoft Teams の制限事項と仕様」)。作例は会議の当日に取りに行くので、期限にはかかりません。開催者の全会議の分をまとめて取る getAllTranscripts もあります。こちらはアプリケーションの許可だけで使え、チャネル会議の分は今のところ取れません(Microsoft Learn「onlineMeeting: getAllTranscripts」)。文字起こしと録画の API は、2025年8月25日から従量の課金の対象から外れています(Microsoft Learn「Graph API を使用して会議のトランスクリプトと録音を取得する」)。

Claude Code への頼み方:下書きと登録を分けて書かせる

Claude Code には、使う API・権限・止め方まで先に書いて頼みます。大事なのは、Planner への登録とメールの送信を、下書きとは別の実行にさせることです。文字起こしの聞き違いや、提案と決定の取り違えがそのまま担当者に届くと、取り消すのは人の手間になります。作例では次のように頼みました(指示文も作例です)。

作例:Claude Code への指示

Teams 会議の文字起こしから議事録の下書きを作る Python のスクリプトを書いてください。
・Microsoft Graph にはアプリの権限(クライアント資格情報)で入る。msal を使う。値は環境変数から読む
・draft のとき:参加リンクから会議を探し、いちばん新しい文字起こしを text/vtt で取る。403 で SpeakerAttributionNotAllowed が返ったら、application/vnd.microsoft.graph.transcript+text で取り直す
・WebVTT を話者と発言に分け、Claude API の構造化出力(output_config.format の json_schema)で、title・summary・decisions・action_items(owner・task・due・needs_check)・open_questions・risks の JSON にする。stop_reason が end_turn でなければ止める
・minutes.json と minutes.md に書くだけで、何も登録・送信しない
・apply のとき:人が直した minutes.json を読み、needs_check が残っていたら止める。担当者は members.json の対応表でユーザー ID に替え、Planner に登録してからメールで送る
・文字起こしの中身や議事録の本文は画面に出さない(件数だけ出す)

Claude に返させる JSON は、構造化出力でスキーマに沿わせます。output_config.format に json_schema とスキーマを入れると、応答がスキーマに合った JSON になります。ただし、拒否されたとき(stop_reason が refusal)と、出力が max_tokens で切れたときは、スキーマと合わないことがあります。長い会議で起こりうるので、作例は stop_reason を確かめてから JSON として読みます。オブジェクトには additionalProperties: false が要るなど、使える JSON Schema には決まりがあります(Claude「構造化出力」)。作例のモデル claude-sonnet-5-5 は対応するモデルに入っています(Claude「モデルの概要」)。指示文では、決定事項には「合意したと発言から読み取れることだけ」を入れさせ、提案・保留は未決のことに分けさせます。人名・金額・日付は文字起こしで誤りやすいので、疑わしいタスクに needs_check を立てさせ、apply の前に人が見る場所を決めておきます。

作例のスクリプト全文

上の指示で書かせ、人が読んで直したものです。構文の確認だけをしたもので、実際のテナントに対しては動かしていません。ライブラリは pip install msal requests anthropic で入れます。資格情報(クライアント シークレットと Claude の API キー)は環境変数に置き、ファイルに書きません。

作例:meeting_minutes.py(構文の確認だけ。テナントに対しては動かしていない)

"""Teams 会議の文字起こしから議事録の下書きを作り、人が確かめた後で Planner とメールに流す(作例)。

使い方:
  python meeting_minutes.py draft "<会議の参加リンク>"   … 下書き(minutes.json と minutes.md)を作るだけ。何も登録・送信しない
  python meeting_minutes.py apply                       … 人が直した minutes.json を Planner に登録し、議事録をメールで送る

環境変数: TENANT_ID, CLIENT_ID, CLIENT_SECRET, ORGANIZER_ID(会議の開催者のユーザー ID),
          PLAN_ID, BUCKET_ID, MAIL_TO(送り先。カンマ区切り), ANTHROPIC_API_KEY
担当者の名前とユーザー ID の対応は members.json に自分で書いておく(例: {"田中": "<ユーザー ID>"})。
"""
import json
import os
import re
import sys
from pathlib import Path
from urllib.parse import quote

import anthropic
import msal
import requests

GRAPH = "https://graph.microsoft.com/v1.0"
ROOT = Path(__file__).parent
MINUTES_JSON = ROOT / "minutes.json"
MINUTES_MD = ROOT / "minutes.md"
MODEL = "claude-sonnet-5-5"

SCHEMA = {
    "type": "object",
    "properties": {
        "title": {"type": "string"},
        "summary": {"type": "string"},
        "decisions": {"type": "array", "items": {"type": "string"}},
        "action_items": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "owner": {"type": "string"},
                    "task": {"type": "string"},
                    "due": {"type": "string", "description": "YYYY-MM-DD。発言に期日が無ければ空文字"},
                    "needs_check": {"type": "boolean"},
                },
                "required": ["owner", "task", "due", "needs_check"],
                "additionalProperties": False,
            },
        },
        "open_questions": {"type": "array", "items": {"type": "string"}},
        "risks": {"type": "array", "items": {"type": "string"}},
    },
    "required": ["title", "summary", "decisions", "action_items", "open_questions", "risks"],
    "additionalProperties": False,
}

PROMPT = """次は Teams 会議の文字起こしです。スキーマどおりに議事録を作ってください。
- decisions には、会議で合意したと発言から読み取れることだけを入れる。提案・希望・保留は open_questions に入れる
- action_items の owner は、発言に出た名前のまま書く。担当が決まっていなければ空文字にする
- 人名・金額・日付で、文字起こしの誤りが疑われるタスクは needs_check を true にする
- 文字起こしに無いことを足さない"""


def graph_token():
    app = msal.ConfidentialClientApplication(
        os.environ["CLIENT_ID"],
        authority="https://login.microsoftonline.com/" + os.environ["TENANT_ID"],
        client_credential=os.environ["CLIENT_SECRET"],
    )
    result = app.acquire_token_for_client(scopes=["https://graph.microsoft.com/.default"])
    if "access_token" not in result:
        sys.exit("トークンを取れませんでした: " + result.get("error_description", ""))
    return result["access_token"]


def call(token, method, url, accept="application/json", body=None):
    headers = {"Authorization": "Bearer " + token, "Accept": accept}
    r = requests.request(method, url, headers=headers, json=body, timeout=60)
    if r.status_code >= 400:
        sys.exit(f"{r.status_code} {url}\n{r.text[:500]}")
    return r


def fetch_transcript(token, organizer, join_url):
    base = f"{GRAPH}/users/{organizer}/onlineMeetings"
    flt = quote(f"JoinWebUrl eq '{join_url}'")
    meetings = call(token, "GET", f"{base}?$filter={flt}").json()["value"]
    if not meetings:
        sys.exit("会議が見つかりません(参加リンクと ORGANIZER_ID を確かめる)")
    meeting_id = meetings[0]["id"]
    transcripts = call(token, "GET", f"{base}/{meeting_id}/transcripts").json()["value"]
    if not transcripts:
        sys.exit("文字起こしがありません(会議で文字起こしを始めたか、会議ポリシーを確かめる)")
    latest = max(transcripts, key=lambda t: t["createdDateTime"])
    url = f"{base}/{meeting_id}/transcripts/{latest['id']}/content"
    r = requests.get(url, headers={"Authorization": "Bearer " + token, "Accept": "text/vtt"}, timeout=60)
    if r.status_code == 403 and "SpeakerAttributionNotAllowed" in r.text:
        print("[注意] 話者属性がオフのため、話者なしの形式で取り直します。担当者は人が入れてください")
        r = call(token, "GET", url, accept="application/vnd.microsoft.graph.transcript+text")
    elif r.status_code >= 400:
        sys.exit(f"{r.status_code} {url}\n{r.text[:500]}")
    return r.content.decode("utf-8")


def parse_vtt(vtt):
    """WebVTT を [{'start', 'speaker', 'text'}] に分ける。同じ人が続けた発言は1つにまとめる。"""
    rows = []
    for block in re.split(r"\n\s*\n", vtt.replace("\r\n", "\n")):
        lines = [line.strip() for line in block.strip().split("\n")]
        idx = next((i for i, line in enumerate(lines) if "-->" in line), None)
        if idx is None:
            continue  # 先頭の WEBVTT など
        start = lines[idx].split("-->")[0].strip()
        body = " ".join(lines[idx + 1:])
        m = re.match(r"<v ([^>]+)>(.*?)(?:</v>)?$", body)
        speaker, text = (m.group(1), m.group(2)) if m else ("(話者なし)", body)
        if rows and rows[-1]["speaker"] == speaker:
            rows[-1]["text"] += " " + text
        else:
            rows.append({"start": start, "speaker": speaker, "text": text})
    if not rows:
        rows.append({"start": "", "speaker": "(話者なし)", "text": vtt})
    return rows


def summarize(rows):
    transcript = "\n".join(f"[{r['start']}] {r['speaker']}: {r['text']}" for r in rows)
    client = anthropic.Anthropic()
    resp = client.messages.create(
        model=MODEL,
        max_tokens=4096,
        messages=[{"role": "user", "content": PROMPT + "\n\n" + transcript}],
        output_config={"format": {"type": "json_schema", "schema": SCHEMA}},
    )
    if resp.stop_reason != "end_turn":
        # 拒否(refusal)や max_tokens で切れたときは、スキーマと合わないことがある
        sys.exit(f"出力が途中で止まりました: {resp.stop_reason}")
    return json.loads(next(b.text for b in resp.content if b.type == "text"))


def to_markdown(minutes):
    md = [f"# {minutes['title']}", "", "## 概要", minutes["summary"], "", "## 決定事項"]
    md += [f"- {d}" for d in minutes["decisions"]]
    md += ["", "## アクション", "| 担当 | タスク | 期日 | 要確認 |", "|---|---|---|---|"]
    for a in minutes["action_items"]:
        md.append(f"| {a['owner']} | {a['task']} | {a['due']} | {'要確認' if a['needs_check'] else ''} |")
    md += ["", "## 未決のこと"] + [f"- {q}" for q in minutes["open_questions"]]
    md += ["", "## リスク"] + [f"- {r}" for r in minutes["risks"]]
    return "\n".join(md)


def draft(join_url):
    token = graph_token()
    rows = parse_vtt(fetch_transcript(token, os.environ["ORGANIZER_ID"], join_url))
    minutes = summarize(rows)
    MINUTES_JSON.write_text(json.dumps(minutes, ensure_ascii=False, indent=2), encoding="utf-8")
    MINUTES_MD.write_text(to_markdown(minutes), encoding="utf-8")
    print(f"[下書き] {MINUTES_JSON.name} と {MINUTES_MD.name}。発言 {len(rows)} 件、タスク {len(minutes['action_items'])} 件")
    print("担当・期日・要確認を直してから apply を実行してください")


def apply():
    minutes = json.loads(MINUTES_JSON.read_text(encoding="utf-8"))
    members = json.loads((ROOT / "members.json").read_text(encoding="utf-8"))
    for a in minutes["action_items"]:
        if a["needs_check"]:
            sys.exit(f"要確認のタスクが残っています: {a['task']}(minutes.json を直してから)")
        if a["owner"] not in members:
            sys.exit(f"members.json に無い担当者です: {a['owner']}")
    token = graph_token()
    for a in minutes["action_items"]:
        task = {
            "planId": os.environ["PLAN_ID"],
            "bucketId": os.environ["BUCKET_ID"],
            "title": a["task"],
            "assignments": {
                members[a["owner"]]: {"@odata.type": "#microsoft.graph.plannerAssignment", "orderHint": " !"}
            },
        }
        if a["due"]:
            task["dueDateTime"] = a["due"] + "T00:00:00Z"  # UTC。日本時間では同じ日の9時
        call(token, "POST", f"{GRAPH}/planner/tasks", body=task)
    MINUTES_MD.write_text(to_markdown(minutes), encoding="utf-8")
    mail = {
        "message": {
            "subject": "議事録: " + minutes["title"],
            "body": {"contentType": "Text", "content": MINUTES_MD.read_text(encoding="utf-8")},
            "toRecipients": [{"emailAddress": {"address": x.strip()}} for x in os.environ["MAIL_TO"].split(",")],
        },
        "saveToSentItems": True,
    }
    call(token, "POST", f"{GRAPH}/users/{os.environ['ORGANIZER_ID']}/sendMail", body=mail)
    print(f"[登録] Planner に {len(minutes['action_items'])} 件、議事録をメールで送りました")


if __name__ == "__main__":
    if len(sys.argv) == 3 and sys.argv[1] == "draft":
        draft(sys.argv[2])
    elif len(sys.argv) == 2 and sys.argv[1] == "apply":
        apply()
    else:
        sys.exit(__doc__)

担当者の対応表は自分で作る小さなファイルで、発言に出る呼び方と Planner に割り当てるユーザー ID を対にします。同じ名字の人がいる会議では「田中(営業)」のように呼び方を分けます。Graph のユーザー一覧から名前で引く作りにもできますが、ユーザーを読む権限がもう1つ要ります。

作例:members.json

{
  "佐藤": "<佐藤さんのユーザー ID>",
  "田中": "<田中さんのユーザー ID>"
}

スクリプトは Claude Code の外で動かす

Claude Code の中でコマンドを実行すると、その出力は会話に入ります。作例のスクリプトが件数しか出さないのはそのためで、draft と apply は自分のターミナルで実行します。minutes.json を Claude Code に読ませて直させても、会議の中身が会話に入ります。会話に入った内容は、Team・Enterprise・API などの商用の契約では、顧客が提供を選んだ場合を除いて学習に使われず、標準の保持は30日です。個人向けの Free・Pro・Max では、改善に使う設定がオンなら学習に使われ、オフなら保持は30日です。Claude Code は手元の ~/.claude/projects/ にも会話の記録を平文で既定30日残します(Claude Code「データの使用」)。個人向けの規約では、設定をオフにしていても、フィードバックとして送った内容と安全の審査の対象になった内容は学習に使われることがあります(Anthropic「Consumer Terms」)。会議の中身を扱うなら商用の契約で、という判断はここから来ます。契約ごとの違いはClaude 利用時のデータ保持・学習オプトアウトに書いています。

スクリプトが呼ぶ Claude API は、Claude Code の契約とは別の、使ったトークンに応じた従量の請求で、単価はモデルごとに料金のページにあります。API の入力と出力は、受け取りか生成から30日以内にバックエンドから自動で削除されます。ただし、利用ポリシーの違反の判定などの例外があります(Anthropic プライバシーセンター)。スクリプトを書かせる Claude Code のほうのプランごとの請求の違いは、同じ連作のClaude Code + Gmail API でメール自動化に書いています。

会議が終わるたびに自動で動かしたいなら、Graph の変更通知で「文字起こしが使えるようになった」ことを受け取る方法があります。購読は、文字起こしが始まる前にしておく必要があります。購読の期限を1時間より先にするなら、lifecycleNotificationUrl が要ります(Microsoft Learn「トランスクリプトと録画の変更通知」)。作例の draft は参加リンクで始めるので、通知から始めるなら会議 ID を受け取る入口を足します。

Planner とメール:人が確かめてから登録する

apply で Planner に送る中身は次の JSON です。planId は、既にあるプランの ID にする必要があります。bucketId を入れるなら、同じプランのバケットにします(作例は議事録のタスクを1つのバケットにまとめるために入れています)。担当者は assignments に、ユーザー ID をキーにして #microsoft.graph.plannerAssignment の型で入れます(Microsoft Learn「Create plannerTask」、「plannerTask リソース」)。

作例:Planner に送るタスク(タイトルと日付は架空)

POST https://graph.microsoft.com/v1.0/planner/tasks
Content-type: application/json

{
  "planId": "<プランの ID>",
  "bucketId": "<議事録用のバケットの ID>",
  "title": "データ移行の対象を洗い出す(第1版)",
  "assignments": {
    "<田中さんのユーザー ID>": {
      "@odata.type": "#microsoft.graph.plannerAssignment",
      "orderHint": " !"
    }
  },
  "dueDateTime": "2026-10-19T00:00:00Z",
  "priority": 5
}

dueDateTime は UTC なので、T00:00:00Z は日本時間でその日の9時です。priority は0〜10で、小さいほど優先度が高くなります。Planner は0〜1を「緊急」、2〜4を「重要」、5〜7を「中」、8〜10を「低」と解釈し、画面で選ぶと1・3・5・9を入れます(plannerTask リソース)。議事録のメールは sendMail で送ります。返る 202 Accepted は受け付けたという意味で、配信が終わったことは示しません(Microsoft Learn「user: sendMail」)。

機密を扱う会議を外す仕組みは、スクリプトの側に要ります。アクセス ポリシーは開催者ごとに付けるもので、同じ開催者の会議のうち1本だけを外すことはできないからです。件名に決めた印がある会議は draft で止める、のように条件を書いておきます。

動かないとき:エラーから引く

作例のスクリプトが止まる所(原因の列は、公式のエラーの説明と、そこから考えられるもの)
症状・エラー考えられる原因だれが何をするか
403 No application access policy found for this appアクセス ポリシーが開催者に付与されていない。付与から30分以内Teams の管理者が Grant-CsApplicationAccessPolicy で開催者に付与し、最大30分待つ
403 GraphAccessToTranscriptsDisabled[トランスクリプト API アクセス]がオフ(既定)Teams の管理者が[会議の設定]でオンに。スクリプトの側では回避できない
403 SpeakerAttributionNotAllowed[話者属性を含める]がオフのまま text/vtt を頼んだ話者なしの形式で取り直す(作例は自動で)。担当者を拾うなら管理者がオンに
文字起こしの一覧が空会議で文字起こしを始めていない。開催者か始めた人の会議ポリシーでオフ開催者が会議で文字起こしを始める。管理者が会議ポリシーを確かめる
会議が見つからない・取れない参加リンクと開催者の ID が合っていない。予定表に無い会議、期限切れの会議開催者のユーザー ID で呼んでいるかを確かめ、予定表から作った会議で試す
権限を足したのに 403管理者の同意が済んでいないことがあるEntra の管理者が[管理者の同意の付与]を済ませたかを確かめる
「出力が途中で止まりました」で止まるClaude の出力が max_tokens で切れたか、拒否された長い会議なら max_tokens を上げるか、文字起こしを分けて渡す
Planner で 400・403・404planId が既にあるプランの ID でない、担当者のユーザー ID が違う、などプランとユーザー ID を確かめる(Microsoft はこの3つを扱うべき主なエラーとして挙げる)

最初にやること:管理者への依頼を1通にまとめる

スクリプトを書かせる前に、管理者への依頼を1通で出します。中身は、Entra のアプリの登録と会議・文字起こしを読む2つの権限への同意と、上の図の Teams の設定です。うち[トランスクリプト API アクセス]と[話者属性を含める]はテナント全体の設定なので、そのことを書き添えて、組織として開けるかを判断してもらいます。Planner とメールの権限は、下書きを何回か人が確かめてから足します。

どの権限を、どの開催者の会議まで、どこで動かすかを決めるところから一緒に進める場合は、当社のClaude Code 導入支援にご相談ください。Microsoft 365 全体の運用はMicrosoft 365 統合運用ガイドにまとめています。

API の権限・設定の名前・既定値は、2026年10月14日に Microsoft Learn・Microsoft サポート・Anthropic の公式ページで確かめたものです。Teams 管理センターの画面の名前は、Microsoft Learn の日本語版の表記に合わせています。

Claude 導入支援

社員が個人のアカウントで使い始めている、Team と Enterprise のどちらにするか決められない、Claude Code や API の利用が全社の決まりとつながっていない。使い方の決まりとプランの選定から、管理者の設定、社内システムとの連携、研修と定着までを支援します。

AT
aurant technologies 編集

上場企業からスタートアップまで、数多くのデータ分析基盤構築・AI導入プロジェクトを主導。単なる技術提供にとどまらず、MA/CRM(Salesforce, Hubspot, kintone, LINE)導入によるマーケティング最適化やバックオフィス業務の自動化など、常に「事業数値(売上・利益)」に直結する改善実績多数。

この記事が役に立ったらシェア: