chatflow

ChatFlow MCP

AI エージェントを WhatsApp の CRM に接続します。

ChatFlow は、小規模チーム向けの WhatsApp／Telegram／Instagram CRM です。共有受信トレイ、ドラッグ＆ドロップ式の営業パイプライン、AI 自動返信、ブロードキャストキャンペーンを利用できます。これは、ホスト型の MCP（Model Context Protocol） サーバーです。Claude、Claude Code、Cursor、または MCP 対応エージェントをワークスペースに接続すると、連絡先の検索、会話の確認、パイプラインの管理ができるほか、許可した場合はメッセージの送信もできます。

• エンドポイント： https://valuable-sockeye-14.eu-west-1.convex.site/mcp
• トランスポート： Streamable HTTP（ステートレス）
• 認証： Authorization: Bearer <API key> — ChatFlow → Settings → AI agents (MCP) で作成します

クイックスタート

1. ChatFlow で Settings → AI agents (MCP) を開き（ワークスペースのオーナー）、Create API key をクリックします。キーをコピーしてください。キーは一度しか表示されません。必要に応じて有効期限を設定できます。
2. クライアントにサーバーを追加します。

Claude Code

claude mcp add --transport http chatflow \
  https://valuable-sockeye-14.eu-west-1.convex.site/mcp \
  --header "Authorization: Bearer cfk_YOUR_KEY"

Claude.ai / Claude Desktop — Settings → Connectors → Add custom connector を開き、エンドポイント URL を貼り付けて、Authorization: Bearer cfk_YOUR_KEY ヘッダーを設定します。

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "chatflow": {
      "url": "https://valuable-sockeye-14.eu-west-1.convex.site/mcp",
      "headers": { "Authorization": "Bearer cfk_YOUR_KEY" }
    }
  }
}

詳しい設定方法とトラブルシューティングについては、docs/setup.md をご覧ください。

ツール

ツール	機能
search_contacts	名前または電話番号の一部で連絡先を検索します
list_conversations	プレビュー、未読件数、CRM フィールドを含む最近のチャットを一覧表示します
get_conversation	1 件のチャットの連絡先、メモ、取引額、最近のメッセージを取得します
list_pipeline	各ステージの見込み客を含むカンバン列を一覧表示します
move_conversation	見込み客をパイプラインの列に移動します
update_lead	会話のメモ／取引額を設定します
create_contact	電話番号から WhatsApp の連絡先と会話を作成します
send_message	顧客にテキストを送信します（オプトインが必要です。下記参照）
get_usage	サブスクリプションのプラン、上限、現在の月間使用量を確認します

読み取りツールには読み取り専用の注釈が付いています。send_message には、適切に動作するクライアントが呼び出し前に確認するよう、外部に影響する書き込み操作として注釈が付いています。

メッセージ送信はオプトインです

send_message は実際の顧客にメッセージを送るため、デフォルトでは無効になっています。ワークスペースのオーナーは、Settings の "Allow agents to send messages" トグルで有効にできます。無効の間、エージェントはすべての内容を読み取り、返信を下書きできますが、送信はすべて拒否され、トグルについて説明するメッセージが返されます。有効にすると、エージェントによる送信は月間クォータに加算され、AI バッジ付きで受信トレイに表示され、そのチャットでは自動返信アシスタントが一時停止され（2 つの AI が同時に返信することを防ぎます）、再試行による二重送信を防ぐ idempotencyKey に対応します。

プロンプトインジェクションに関する注意： エージェントが読み取るメッセージ本文やメモは、顧客が作成したものです。エージェントの動作を信頼できる場合を除き、送信トグルは無効のままにしてください。

リンク

• 製品：https://chatflow.biz
• 設定ガイド：docs/setup.md