m365-copilot-companion-mcp

[!IMPORTANT] 既存ユーザーの方へ: 次回リリースの公開後、必ずそのリリースへ更新してください。更新手順と配布物は Releases で案内します。

M365 Copilot を、あなたの PC を操作できる自律エージェントにするツールです。 API 契約は不要。会社アカウントのまま。管理者権限も不要。 ファイルを読むだけだった Copilot に「手」を生やして、実際に作業させます。

English TL;DR — This turns Microsoft 365 Copilot into an autonomous agent that operates your own PC — files, Excel, OCR, Python, local/corporate databases — with no API contract, on your normal work account, without admin rights. A small Python MCP server on your laptop exposes the tools; the relay drives the Copilot web UI unattended. To install: double-click quickstart.bat and follow the prompts. The one manual step (registering the MCP tool in Copilot Studio) is walked through with screenshots below. Full English guide: see the English guide section at the bottom.

---

これは何

• M365 Copilot は中身が賢いのに、チャットに貼った文章を読むくらいしかしてくれません。
• このツールはあなたのノート PC で動く小さなサーバーを Copilot に繋ぎ、ファイル操作・Python 実行・Excel・OCR・社内 DBといった"手"を与えます。
• 追加課金ゼロ。いま持っている M365 Copilot ライセンスの中だけで完結します。

---

できること

• ファイルを読む・書く・整理する・重複を探す
• Excel / CSV / JSON を集計する、Word / PowerPoint / PDF を作る・読む
• OCR で画像・スキャン PDF を文字起こしする
• Python をその場で走らせてグラフを描く
• 社内 SQL(ODBC) を Windows 認証のまま扱う（DB アカウントの権限に従う。読み取り専用にしたいときは MCP_DB_READONLY=1）
• 複数の作業を並列で無人自走させる（フリート）
• チャット UI で手元のアプリのように話しかける
• 自分が作った画像を見返して自己検証する

---

二つの経路(どちらも同じ quickstart.bat と start_all.bat)

Copilot がこの PC のツールを呼ぶ道は二つあります。起動に使う bat は同じです(専用の bat はありません)。違いは設定 tool_transport だけです。

| | コネクタ経路(すでに使っている PC は継続) | コネクタなし経路(新しい PC の既定) | |---|---|---| | 使うもの | Copilot Studio のカスタムコネクタ + Dev Tunnel | どちらも使わない。標準のエージェント + Microsoft 提供のツール | | 向いている場面 | カスタムコネクタを作れる環境で、すでにこの経路で動いている PC | 新しい PC。組織の設定で、自分の MCP のコネクタが作れないとき | | 選び方 | すでに動いている PC は更新しても変わらない。新たに選ぶときはコックピットで切り替え | 何も選ばなければこの経路(質問が出る PC では L を押す)。あとからは、コックピットの「設定 → ツール → ツール経路」で切り替え(次の会話から有効、再起動不要) | | 起動 | start_all.bat | 同じ start_all.bat(トンネルの確認と起動は自動で省かれる) | | 確認 | doctor.bat | doctor.bat(トンネル検査の代わりに「Tool route: connector-less」と1行出る) | | 手順 | 下の「セットアップ」 | docs/connector_less_route.md(仕組みと設定)・docs/custom_mcp_fallback_route.md(画面つき手順) |

すでにコネクタ経路で使っている人: 専用の移行ツールはありません。旧エージェントとコネクタはそのまま残し(戻り先)、コネクタなしの新しい標準エージェントを作って URL を差し替え、設定「ツール経路」を切り替えるだけです。スキル・フリート・記憶・設定は引き継がれます。手順は docs/connector_less_route.md の「Moving an install that already uses the connector route」です。

既存のフリート・スキル・ツールはどちらの経路でも同じ使い方です(短い作業・長い作業・DB の読み取り・メールと予定・複数並列のフリートで確認済み。ほかの環境・組織設定では小さな作業で先に試してください)。コネクタなし経路ではメールや予定は Microsoft 提供の Work IQ ツールで取得します。注意: 鍵なしで公開したツールはリンクを知っている全員が使えます。各自が自分の環境を作り、他人のツールやエージェントのリンクは使わないでください。

---

必要なもの

1. Windows 10 / 11
2. M365 Copilot ライセンス（職場アカウント）
3. Copilot Studio を開けること（https://copilotstudio.microsoft.com）

---

セットアップ

1. 入手する

git を使うなら:

git clone https://github.com/MasayukiTa/m365-copilot-companion-mcp.git

git を使わないなら: GitHub ページの緑色の「Code」ボタン →「Download ZIP」→ ダウンロードした zip を右クリック →「すべて展開」。

2. quickstart.bat をダブルクリックする

展開したフォルダ直下の quickstart.bat をダブルクリックします。あとは画面の指示に従うだけです。

英語の質問が出たらそのまま Enter を押せば安全な既定が選ばれます。 迷ったら Enter で問題ありません。

3. 画面の指示に従う

quickstart.bat は 7 ステップを順にガイドします。手作業は STEP 5 の Copilot Studio だけで、あとはクリックとコピペです。

| STEP | 何が起きる | あなたがやること | |---|---|---| | 1 | Python 環境を自動構築（管理者不要） | 待つ | | 2 | Bearer トークン / アンロックパスワードを表示（.env 自動生成） | メモする | | 3 | git 更新確認（ZIP 配布なら自動スキップ） | 待つ | | 4 | devtunnel を導入・サインイン・作成し、公開 URL を表示 | サインインをポチポチ | | 5 | 一時停止 → Copilot Studio で MCP を登録（唯一の手作業） | 下の walkthrough 参照 | | 6 | エージェント URL ダイアログが自動で開く | URL をコピペ | | 7 | スタック全部を起動（サーバー＋トンネル＋Edge＋UI） | 待つ |

全部 1 つの黒い窓＋ダイアログ＋サインイン画面で完結します。別 PC・別ターミナルは要りません。

初回起動時のみ、チャット窓とコックピット窓をソースから自動コンパイルします（約 30 秒・.NET Framework 4.8 が必要ですが、Windows 10/11 標準搭載なので通常は何もインストール不要）。csc.exe not found と出た場合は docs/TROUBLESHOOTING.md を参照。

※ STEP 5 の手作業が既に済んでいる（.env にエージェント URL がある）状態で再実行すると、quickstart.bat は「S を押せば STEP 7（起動）まで飛ばせます」と聞いてきます。やり直したいときだけ R を押してください。

途中で止めてしまったら（再開）

• quickstart.bat はいつ何度実行しても安全です。中断（サインイン失敗・窓を閉じた・再起動）しても続きから再開します。
• 完了済みのステップは自動でスキップされます（Python 構築などは一瞬で通過）。やり直しにはなりません。
• STEP 5（Copilot Studio）まで済んでいれば再実行時に S を押すだけで STEP 7 の起動まで一気に飛べます。
• 何かおかしくなったらまず doctor.bat をダブルクリック。全リンクを緑/赤で診断し、赤い行にその場で直し方を出します。

---

STEP 5 の手作業 — Copilot Studio に MCP を登録する

これが唯一の手作業です。実際の画面つきで順に進みます。アクセス先は https://copilotstudio.microsoft.com。

1. ホームの「ゼロから構築を開始する」→「エージェント」タイルをクリック

2. エージェントに名前を入力 →「作成」

名前（例: companion）を入力し「作成」をクリックします。

3. 編集画面の「ツール」セクション →「+ ツールを追加する」

4. 「ツールを追加する」ダイアログで「新規追加 MCP」タイルを選ぶ

見当たらなければダイアログ下部の「表示を増やす」を押すと出ます。

<details> <summary>UI バージョンが違う場合（「新しいツール」6タイル画面）</summary>

お使いの UI のバージョンによっては代わりに「新しいツール」画面（プロンプト / エージェント フロー / コンピューターの使用 / モデル コンテキスト プロトコル / カスタム コネクタ / REST API の6タイル）が出ることがあります。その場合はタイル名が「モデル コンテキスト プロトコル」になっているので、それを選んでください。

</details>

5. サーバー情報ダイアログに値を入力する

💡 この値は手で組み立てなくて OK。copilot_studio_values.bat をダブルクリックするとあなたの .env ＋ Dev Tunnel から実際の値をそのまま表示します（quickstart の STEP 5 でも自動表示）。コピペするだけです。

| 項目 | 入力値 | |---|---| | サーバー名 | 任意（例: companion） | | サーバーの記述 | 任意（空でも可） | | サーバー URL | https://<your-tunnel>-8000.<region>.devtunnels.ms/mcp （= MCP_TUNNEL_URL + /mcp） | | 認証 | 「API キー」を選ぶ | | タイプ | 「ヘッダー」を選ぶ（「クエリ」ではない） | | ヘッダー名 | Authorization | | API キーの値 | Bearer <MCP_API_KEY の値> （STEP 2 で表示された値） |

⚠️ 「API キーの値」欄には Bearer という単語と半角スペースを含めて丸ごと貼ってください（例: Bearer 4baf1c2e...）。ラベルが「API キー」なので生のキーだけを貼りがちですが、それだと 401 になります。copilot_studio_values.bat の出力はこの Bearer 込みの行なのでその行をそのまま貼れば確実です。

6. 「作成」をクリック — 接続がテストされ、ツール一覧がロードされれば成功です。

7. エージェントの「指示」を編集し、LOCAL_LOOP指示を末尾へ追記

既存の指示は消さず、docs/examples/local_loop_agent_instructions.txt の全文を末尾へ貼り、「保存」を押します。これはMCP_EXECUTION_PROFILES=1で使う /deep-review・/deep-security-reviewとSQLite実行に必須です。通常チャットの指示とは RUN <job_id> ...形式で明確に分離されるため、通常利用の応答は変えません。

8. 「公開」→「利用者を自分だけ」に設定 — 必ず自分のみ。組織全体は絶対に選ばないでください。

うまくいった目安: ツール登録画面に list_my_tools, read_file などのツール名がずらっと表示されます。

登録が終わったらエージェントとチャットを開き、URL バーの URL を STEP 6 のダイアログに貼ります。

✅ 全部つながったか不安なら doctor.bat をダブルクリック。 サーバ→Dev Tunnel→専用 Edge→M365 サインイン→Bearer 認証まで全リンクを緑/赤でチェックし、赤にはその場で直し方を表示します。

---

毎日の使い方

Skills（再利用できる仕事のやり方）

• /skills で Claude非依存の個人共通 ~/skills/・プロジェクト固有 skills/ と Claude互換の ~/.claude/skills/・.claude/skills/ を一覧表示します。

• /<skill-name> 引数 で承認済み Skill を明示実行できます。信頼度の高い一致だけは通常文から自動選択されます。

• 自動選択が見るのは SKILL.md の name・description・when_to_use・keywords だけです（本文は読みません）。keywords: は任意で、利用者が実際に打つ別の言い方を並べる YAML のリストです（例: keywords: [expense claim, reimbursement, けいひせいさん]）。英語での依頼や、かな書き・略語での依頼を日本語の Skill に届かせる手段はこれです。最大32件・1件100文字・合計1024文字、文字列以外や keywords: a, b のような1本の文字列は不正として skill_list に理由付きで表示されます。単語1つの一致だけでは選ばれません。

• 自作はローカル端末で /skill-create <name> | <description> | <instructions>。作成時の内容だけが自動で信頼されます。

• 外部Skillは /skill-import <path> で実行せず取り込み、/skill-approve <name> で内容・差分・スクリプトを確認します。承認待ちはフリート停止中でも FleetCockpit 上部の「承認」から開け、承認後もそのハッシュにしか効きません。

• Skill承認は手順書の読込み許可だけです。shell、ファイル変更、外部送信は従来どおり unlock とフリートの GO / ASK / STOP・逐次承認に従います。

• 上部の run / plan / auto は「実行方式」です。実際の操作許可は件数バッジ付きの「承認センター」に集約され、削除・外部送信・破壊的shellは対象確認後にもう一度確認します。一括承認はありません。

• 起動: デスクトップの「M365 Companion」アイコンをダブルクリックするだけ（quickstart が初回に作成）。サーバー・トンネル・Edge・UI を一括起動します。何度押しても安全です（冪等）。

• 2 つの窓:

  • CopilotChat — 話しかける窓。手元のアプリのように Copilot と会話します。
  • FleetCockpit — 実行を見る窓。並列で走らせた作業をライブで監視・操作します。

• 書込・実行を初めて頼むと unlock(password=...) を求められます。STEP 2 でメモしたアンロックパスワードをエージェントに 1 度伝えれば、その端末は 30 日間解錠されます。

• 健康診断: 調子が悪いと感じたら doctor.bat をダブルクリック。全リンクを緑/赤でチェックします。

---

困ったとき

まず doctor.bat をダブルクリックしてください。赤い行がそのまま直し方です。それでも解決しない場合は下の FAQ と docs/TROUBLESHOOTING.md を見てください。

Q. Copilot が「申し訳ございません。それに応答できませんでした。」と返す A. エージェントの故障ではなく、MCP サーバーか Dev Tunnel が落ちている合図です。doctor.bat を実行すれば復旧手順が出ます。supervisor が動いていれば数十秒で自動復活します。

Q. devtunnel のサインインが何度やっても通らない A. supervisor が動いていたら一度止め、新しいターミナルで devtunnel login を実行し、ブラウザの「続行」を確実にクリックしてください。

Q. Copilot Studio でツール一覧が出ない A. Dev Tunnel の公開 URL が生成・host されているか確認してください（doctor.bat が判定します）。トンネルが落ちているとツールが読めません。

Q. エージェントがツールを呼んでくれない A. Copilot Studio でエージェントに MCP コネクタの「接続を承認」が済んでいるか確認してください。認証（Bearer）が通っていないと呼び出せません。「API キーの値」に Bearer を付け忘れていないかも確認を。

Q. 組織の設定で自分の MCP のコネクタ(接続)が作れない A. コネクタもトンネルも使わない別の経路があります。標準のエージェントに Microsoft 提供のツールだけを付け、ツールの呼び出しはこの PC が受け持ちます。手順は docs/custom_mcp_fallback_route.md、仕組みと設定は docs/connector_less_route.md です。注意: 鍵なしで公開したツールはリンクを知っている全員が使えます。各自が自分の環境(自分のエージェントと自分の PC)を作り、他人のツールやエージェントのリンクは使わないでください。

Q. 途中で失敗した。やり直して大丈夫？ A. quickstart.bat も start_all.bat も冪等です。いつ何度実行しても安全で、足りないものだけ補います。既に動いているトンネルは止めません。

---

しくみ

[ M365 Copilot ] ──▶ [ Copilot Studio エージェント ] ──▶ [ devtunnel ]
                                                              ↓
                            [ MCP サーバー on あなたの PC ]
                                                              ↓
                          ファイル · Python · DB · Office生成 · OCR …

• あなたの PC で小さな Python サーバー（MCP サーバー）が動き、ファイルや Python 実行などの「手」を提供します。
• devtunnel が localhost のサーバーを安全な URL で公開し、Copilot Studio のエージェントがそこに繋ぎます。
• 別系統で relay / fleet が Edge 上の Copilot Web UI を裏で駆動し、作業を無人で自走させます（あなたのマウス・キーボードは奪いません）。
• クラウド側（メール・予定表・SharePoint）は Copilot Studio の純正コネクタに任せ、ローカル PC 側をこの companion が担当する二枚重ねが本来の形です。

詳しい内部構造は docs/ARCHITECTURE.md。

---

性能

自律エージェントとして公式ベンチで実測した値です（詳細・再現手順は docs/ADVANCED.md）。

| ベンチ | 結果 | 備考 | |---|---|---| | HumanEval（164 問） | first-pass 98.2%（161/164）/ 最終 100% | ground-truth 採点（隠しテスト再実行） | | SWE-bench Lite（300 件） | 71.7%（215/300） | 公式採点フル完走・grader 非リーク | | SWE-bench Verified（200 件） | 76.5%（153/200） | 別セットでの汎化確認（非 burned） | | GAIA（text-only 127 問） | 70.1%（89/127） | GAIA 公式スコアラ・既定 Copilot が回答 |

頭脳は M365 Copilot 内の Opus 4.8。数値は「頭脳が上」ではなく「スキャフォールドが効いている」ことを示します。スコアカードは bench/ 配下（例: bench/SCORECARD_swebench_lite300_strong.md）。

CompanionBench（自前ベンチ・上表とは別カテゴリ）

上の4つは第三者の公式ベンチです。CompanionBench はこの製品の用途そのもの（ファイル操作・Excel・CSV/JSON・OCR・SQL・長時間ジョブ・認証/consent・ルーティング・セキュリティ・ステアリング）を測るために自分で作ったもので、同じ表には並べません。自作ベンチのスコアは作った側が有利になる方向にいくらでも動かせるためです。

そこで点数ではなく再現性を先に報告します。同一系を3回測った結果:

| 指標 | 実測 | 基準 | |---|---|---| | 判定が3回とも一致したエピソード | 18 / 22 | 18 | | pass 数のばらつき | 0.091 | ≤ 0.10 |

基準を満たした、というだけの意味です。 真に50/50のエピソードは3試行の25%で「安定」に見えるので、これは「余裕を持って上回っている」の証拠ではありません。前回の測定は 15/16/17、今回が 18/20/18 で、方向は一貫していますが片側3点では実証になりません。

生データ・測定条件・撤回した主張・未解明のまま残っている点は bench/companionbench/results/README.md にあります。過去に撤回した数値（capability 0.917）とその理由も同じ場所に残してあります。

---

セキュリティ

• Bearer 認証 — 固定 API キー（MCP_API_KEY）が無いと 401。当てずっぽうの bot は弾かれます。
• unlock パスワード + session-first 第二要素 — 書込・実行系ツールは解錠が必要（既定 TTL 30 日）。unlock() が成功すると同じ MCP session が認可され、同時にフォールバック用の unlock_token を1度だけ返します。MCP_REQUIRE_UNLOCK_TOKEN は既定で ON、MCP_UNLOCK_SESSION_AUTH も既定で ON なので通常の MCP 会話ではモデルが token を記憶して毎回再添付する必要はありませ