Z-API MCPをMicrosoft Copilotに接続

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

Z-API + Microsoft Copilot

Z-API はブラジル発の WhatsApp ゲートウェイです。インスタンスの接続確認、チャットと連絡先の閲覧、番号の WhatsApp 利用確認を行い、QR コードで連携した WhatsApp 番号からテキスト、画像、ドキュメントのメッセージを送信できます。

前提条件

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

ZAPI_INSTANCE_ID, ZAPI_INSTANCE_TOKEN, ZAPI_CLIENT_TOKEN

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

1. Z-API パネル（app.z-api.io）で Instances を開き、インスタンスを作成または選択して編集をクリックします。インスタンス ID を ZAPI_INSTANCE_ID に、インスタンストークンを ZAPI_INSTANCE_TOKEN にコピーします。
2. Security タブのモジュール Account Security Token を開き、Set Up Now をクリックしてトークンを ZAPI_CLIENT_TOKEN にコピーします。続いて Activate Token をクリックすると、すべてのリクエストでこのトークンが必須になります。
3. 電話を連携します。WhatsApp（Linked devices）でインスタンスの QR コードをスキャンしてください。番号が連携されるまで、送信はすべて失敗します。
4. まず z_api_get_status を実行します。connected: false は QR コードの再スキャンが必要であること、smartphoneConnected: false は電話がオフラインであることを示します。

Z-API は、お使いの番号で WhatsApp Web セッションを実行するサードパーティのゲートウェイです。Meta 公式の WhatsApp Business API ではなく、一斉送信を行う番号は WhatsApp によって制限される場合があります。電話番号は国番号と市外局番を含む数字のみで、+、スペース、ハイフンは入れません（5511999999999）。送信ツールは実際の WhatsApp メッセージを送信します。まず宛先と本文を確認し、messageId が返された送信は決して再試行しないでください。Z-API の Security タブで IP 制限を有効にしている場合は、AnythingMCP の送信元アドレスを許可してください。

ステップ 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 ウィンドウで試します。Z-API のツールが必要になる依頼をしてみましょう。
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 は使えません。

利用可能なツール

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 に接続