インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Chatwoot をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
クラウド版またはセルフホスト版の Chatwoot オムニチャネルサポート受信箱に対応します。WhatsApp、メール、Web チャット、ソーシャルチャネルの会話とメッセージ、コンタクト、ラベル、エージェント、チーム、定型返信、サポートレポート（初回応答、解決時間、返信時間）を扱えます。返信、プライベートノート、新規会話の作成も含まれますが、インストール時はオフです。
こう聞いてみよう
Chatwoot のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Chatwoot をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Chatwoot + ChatGPT
クラウド版またはセルフホスト版の Chatwoot オムニチャネルサポート受信箱に対応します。WhatsApp、メール、Web チャット、ソーシャルチャネルの会話とメッセージ、コンタクト、ラベル、エージェント、チーム、定型返信、サポートレポート（初回応答、解決時間、返信時間）を扱えます。返信、プライベートノート、新規会話の作成も含まれますが、インストール時はオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID
ステップ 1 — 認証情報を取得
セットアップは約 2 分です。Chatwoot Cloud またはセルフホストの Chatwoot アカウントと、AI に操作させたいユーザーのアクセストークンが必要です。
- そのユーザーで Chatwoot にサインインします。エージェントは自分が所属する受信箱の会話しか見られず、レポートも読めません。全体を把握するには管理者を使ってください。
- アバターをクリックし、Profile Settings を開いて、ページ下部の Access Token を
CHATWOOT_API_TOKENにコピーします。トークンに有効期限はなく、同じページでリセットできます。 CHATWOOT_URLには Chatwoot を開くときのアドレスを設定します。Chatwoot Cloud ならhttps://app.chatwoot.com、セルフホストならhttps://chat.example.comのような独自ドメインです。パス、/app、/apiは付けません。CHATWOOT_ACCOUNT_IDには、ブラウザのアドレスバーで/app/accounts/の後ろにある数字を設定します。https://app.chatwoot.com/app/accounts/3/dashboardなら 3 です。- コネクターをインストールし、
chatwoot_get_profileを実行します。トークンのユーザー、その役割、トークンでアクセスできるすべてのアカウントと ID が表示されます。
アカウントのトークンであり Platform API ではありません: セルフホストのスーパー管理者が使う Platform App のトークン（/platform/api）はここでは使えません。このコネクターは 1 つのアカウントの Chatwoot Application API を使います。
nginx の背後にあるセルフホスト: トークンは api_access_token ヘッダーで送られますが、nginx は underscores_in_headers on; を設定しない限りアンダースコアを含むヘッダーを破棄します。その場合、トークンが正しくてもすべての呼び出しが 401 になります。プライベートネットワーク内だけで動くセルフホストの Chatwoot には AnythingMCP Cloud から接続できません。そのネットワーク内でセルフホストの AnythingMCP を使ってください。
読み取れるデータ: アカウントとトークンのユーザー、メンバー付きの受信箱（WhatsApp、メール、Web ウィジェット、API、Instagram、Telegram など）、稼働状況付きのエージェントと管理者、チームとそのメンバー、ラベル、定型返信（canned responses）、カスタム属性の定義、ステータス、優先度、受信箱、ラベル、コンタクト、担当者、チームを含む会話（一覧、件数、または特定の日付以降に作成され特定のエージェントに割り当てられたものといった条件での絞り込み）、プライベートノートと添付ファイルを含む会話のメッセージ、名前、メール、電話番号、識別子で探せるコンタクトとすべての受信箱にわたるその会話、そしてサポートレポート（前の期間と並べた期間の合計、指標の推移、エージェント、受信箱、チームの比較、現時点で未対応のオープン会話）です。受信箱のチャネルシークレットとユーザー自身のアクセストークンはレスポンスから除外されます。
時刻と数値: 会話とメッセージの時刻、レポートの期間は秒単位の Unix タイムスタンプ（UTC）で、AI は時刻を伝える前に変換します。レポートの初回応答時間、解決時間、返信時間は秒単位です。
変更の前に必ず確認: chatwoot_set_conversation_labels。Chatwoot は会話のラベル一覧を丸ごと置き換えるため、AI はまず現在のラベルを読み取り、新しいラベルと一緒に送ります（削除する場合はそれを除いて送ります）。ラベルはアカウントに既に存在している必要があります。AI は会話と新しいラベル一覧を示し、あなたの承認を待ちます。
インストール時はオフ: chatwoot_send_message（返信、またはエージェントだけが見られるプライベートノート）と chatwoot_create_conversation。返信や最初のメッセージは WhatsApp、メール、チャットですぐに顧客へ届くため、管理者が意図して有効にします。有効にした後も、AI は本文と宛先を示してあなたの承認を待ちます。WhatsApp Cloud API の受信箱では、自由入力のテキストが届くのはコンタクトの最後のメッセージから 24 時間以内だけです。それを過ぎると Chatwoot では承認済みテンプレートが必要ですが、このコネクターはテンプレートを送信しません。
制限: 会話は 1 ページ 25 件、コンタクトは 1 ページ 15 件、メッセージは 1 回 20 件ずつ返るため、AI はページを順にたどります。件数だけが必要なときは一覧を取らずに数えます。レポートとライブ統計には管理者のトークンが必要です。
よくあるエラー: 401 はトークンが間違っているかリセットされたこと、または nginx がヘッダーを破棄していることを示します。すべての呼び出しで 404 になる場合は、たいてい CHATWOOT_URL か CHATWOOT_ACCOUNT_ID が間違っています。特定の会話だけ 404 になる場合は、このユーザーが見られない ID です。管理者でないエージェントには、レポートは 401 または 403 を返します。
このコネクターは、Platform API の利用、WhatsApp テンプレートの送信、既存の会話の解決、再割り当て、削除、コンタクトの編集や削除は行いません。
ステップ 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 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
Chatwoot）。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
chatwoot_get_profile | Get the user behind the access token: id, name, email, role, availability and every account the token can reach (accounts[].id and name) |
chatwoot_get_account | Get the Chatwoot account configured in CHATWOOT_ACCOUNT_ID: name, locale, domain, support e-mail, status, enabled features and custom… |
chatwoot_list_inboxes | List the inboxes (channels) of the account: id, name, channel type (WhatsApp, API, web widget, e-mail, Instagram, Telegram...), phone… |
chatwoot_list_inbox_agents | List the agents who are members of one inbox (id, name, email, role, availability) |
chatwoot_list_agents | List the agents and administrators of the account: id, name, email, role (agent or administrator), availability (online, busy, offline) and… |
chatwoot_list_teams | List the teams of the account (id, name, description, whether auto-assignment is on) |
chatwoot_list_team_members | List the agents in one team (id, name, email, role, availability) |
chatwoot_list_labels | List the labels defined in the account: id, title, description and color |
chatwoot_list_canned_responses | List the canned responses (saved replies) of the account: id, short code and content |
chatwoot_list_custom_attributes | List the custom attribute definitions of the account for conversations (attribute_model 0) or contacts (1): key, display name, type and… |
chatwoot_list_conversations | List conversations, 25 per page, newest activity first, with counts (mine, assigned, unassigned, all) |
chatwoot_count_conversations | Count conversations without listing them: mine_count, assigned_count, unassigned_count and all_count for a status, inbox, team or label |
chatwoot_filter_conversations | Filter conversations with Chatwoot's advanced filter, 25 per page: a list of conditions on status, assignee_id, inbox_id, team_id… |
chatwoot_get_conversation | Get one conversation by its id (the number shown in the Chatwoot URL): status, priority, inbox, labels, contact, assignee, team, custom and… |
chatwoot_list_messages | List the messages of a conversation, oldest first: the latest 20 by default, or 20 older than before. message_type 0 = incoming (from the… |
chatwoot_list_contacts | List contacts with an e-mail, phone number or identifier, 15 per page: id, name, e-mail, phone, identifier, custom and additional… |
chatwoot_search_contacts | Search contacts by name, e-mail, phone number or identifier (case-insensitive, partial), 15 per page. meta.has_more tells whether another… |
chatwoot_get_contact | Get one contact: name, e-mail, phone, identifier, custom and additional attributes, last activity and the inboxes the contact is reachable… |
chatwoot_list_contact_conversations | List the conversations of one contact across all inboxes, with status, labels, assignee and last message |
chatwoot_get_report_summary | Get the totals of a period for the account, an agent, an inbox, a label or a team: conversations, incoming and outgoing messages… |
chatwoot_get_report_timeseries | Get one metric over time as [{value, timestamp}] buckets, for the account, an agent, an inbox, a label or a team, grouped by hour, day… |
chatwoot_get_summary_by | Compare agents, inboxes or teams over a period, one row each: conversations, resolved and handled conversations, average resolution, first… |
chatwoot_get_live_conversation_stats | Right now: how many conversations are open, unattended (no reply yet) and unassigned for the whole account (type account), or open and… |
chatwoot_send_message | Send a reply in an existing conversation, or add a private note that only agents see (private true) |
chatwoot_set_conversation_labels | Set the labels of a conversation |
chatwoot_create_conversation | Start a new conversation with an existing contact in an inbox, optionally with a first message, status, assignee and team |
プロンプトの例
- 「今、誰にも割り当てられていないオープンな会話は何件ありますか。未対応のチャットを抱えているエージェントも教えてください。」
- 「会話 1284 を読んで、お客様の要望と、こちらがすでに約束した内容をまとめてください。」
- 「コンタクト [email protected] を探して、WhatsApp とメールでのすべての会話を一覧にしてください。」
- 「過去 30 日間のエージェントを比較してください。対応した会話数、初回応答時間、解決時間をお願いします。」
- 「会話 1284 に返金ラベルを追加し、ほかのラベルはそのまま残してください。先に新しい一覧を見せてください。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?
