Chatwoot MCP by usefulapi について
Chatwoot MCP by usefulapiは、MCPクライアントからChatwootの会話と連絡先データを扱うホスト型サーバーです。読み取りに加え、返信や非公開メモの送信、会話の状態・優先度・担当者の更新ができます。
主な機能
- 01会話、メッセージ、連絡先の参照
- 02連絡先の検索と受信トレイの確認
- 03返信または非公開メモの送信
- 04状態と優先度の設定
- 05会話の割り当て
活用シーン
- 01顧客との会話やメッセージの確認
- 02連絡先と関連する会話の検索
- 03会話への返信や非公開メモの追加
- 04会話の状態、優先度、担当者の更新
MCP 対応
ホスト型エンドポイントを通じて、MCPクライアントにChatwootの読み取り・書き込みツールを提供します。利用者自身のChatwootアクセストークンとAccount IDで接続し、ローカルへのインストールは不要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://chatwoot.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-chatwoot https://chatwoot.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-chatwoot":{"type":"http","url":"https://chatwoot.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-chatwoot":{"type":"http","url":"https://chatwoot.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-chatwoot":{"type":"http","url":"https://chatwoot.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-chatwoot":{"serverUrl":"https://chatwoot.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の Chatwoot MCP
Claude、Cursor、または任意の MCP クライアントから、Chatwoot アカウントを利用できます。会話、連絡先、受信トレイの読み取り、返信や非公開メモの追加、ステータスや優先度の設定、会話の割り当てが可能です。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続できます。
ライブエンドポイント: https://chatwoot.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、デスクトップ):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://chatwoot.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http chatwoot https://chatwoot.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"chatwoot": {
"url": "https://chatwoot.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアントの設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Chatwoot の認証情報を求めます。
ステップごとのセットアップ方法、認証情報の確認方法、よくある質問:https://usefulapi.io/chatwoot/
初回接続時に、Chatwoot アクセストークン(Profile Settings → Access Token)とアカウント ID(Chatwoot の URL 内の /app/accounts/ に続く数字)を入力します。サーバーがこれを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
chatwoot_get_account | read | アカウントを取得 |
chatwoot_list_conversations | read | 会話の一覧を取得 |
chatwoot_get_conversation_counts | read | 会話数を取得 |
chatwoot_get_conversation | read | 会話を取得 |
chatwoot_list_messages | read | メッセージの一覧を取得 |
chatwoot_list_contacts | read | 連絡先の一覧を取得 |
chatwoot_search_contacts | read | 連絡先を検索 |
chatwoot_get_contact | read | 連絡先を取得 |
chatwoot_list_contact_conversations | read | 連絡先の会話一覧を取得 |
chatwoot_list_labels | read | ラベルの一覧を取得 |
chatwoot_list_inboxes | read | 受信トレイの一覧を取得 |
chatwoot_list_agents | read | エージェントの一覧を取得 |
chatwoot_list_teams | read | チームの一覧を取得 |
chatwoot_list_canned_responses | read | 定型返信の一覧を取得 |
chatwoot_send_message | write | メッセージまたは非公開メモを送信 |
chatwoot_set_conversation_status | write | 会話のステータスを設定 |
chatwoot_set_conversation_priority | write | 会話の優先度を設定 |
chatwoot_assign_conversation | write | 会話を割り当て |
chatwoot_usage_status | meta | 使用状況(無料プランの利用回数) |
chatwoot_request_feature | meta | 不足している機能をリクエスト |
chatwoot_upgrade | meta | Pro にアップグレード(無制限*) |
chatwoot_cancel_subscription | meta | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントは実行前に確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月あたり50回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro には、このサーバーで月あたり10,000回のツール呼び出しというフェアユース上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro が適用されるのはこのサーバーのみです。chatwoot_upgrade で登録してください(Stripe Checkout のリンクが返されます)。chatwoot_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現行期間分の返金はありません。その前に chatwoot_upgrade を実行すると、キャンセルが取り消されます。または [email protected] までご連絡ください。
ライセンス
MIT — LICENSE を参照してください。ドキュメントのみです。サーバーはホストされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。