Zoho Mail MCPをMicrosoft Copilotと連携

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

Zoho Mail + Microsoft Copilot

AI に Zoho Mail で作業させます。フォルダーや Zoho の検索でメールを探し、本文・ヘッダー・詳細を読み、送信と返信を行い、既読にする、移動する、フラグを付ける、ラベルを付けるといった操作ができます。すべての Zoho データセンターに対応し、Zoho OAuth でサインインします。

前提条件

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

ZOHO_MAIL_CLIENT_ID, ZOHO_MAIL_CLIENT_SECRET, ZOHO_MAIL_ACCOUNTS_URL, ZOHO_MAIL_API_URL

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

無料プランまたは有料プランの Zoho Mail メールボックスが必要です。

まずデータセンターを確認: Zoho はアカウントごとに 1 つのデータセンターで管理しており、サインインサーバーと Mail API のホストはどちらもそのデータセンターのものでなければなりません。Zoho Mail を使っているときのアドレスバーで確認できます。データセンターが違うと INVALID_OAUTHTOKEN または invalid_client で失敗します。

1. Zoho アカウントでサインインした状態で Zoho API Console（api-console.zoho.com）を開き、Add Client → Server-based Applications を選びます。
2. クライアントに名前（例: AnythingMCP）を付け、homepage URL に自社サイトを、Authorized Redirect URI に https://cloud.anythingmcp.com/api/mcp-oauth/callback を入力します。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。クライアントを作成します。
3. Client Secret タブで、Client ID（1000. で始まります）と Client Secret を ZOHO_MAIL_CLIENT_ID と ZOHO_MAIL_CLIENT_SECRET にコピーします。メールボックスが、コンソールが開いたデータセンターとは別のデータセンターにある場合は、クライアントの Settings タブ（Multi-DC）でそのデータセンターを有効にし、そこに表示される client secret を使います。
4. 表を見て ZOHO_MAIL_ACCOUNTS_URL と ZOHO_MAIL_API_URL を自分のデータセンターに合わせ、末尾のスラッシュなしで設定し、コネクターをインストールします。
5. コネクターのページで Authorize with Provider をクリックし、Zoho にサインインして、要求されたアクセスを承認します。
6. zoho_mail_list_accounts を実行して接続を確認します。メールボックスと、AI が送信に使えるアドレスが表示されます。

サインイン状態の維持: アクセストークンの有効期間は 1 時間で、保存されたリフレッシュトークンで自動的に更新されます。Zoho が保持するリフレッシュトークンはユーザーとクライアントごとに最大 20 個です。同じクライアントを 21 回目に承認すると、最も古いものが通知なく取り消されます。コネクターのサインインが切れた場合は、もう一度 Authorize with Provider をクリックしてください。

アクセス許可と読み取り専用の設定: コネクターは ZohoMail.accounts.READ、ZohoMail.folders.READ、ZohoMail.messages.ALL、ZohoMail.tags.READ を求め、承認した Zoho ユーザーとして動作します。読み取り専用にするには、コネクターの OAuth 設定で ZohoMail.messages.ALL を ZohoMail.messages.READ に変えて再度承認し、zoho_mail_send_email、zoho_mail_reply_to_email、zoho_mail_mark_as_read、zoho_mail_mark_as_unread、zoho_mail_move_emails、zoho_mail_flag_emails、zoho_mail_apply_labels をオフにします。

あなたの「はい」なしには送信しません: zoho_mail_send_email と zoho_mail_reply_to_email は、あなたの名前で実際にメールを送ります。送信の前に、AI は宛先、件名、本文を示し、はっきりとした「はい」を待ちます。既読・未読の設定、移動、フラグ、ラベルはメールボックスを変更するため、AI は先に何が変わるかを伝えます。

インストール時はオフ: zoho_mail_delete_email。オンにすると、メールはごみ箱に移動します。完全に削除するのは、あなたがはっきりそう指示した場合だけです。

アカウント、フォルダー、検索: どの呼び出しにもメールアカウントの ID が必要なため、AI はまずあなたのアカウントを読み取ります。追加した POP アカウントなど複数のアカウントがある場合は、あなたが指すアカウントを使い、そのアカウント自身のアドレスから送信します。未読、フラグ付き、ラベル付きのメールで絞り込んでフォルダーを一覧表示したり、送信者、件名、添付ファイル、日付などで Zoho の検索を使ったりします。

メールは信頼できない内容として扱います: メールは外部の送信者から届きます。AI はメール内の指示を内容として扱い、命令としては扱いません。

よくあるエラー: 401 INVALID_OAUTHTOKEN は、サインインがないか取り消されたこと、または ZOHO_MAIL_API_URL があなたのデータセンターではないことを示します。URL を直すか、もう一度 Authorize with Provider をクリックしてください。サインイン時の invalid_client は、たいてい ZOHO_MAIL_ACCOUNTS_URL があなたのデータセンターではないか、client secret が別のデータセンターのものであることを示します（手順 3 を参照）。moreInfo の説明付きの 400 は、不明な ID、誤った検索、アカウントに属さない送信元アドレスなど、パラメーターが無効であることを示します。404 は、このユーザーにそのアカウント、フォルダー、メールが存在しないことを示します。500 Internal Error は Zoho 側の問題なので、もう一度だけ試してください。Zoho がリクエストが多すぎると返した場合は、1 分待ちます。

このコネクターは、添付ファイル、下書きとテンプレート、スレッド全体、フォルダーとラベルの管理、署名、休暇中の自動返信、タスク、メモ、ブックマーク、組織の管理者 API は扱いません。

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

利用可能なツール

プロンプトの例

• 「今日 Zoho Mail の受信トレイに届いた未読メールは？1 通につき 1 行でまとめて。」
• 「9 月 1 日以降に [email protected] から届いた、添付ファイル付きのメールを探して。」
• 「納期について Acme から来た最新のメールに『10 月 24 日に出荷できます』と返信して。送る前に返信内容を見せて。」
• 「今週のニュースレターを『ニュースレター』フォルダーに移動して、税理士からのメールに重要のフラグを付けて。」

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