Peach Whatsapp Business Api Mcp

@peachai/mcp

Peach WhatsApp メッセージングプラットフォーム向けの MCP（Model Context Protocol）サーバーです。Claude などの AI アシスタントが、Peach アカウントを通じてメッセージの送信、テンプレートや連絡先の管理、メディアの操作を直接行えるようにします。

要件

• Node.js 18 以降
• API キーを取得した Peach アカウント

API キーの取得

app.trypeach.ai にログインし、設定 → API に移動して、API キーをコピーします。

セットアップ

ホステッドサーバーのセットアップ

推奨 Peach はホステッド MCP サーバーを提供しています。こちらの利用をおすすめします。

{
  "mcpServers": {
    "peach": {
      "url": "https://app.trypeach.ai/api/mcp",
      "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

Claude Desktop

次の内容を claude_desktop_config.json に追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "peach": {
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop を再起動します。会話で Peach のツールを利用できるようになります。

Cursor

設定 → MCP に移動して、次の内容を追加します。

{
  "peach": {
    "command": "npx",
    "args": ["-y", "@peachai/mcp"],
    "env": {
      "PEACH_API_KEY": "your-api-key"
    }
  }
}

Claude Code

次のコマンドを実行して、Claude Code のセットアップに Peach AI を追加します。

claude mcp add --scope user --env PEACH_API_KEY=your-api-key peach -- npx -y @peachai/mcp

または、.mcp.json に手動で追加します。

{
  "mcpServers": {
    "peach": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

Antigravity

Antigravity の設定 → カスタマイズに移動します。「MCP 設定を開く」をクリックして、次の内容を追加します。

{
  "mcpServers": {
    "peach": {
      "serverUrl": "https://app.trypeach.ai/api/mcp",
       "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

利用可能なツール

メッセージング

ツール	説明
peach_send_template_message	連絡先に WhatsApp テンプレートメッセージを送信します
peach_send_app_message	フローまたはアプリから開始するメッセージを実行します
peach_connect_to_ai_agent	テンプレートを送信し、連絡先を AI エージェントに接続します
peach_get_event_status	送信したイベントのステータスを確認します
peach_list_template_messages	フィルターを指定して、送信済みテンプレートメッセージを一覧表示します

一斉送信

ツール	説明
peach_launch_broadcast	一斉送信キャンペーンを作成して開始します

テンプレート

ツール	説明
peach_list_templates	WhatsApp テンプレートをすべて一覧表示します
peach_get_template	ID または名前を指定して、特定のテンプレートを取得します
peach_create_template	新しい WhatsApp テンプレートを作成します
peach_update_template	既存のテンプレートを更新します
peach_submit_template	Meta の審査にテンプレートを提出します
peach_pause_template	承認済みのテンプレートを一時停止します
peach_archive_template	テンプレートをアーカイブします

連絡先

ツール	説明
peach_create_contact	連絡先を1件作成またはアップサートします
peach_create_contacts	連絡先を一括で作成またはアップサートします
peach_update_contact	電話番号を指定して連絡先を更新します

メディア

ツール	説明
peach_list_media	アップロード済みメディアファイルを一覧表示します
peach_upload_media	メディアファイルをアップロードします（base64）
peach_delete_media	メディアファイルを削除します

メッセージ

ツール	説明
peach_list_messages	任意のフィルターを指定してメッセージを一覧表示します

プロンプトの例

• 「order_confirmation テンプレートを、注文 ID 12345 とともに +14155552671 に送信して」
• 「本文に『今週末は20%オフ！』と記載した、summer_sale という名前の新しい MARKETING テンプレートを作成して」
• 「承認済みの WhatsApp テンプレートをすべて一覧表示して」
• 「連絡先 +14155552671 の名前を John Smith に更新して」
• 「テンプレート promo_v2 を使って、オーディエンスリスト abc123 に一斉送信を開始して」