Work IQ の API・MCP を開発者が使う｜社内アプリから Copilot と同じ文脈を使うときの課金と権限
Work IQ API（A2A・REST・MCP・CLI）は、社内のアプリや AI ツールから Copilot と同じメール・会議・ファイルの文脈を使う入口です。費用は Microsoft 365 Copilot のライセンスに含まれず Copilot クレジットで払うこと、管理者がする有効化・支出ポリシー・アクセス許可への同意、書き込みを止めるポリシーまでを、公式の説明に沿って整理します。
目次 クリックで開く
この記事の要点
- Work IQ API は、Copilot が答えに使うメール・会議・ファイル・チャット・人の文脈を、自社のアプリや AI エージェント、開発者の AI ツールから使うための API です。入口は4つ（エージェント同士の A2A、一般的な REST、AI ツールが道具を呼ぶ MCP のリモートと、PC に入れる CLI）で、2026年6月16日に一般提供になりました。
- 費用は Microsoft 365 Copilot のライセンスに含まれず、呼んだ分の Copilot クレジットで払います。ライセンスを持つ人が自作のアプリから呼んでも同じです。操作の道具（Tools）は1回 0.1 クレジットで、質問と答えの材料（Chat・Context）は1タスクの重さで変わります。
- 管理者の作業は4つです。テナントで Work IQ を有効にし、Work IQ API を含む支出ポリシーに使う人を入れ、アプリのアクセス許可に同意し、MCP のポリシーを確かめます。呼び出しはサインインした本人の権限の範囲で動き、MCP の書き込みの操作は、既定ではポリシーで止まります。
たとえば、社内の開発者から「GitHub Copilot CLI に Work IQ の MCP サーバーをつないで、会議やメールで決まった要件を読ませたい」と相談されたとします。会社では Microsoft 365 Copilot のライセンスを買ってあります。この場合に追加の費用はかかるのか、何を許可すると何が読まれ、何ができるようになるのかは、許可する前に知っておきたいところです。
答えを先に書きます。Work IQ API の費用は Microsoft 365 Copilot のライセンスには含まれず、呼んだ分を Copilot クレジットで払います。動かす前に、管理者がテナントでの有効化、課金の設定、アクセス許可への同意、MCP のポリシーの確認をします。呼び出しは開発者本人の権限の範囲で動きます。読み終えると、開発者に試させる前に、管理者が何を決めて何を許可すればよいかが分かります。
当社は Microsoft 365 と生成 AI の導入を支援していて、生成 AI を社内のデータにつなぐ仕組みのセキュリティの点検もしています。ライセンスは販売していません。
Work IQ API とは：Copilot が答えに使う文脈を、Copilot の外から使う入口
Work IQ は、メール・予定・会議・チャット・ファイル・人のつながりから、Copilot が答えに使う仕事の文脈を組み立てる仕組みです。Microsoft は「ワークプレイス インテリジェンス レイヤー」と呼んでいます（Work IQ の概要）。Copilot のチャットで Work IQ をオンにしたときに何が読まれるかは、Work IQ とはの記事に書きました。
Work IQ API は、その文脈を Copilot の画面の外で使うための API です。自社のアプリ、自社で作った AI エージェント、開発者の AI ツールから呼べます。Microsoft は2026年6月2日に発表し、2026年6月16日に一般提供を始めました（Microsoft Copilot ブログ「Announcing the new Work IQ APIs」、Microsoft Work IQ CLIのページ）。同じ発表は、Work IQ API を次の4つの領域に分けて説明しています。
- Chat：Copilot が利用者に返すのと同じ答えを、出典つきで返します。
- Context：Copilot が答えに使う材料を、答えにまとめずに、エージェントが使いやすい形で返します。
- Tools：メールの送信、会議の予定の作成、文書のアップロードなどの操作をします。
- Workspaces：エージェントが作業の途中のデータや出力を置く場所です。テナントの中に置かれます。
読める範囲は、メール、会議と予定、OneDrive と SharePoint の文書、Teams のメッセージ、人と組織の情報、Planner の計画、組織内の検索の結果です（Microsoft Work IQ API）。同じページで Microsoft は、Microsoft 365 のデータを使う新しいアプリやエージェントは Work IQ API の上に作るよう勧めています。Work IQ の概要のページによると、Dynamics 365 と Power Platform の業務データも含まれます。
入口は4つ：例の相談は MCP を使う
Work IQ API には、呼ぶ側に合わせて4つの入口があります。A2A はエージェント同士が仕事を頼み合うための決まりです。REST は、決まった URL に要求を送って答えを受け取る、一般的な API の形です。MCP（Model Context Protocol）は、AI のチャットや開発ツールが外の道具を呼ぶための決まりで、サーバーをインターネットの先に置くリモートと、自分の PC で動かすローカルがあります。
例の相談は MCP の入口です。リモートの MCP サーバーのアドレスは https://workiq.svc.cloud.microsoft/mcp で、GitHub Copilot CLI をここにつなぐ手順が Microsoft Learn にあります（GitHub Copilot CLI を Work IQ MCP サーバーに接続する）。もう1つの方法として、Work IQ CLI（コマンドで動かすツール）を開発者の PC に入れ、ローカルの MCP サーバーとして VS Code などから呼ぶこともできます。CLI を使うには、Node.js と、初めて使う前の使用許諾契約への同意が要ります（Microsoft Work IQ CLI）。
MCP サーバーの道具は少数に絞られています。Work IQ の概要のページは「10 個の汎用ツール」と書き、MCP の概要のページの表には、次に挙げる道具を含めて12個の名前が並んでいます。道具は、/me/messages のような読み書きする先の「パス」と組み合わせて動きます。fetch は読む道具、create_entity は作る道具、do_action はメールの送信などの操作をする道具です（Work IQ MCP の概要）。ask は Copilot に質問する道具で、retrieve は答えの材料と出典の情報を受け取る道具です。retrieve はパブリック プレビューです。
一度に読む件数には上限があります。一覧を読む fetch は、件数を指定しないと最大25件を返し、上限は100件です。この件数には、テナントのポリシーの制限も掛かります（Work IQ MCP ツール リファレンス）。SharePoint の一覧の更新や承認の操作などを扱う SharePoint Tools もあり、パブリック プレビューです（SharePoint Tools for Work IQ）。
REST の入口は、Copilot と同じ形の答えを返しますが、答えは文字だけです。ファイルの作成、メールの送信、会議の予定は扱いません（Work IQ REST API の概要）。2026年11月6日に確かめた移行のページには、Work IQ の道具を2026年11月に REST でも使えるようにする予定と書かれていました（エージェント取得ワークフローを Work IQ MCP に移行する）。
費用：ライセンスに含まれず、呼んだ分を Copilot クレジットで払う
Work IQ API の利用は Microsoft 365 Copilot のライセンスとは無関係で、使った量で払う使用量ベースの課金です（Work IQ の概要）。Work IQ API のためのサブスクリプションや、1人ごとのライセンスはありません（Microsoft Licensing「Work IQ GA」）。
例の相談で誤解しやすいのは、「ライセンスを持つ開発者が呼ぶなら、追加の費用は無いはず」という読み方です。Microsoft Copilot Credits Guide（2026年11月版）は、Work IQ API は Copilot のライセンスの権利に含まれない、と書いています（Microsoft Copilot Credits Guide（PDF））。Microsoft 365 Copilot のライセンスは、Work IQ API のクレジットの残高を補充もしません（Microsoft 365 Copilot の拡張性のライセンスとコストを計画する）。ライセンスを持つ開発者が MCP から呼んでも、呼んだ分はクレジットで請求されます。
一方で、Copilot のチャット、Word などの中の Copilot、リサーチツールのような Microsoft 製のエージェントは、Work IQ の上に作られていて、Work IQ API を通しません。このため、ライセンスを持つ人がこれらを使う分には、Work IQ の分の追加の費用はかかりません。費用がかかるのは、自社でアプリやエージェントを作って Work IQ API を呼ぶときと、他社のエージェントが Work IQ API を通じて自社の Microsoft 365 のデータを読むときです。
クレジットの数え方は2つに分かれます。Tools の操作は1回 0.1 クレジットの固定です。Chat と Context は、使うモデル・実行の仕組み（ランタイム）・文脈・道具で変わります。Guide は1タスクあたりの見積もりとして、軽い例で15〜30、中くらいの例で30〜60、重い例で60〜100 クレジットを挙げています。これは例示で、問い合わせの複雑さで変わる、と Guide は断っています。
従量で払う場合、Guide の価格は1クレジット 0.01 米ドルです（税込みか税抜きかは、Guide では確かめられませんでした）。この単価で計算すると、Tools を1,000回呼ぶと 0.1 × 1,000 × 0.01 = 1 米ドルです。軽い例の1タスクは、15〜30 × 0.01 = 0.15〜0.30 米ドルです。円での単価と、前払いのパックや事前購入プランでの払い方は、Copilot の従量課金（Copilot クレジット）の記事にまとめています。
もう1つ知っておきたいのは、クレジットの残高がテナントで共有されることです。Work IQ API は、Copilot Cowork（仕事をまとめて任せる Copilot の機能）や Copilot Studio のエージェントと同じ残高からクレジットを使います（拡張性のライセンスとコストのページ）。支出ポリシーは上限を決めるもので、クレジットを取り置く設定ではありません。残高か上限が尽きると、Work IQ のチャットの要求が QuotaExhausted という誤りで失敗することがあり、「No AI credits are currently available for this user. Please request more credits from your admin.」と返ります。再試行しても直りません。
動かす前に管理者がすること：有効化・課金・同意・ポリシー
例の相談を受けたあと、開発者が呼べるようになるまでに、管理者の作業が4つあります。冒頭の図の1〜4です。
1. テナントで Work IQ を有効にする
Work IQ のサービス プリンシパル（テナントの中で Work IQ を表す登録）を作ります。グローバル管理者が組織で1回行う作業で、Learn の目安は約5分です（Work IQ のテナントを有効にする）。作り方は、Graph エクスプローラーか Azure CLI の2通りが載っています。MCP の概要のページは、初めて Work IQ を使うときにサービス プリンシパルが自動で作られる、とも書いています。ただし、MCP を使う前に管理センターでポリシーを設定しようとすると、まだ作られていなくて失敗することがあります。その場合は、この手順で先に作ります。
2. 課金を設定し、使う人を支出ポリシーに入れる
前提は、Copilot Studio で設定した使用量ベースの課金のプラン（Azure のサブスクリプションとリソース グループを割り当てたもの）と、そのプランに割り当てた利用者です（テナントを有効にするページ）。そのうえで、Microsoft 365 管理センターの［Copilot］>［コスト管理］で、使う人を Work IQ API を含む支出ポリシーに入れます（移行のページの準備の手順）。支出ポリシーには「新しいサービスの自動適用」という設定があり、既定でオンです（使用量ベースの請求によって有効化された AI エクスペリエンスの管理）。オンのポリシーには、対応するサービスが増えると自動で足されます。このため、Work IQ API がどの支出ポリシーに入っているかを先に見ておくことをお勧めします。支出ポリシーの作り方と上限の効き方は、Copilot の従量課金の記事に書いています。
なお、Microsoft 365 Copilot のライセンスや、前からある Retrieval API の従量課金を設定してあっても、Work IQ API の支出ポリシーは自動では作られません。
3. アプリのアクセス許可に、管理者が同意する
Work IQ API を呼ぶアプリは、Microsoft Entra ID（Microsoft 365 のサインインと権限の仕組み）に登録し、OAuth（アプリに権限を渡すための標準の仕組み）で Work IQ のアクセス許可を求めます。アクセス許可は次の3つで、どれも「管理者の同意が必要」です（Work IQ API のアクセス許可リファレンス、2026年10月30日更新）。
| アクセス許可 | 表示名（Learn 日本語版） | できること |
|---|---|---|
WorkIQAgent.Ask | ユーザーに代わって Work IQ エージェントに質問する | Work IQ のエージェントに質問して答えを受け取る。エージェントが届き、サインインした人を対象とする範囲の読み取りと書き込みを含む |
WorkIQ.Read | WorkIQ を使用して Microsoft 365 データを読み取ります | サインインした人が見られるデータを読む |
WorkIQ.Act | WorkIQ を使用して Microsoft 365 データを操作する | サインインした人が見られるデータを読み、変更する |
管理者の同意は、管理者が組織の利用者に代わって、そのアプリにアクセス許可を与えることです（ユーザーと管理者の同意の概要）。例の相談の CLI の場合も、Entra のテナントで Work IQ のアプリに管理者が同意していることが前提です（Microsoft Work IQ CLI）。開発者が管理者でなければ、同意を管理者に頼むことになります。
入口によって前提が違うことにも注意が要ります。Microsoft Foundry（Azure の AI 開発の基盤）から Work IQ につなぐクイックスタートは、エージェントを通じて呼ぶ人ごとに Microsoft 365 Copilot のライセンスを前提に挙げています（Microsoft Foundry プロジェクトを Work IQ に接続する）。Foundry から使うときは、このページの前提も確かめます。
4. MCP のポリシーで、書き込みが止まっているかを確かめる
管理センターの［エージェント］>［ツール］で［Work IQ MCP］を選び、［ポリシー］タブ（表示される場合）で、テナントのポリシーのオンとオフを切り替えます（Work IQ MCP のポリシー ガバナンス）。最初のリリースでは、ポリシーはテナント全体に効き、人ごと・アプリごと・エージェントごとには分けられません。作成・更新・削除と、メールの送信のようにデータを変える操作は、既定では許可されません。変更の反映には最大24時間かかります。
Copilot Studio のエージェントで Work IQ を使うページには、エージェントの設定として書き込みの操作は既定でオンで、組織の権限とポリシーは適用される、とあります（Microsoft Copilot Studio での Work IQ）。エージェントの設定と、テナントのポリシーは別の場所の設定です。2つがどう重なるか（たとえばポリシーをオフにしたときに書き込みが通るか）は、読んだ範囲では確かめられませんでした。書き込みを止めておきたい場合は、［ポリシー］タブで今の状態を見ることをお勧めします。
権限：開発者本人が見られる範囲で動き、アプリだけでは動かない
Work IQ API は、サインインした本人として動く「委任」の認証だけを使います。アプリだけの認証は使えません（Microsoft Work IQ API）。例の相談でいえば、開発者が CLI から読めるのは、その開発者本人が開けるメールや会議やファイルだけです。だれもサインインしていない夜間の集計のような処理には向きません。Microsoft 365 Copilot API の概要のページは、Copilot の API とデータを取る Microsoft Graph の API を分けて説明しています。このページは Work IQ API には触れていませんが、当社は同じ分け方で、サインインした人のいない処理は Graph の API でできるかをまず検討すると考えます。
呼び出しは、4つの層で確かめられます（ポリシー ガバナンスのページ）。Entra の認証、アプリのアクセス許可、本人の Microsoft 365 の権限、Work IQ のポリシーです。ポリシーが許可しても、本人にそのファイルの権限が無ければ失敗します。逆に、ポリシーで、本人が見られる範囲より広くなることはありません。
アクセス許可を選ぶときに見落としやすいのは、WorkIQAgent.Ask の説明です。説明には、Work IQ のエージェントが届き、サインインした人を対象とする範囲の読み取りと書き込みを含む、とあります（アクセス許可リファレンス）。質問するだけのつもりで同意しても、説明の上では書き込みも範囲に入ります。また、SharePoint Tools のパスは WorkIQAgent.Ask だけでは見えず、WorkIQ.Read か WorkIQ.Act が要ります。書き込みを止めるのは、アクセス許可ではなく、前の節の4のポリシーの役目です。
当社が AI と社内のデータの接続を点検するときの見方（AI 認証・データ連携のセキュリティ設計の記事）で、例の相談を見直します。この見方では、見られて困るデータに届くこと、信頼できない外の文章を読むこと、外へ出せることの3つが1つの流れでそろうと、実害になります。Work IQ の MCP をつないだ GitHub Copilot CLI は、開発者本人の権限でメールやファイルに届き、社外から届いたメールも読みます。ここで Work IQ のポリシーが書き込みを許すと、メールの送信（do_action /me/sendMail）で外へ出せるようになります。つないだ AI ツールの側に、Web への送信など外へ出す道具があれば、それも同じ働きをします。このため、試す段階では Work IQ の書き込みをポリシーで止めたままにし、AI ツールの側でつなぐ道具も絞ることをお勧めします。
名前の似たもの：Microsoft 365 Copilot API と、Copilot Studio の Work IQ
Work IQ API の前から、Microsoft Graph の /copilot の下に Microsoft 365 Copilot API があります（Microsoft 365 Copilot API の概要）。Retrieval API や Chat API（プレビュー）などです。こちらは、Microsoft 365 Copilot のライセンスのある人は追加の費用なしで使えます。Chat API は、ライセンスの無い人には今のところ使えません（Microsoft 365 Copilot Chat API の概要）。Retrieval API には、ライセンスの無い人向けの従量課金（プレビュー）があり、1回 0.10 米ドルで、テナントに少なくとも1つの Microsoft 365 Copilot のライセンスが要ります（Microsoft 365 Copilot 取得 API 従量課金制）。
2つは中身が近く見えます。Work IQ の REST の説明は Chat API の説明とほぼ同じ文で書かれています。MCP の retrieve は Retrieval API を発展させたもの、と Microsoft 365 の開発者向けブログは書いています（Work IQ: the new retrieve tool、2026年10月20日）。それでも、読んだ範囲では、Microsoft は Work IQ API を名前の付け替えとは書いておらず、両方が並んで提供されています。Guide は、Retrieval API や Chat API などの古い API のライセンスは変えず、この扱いは当面続く、と書いています。
例の相談のような新しい使い方なら、Microsoft の勧めは Work IQ API です。すでに Retrieval API を使っている社内のアプリがあるなら、移行のページが、両方を並べて動かして比べてから切り替える手順を書いています。切り替えると、費用はライセンスか Retrieval API の従量課金から、Copilot クレジットに移ります。
Copilot Studio にも Work IQ があります。Copilot Studio のエージェントの道具としての Work IQ は一般提供で、GitHub Copilot のハーネス（エージェントを動かす仕組み）の上で動き、Copilot クレジットを使います（Microsoft Copilot Studio での Work IQ）。同じページは、道具の一覧に並ぶメールや Teams などの個別の道具は旧来のもので、Work IQ はその新しい呼び名ではない、と書いています。Copilot Studio のクレジットの決まり方は、Copilot Studio の料金とクレジットの記事に任せます。
開発者に試させる前に、管理者が決めること
例の相談に「どうぞ」と答える前に、冒頭の図の2〜4の作業で、当社は次の4つを決めることをお勧めします。
- だれに試させるか（2の課金）：試す人だけのセキュリティ グループを作り、そのグループの支出ポリシーに Work IQ API を入れます。1つのポリシーから外しても、ほかのポリシーからは外れません。既定のポリシーを含めて、ほかのポリシーに Work IQ API が入っていないかを見ます（拡張性のライセンスとコストのページ）。
- いくらまで使わせるか（2の課金）：支出ポリシーの月の上限と、1人ごとの上限を置きます。同じ人が同じサービスで複数のポリシーに入っていると、1人ごとの上限がいちばん高いポリシーが効きます。Chat・Context の消費は問い合わせで変わるので、小さな上限で始めて、［コスト管理］で消費を見ながら広げます。
- どのアクセス許可に同意するか（3の同意）：アプリの登録ごとに、求めているアクセス許可を見てから同意します。データを変える操作が要らないなら、WorkIQ.Act には同意しません。
- 書き込みを許すか（4のポリシー）：［エージェント］>［ツール］の［Work IQ MCP］で、書き込みが止まっているかを見ます。変えたら、反映に最大24時間かかります。
試す範囲の決め方や、社内のデータを AI につなぐときの点検から一緒に進めたい場合は、Microsoft 365 の導入支援でご相談を受けています。
この記事の確かめ方
2026年11月6日に、Microsoft の公式ドキュメント Microsoft Learn（日本語版と英語版）の Work IQ API のページ、Microsoft Copilot ブログの発表（2026年6月2日）、Microsoft Licensing のお知らせ、Microsoft Copilot Credits Guide（2026年11月版）、Microsoft 365 の開発者向けブログ（2026年10月20日）で確かめました。当社は Work IQ API を呼んでいないため、同意の画面や、実際のクレジットの消費は見ていません。Work IQ API のページは2026年10〜11月にも更新が続いているので、設定の前に最新を確かめてください。
確かめられなかったことは次のとおりです。MCP の概要のページは、アクセス許可を「4つの広いアクセス許可」と書いていますが、アクセス許可リファレンスに載っているのは3つでした。Chat・Context の1回あたりの固定の単価は、公式のページでは見つかりませんでした。Workspaces を自社のアプリから使う手順のページも、読んだ範囲では見つかりませんでした。
Microsoft Learn の「Microsoft Copilot の要件」のページには、Microsoft 365 Copilot の名前が Microsoft Copilot に変わったとあります。Work IQ API のページの多くは Microsoft 365 Copilot の名前のままなので、この記事ではライセンスを Microsoft 365 Copilot、画面の中の機能を Copilot と書いています。
執筆・監修
Aurant Technologies CAIO（Chief AI Officer）
Microsoft 365 と生成 AI の導入を支援する立場から、社内のデータを AI につなぐ前に管理者が決めることをまとめています。
Microsoft 365 Copilot 導入支援
無料の Copilot Chat がもう社員の画面に出ている、有料版を誰に何人配るか決められない、全社に開いたままの SharePoint のサイトがある。配る前の共有の見直しから、ライセンスの選び分け、ライセンスの外でかかる費用の上限、使われているかの確認までを支援します。
