MCP 経由で Manychat を Gemini に接続する方法

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

Manychat + Gemini

Instagram、WhatsApp、Messenger、Telegram の Manychat アカウントを AI で操作します。コンタクトを検索してタグやフィールドを確認し、タグ付け、フィールドや連絡先情報の更新、フローとグロースツールの一覧表示を行い、あなたの確認後にメッセージ送信やフローの開始もできます。

前提条件

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

MANYCHAT_API_KEY

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

セットアップは約 2 分です。Pro プラン以上の Manychat アカウントが必要です。無料プランと Essential プランには API キーがありません。

1. Manychat で、接続したいアカウント（Instagram、WhatsApp、Messenger、Telegram のボット）を開きます。
2. Settings → API を開き、Generate your API Key をクリックします。
3. キー全体を MANYCHAT_API_KEY にコピーします。形式は 1234567:0123456789abcdef... で、ページ ID、コロン、ハッシュが続きます。Bearer という語は付けないでください。
4. コネクターをインストールし、manychat_get_account を実行します。キーが属するアカウントと、Pro プランかどうかが表示されます。

1 つのキーで 1 つのアカウント: キーは 1 つの Manychat アカウントにだけ有効です。自社ブランドの Instagram とクライアントの WhatsApp のように複数のアカウントを運用している場合は、アカウントごとにコネクターをインストールします。Manychat でキーを再生成または削除すると、新しいキーを貼り付けるまでコネクターは動きません。

読み取れるデータ: アカウント情報、タグ、コンタクトフィールドとボットフィールド、フォルダー付きのフロー（オートメーション）、リファラルリンク、QR コード、コメントトリガーなどのグロースツール、そしてチャネル、オプトイン、購読状態、最終やり取り、タグ、フィールド値を含むコンタクトです。

コンタクトの探し方: Manychat の API には全コンタクトの一覧がありません。AI はフルネーム、メールアドレスや電話番号、またはテキスト型・数値型フィールドの値（最大 100 件）でコンタクトを探し、目的の 1 件を読み取ります。「メールアドレスが [email protected] のコンタクト」は探せますが、「VIP タグの付いた全員」は一覧にできません。

変更の前に必ず確認: タグの付与と解除、コンタクトフィールドやボットフィールドの設定、コンタクトの作成と更新、タグやフィールドの新規作成はアカウントを変更し、新しいタグや値をきっかけに動くオートメーションが起動することもあります。AI は対象のコンタクトと変更内容を示し、あなたの承認を待ちます。API でのコンタクト作成は有料プランのインポート機能です。

メッセージの送信: manychat_send_text_message、manychat_send_content、manychat_send_flow は実在の相手に実際のメッセージを送ります。Instagram、Messenger、WhatsApp では、自動メッセージを送れるのはコンタクトの最後のメッセージから 24 時間以内だけです。その時間を過ぎると、WhatsApp では承認済みテンプレートで始まるフローが必要です。送信の前に、AI は宛先と正確な本文またはフローを示します。

インストール時はオフ: manychat_delete_tag。タグをアカウントと、そのタグが付いたすべてのコンタクトから削除し、元に戻せません。管理者が意図して有効にできます。

制限: Manychat はアカウントごとに制限を設けています。たとえばコンタクトの検索と変更は 1 秒あたり 10 リクエスト、1 つのコンタクトへのフロー開始は 1 時間あたり 100 回までです。超過が続くとアカウントへの提供が止められることがあるため、AI は数百件をループせず、1 件ずつ処理します。

よくあるエラー: 401 の "Wrong token" は、キーが間違っている、欠けている、または再生成されたことを示します。コード 3011 はコンタクトが 24 時間の枠外であること、コード 3040 から 3049 はコンテンツがそのコンタクトのチャネルで使えないことを示します。

このコネクターは、全コンタクトの一覧表示、コンタクトやフィールドの削除、ライブチャットへの参加、コメントへの返信、決済の処理は行いません。

ステップ 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 — Gemini にコネクタを追加

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

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Manychat のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「メールアドレスが [email protected] のコンタクトを探して、タグと最後に連絡をくれた日時を教えてください。」
• 「Marco Rossi に VIP タグを付けて、Lead score フィールドを 80 にしてください。変更する前に内容を見せてください。」
• 「Black Friday フォルダーにはどのフローがありますか。コメントトリガーと QR コードも一覧にしてください。」
• 「WhatsApp のコンタクト +81 90 1234 5678 に Welcome back フローを開始してください。送信前に確認させてください。」
• 「Laura から過去 24 時間以内に Instagram でメッセージが来ていたら、注文品を本日発送したと返信してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

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