MOCOをMicrosoft Copilotに接続（MCP）

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → MOCO をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

MOCO + Microsoft Copilot

AI に MOCO のアカウントで作業させます。プロジェクトと顧客の参照、担当者別やプロジェクト別の工数の確認、未払いの請求書とチームの稼働率のチェック、工数の登録ができます。MOCO のサブドメインと、MOCO のプロフィールで取得する API キーを使います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MOCO_SUBDOMAIN, MOCO_API_KEY

ステップ 1 — 認証情報を取得

1. MOCO で右上のプロフィール画像をクリックしてプロフィールを開き、Integrations タブで個人用の API キーをコピーします。このキーで使えるのは、あなたの MOCO ユーザーが見られるもの、できることだけです。
2. 代わりに、Settings → Extensions → API & Webhooks → API Keys でアカウントの API キーを作成することもできます。権限は読み取り専用かフルアクセスを選べます。読み取り専用のキーでは工数を登録できません。
3. キーを MOCO_API_KEY に貼り付けます。
4. MOCO_SUBDOMAIN には MOCO のアドレスの最初の部分だけを設定します。agency.mocoapp.com なら agency と入力し、https:// や .mocoapp.com は付けません。コネクターは https://agency.mocoapp.com/api/v1 を呼び出します。
5. コネクターをインストールします。Authorize with Provider の手順はありません。キーは暗号化して保存され、リクエストごとに送信されます。
6. まず moco_list_users を実行します。同僚の名前と ID が表示されれば、キーとサブドメインは正しく設定されています。

サインイン状態の維持: コネクターはキーをそのまま使うため、更新が必要なサインインはありません。MOCO でキーを差し替えたり削除したりした場合は、新しいキーを MOCO_API_KEY に貼り付けてください。

AI が見られる範囲: どの一覧も、キーのユーザーに閲覧権限があるレコードだけを返します。プロジェクトや請求書が見つからない場合、たいていはコネクターの不具合ではなく MOCO 側の権限の問題です。

工数の登録: MOCO に書き込むツールは moco_create_activity だけです。キーの持ち主のユーザーに 1 件の工数を登録します。指定するのは日付、プロジェクト ID、タスク ID、秒単位の時間（2 時間なら 7200）、任意の説明です。AI は moco_list_projects でプロジェクトを、moco_get_project でそのタスクを探します。呼び出すたびに新しいエントリーが作られ、同じ呼び出しを繰り返すと工数が二重に登録されます。そのため AI は先に日付、プロジェクト、タスク、時間を示し、あなたの承認を待ちます。

権限と読み取り専用の設定: 読み取りだけのコネクターにするには、コネクターのページで moco_create_activity を無効にするか、読み取り専用のアカウント API キーを使います。データを読むだけの人にフルアクセスのキーを渡さないでください。

レポートと請求書: moco_list_activities と moco_report_utilization には、常に開始日と終了日（from と to、形式は YYYY-MM-DD）が必要です。工数は担当者、プロジェクト、請求対象の時間だけに絞り込めます。稼働率レポートは、使える工数と予定済みの工数を比較します。moco_list_invoices はステータス（draft、created、sent、partially_paid、paid、overdue、ignored。カンマ区切りで複数指定可）、請求日、会社で絞り込めます。

制限: 一覧は 1 ページ最大 100 件で、AI は最後のページまで続けて取得します。MOCO の標準プランでは 2 分あたり約 120 リクエストまでです。超えると 429 が返るので、少し待ってからやり直してください。

よくあるエラー: 401 は、キーが間違っている、削除された、または MOCO_SUBDOMAIN とは別の MOCO アカウントのキーであることを示します。すべての呼び出しが失敗する場合は、MOCO_SUBDOMAIN にアドレス全体ではなくサブドメインだけが入っているか確認してください。特定のプロジェクトで 404 が返る場合は、ID が間違っているか、キーのユーザーにそのプロジェクトの閲覧権限がありません。登録が拒否されたときは、MOCO が受け付けなかった項目が示されます。たとえば、そのプロジェクトに属さないタスクを指定した場合です。

このコネクターは、請求書の作成や送信、PDF のダウンロード、Webhook の設定、工数の編集や削除、プロジェクト、会社、ユーザーの変更は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Microsoft Copilot にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。MOCO のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「9 月に Website Relaunch プロジェクトでチームが登録した工数は何時間？そのうち請求対象はどれくらい？」
• 「いま期限切れ、または一部だけ支払われている請求書はどれ？それぞれどの顧客のもの？」
• 「先月のチームの稼働率はどうだった？使える工数と予定済みの工数を比較して。」
• 「今日の工数として、Acme のウェブサイトプロジェクトにトップページのレイアウトレビューで 2.5 時間登録して。登録する前に内容を見せて。」

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続