@indicafacil/mcp-chatwoot

Model Context Protocol (MCP) サーバーで、Chatwoot の完全な API（indicafacil.ai 限定機能を含む）を 147 のツールとして公開し、Claude、VS Code Copilot、その他の AI アシスタントで利用できます。

特徴

• 147 のツールで Chatwoot の全 API エンドポイントをカバー

• アカウント、エージェント、コンタクト、会話、メッセージ、受信トレイ、チームなど

• レポート（v1 & v2）、ヘルプセンター、自動化ルール、カスタム属性、カスタムフィルター

• [indicafacil.ai] 限定: カンバンボード、カンバンステップ、カンバンタスク、カンバン監査イベント、カンバン設定、予約メッセージ

• 適切な MCP ツール注釈（readOnlyHint、destructiveHint、idempotentHint）

• マルチアカウント対応（account_id はツールごとの引数）

• stdio トランスポート（Claude Desktop、VS Code、任意の MCP クライアントと互換性あり）

Related MCP server: Plain.com MCP Server

必要条件

• Bun v1.0+

• API アクセスが可能な Chatwoot インスタンス

インストール

bun install

環境変数

使用方法

開発

bun run dev

本番

bun run start

Claude Desktop の設定

claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "chatwoot": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-chatwoot/src/index.ts"],
      "env": {
        "CHATWOOT_BASE_URL": "https://your-chatwoot-instance.com",
        "CHATWOOT_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code の設定

.vscode/mcp.json に追加します:

{
  "servers": {
    "chatwoot": {
      "command": "bun",
      "args": ["run", "${workspaceFolder}/src/index.ts"],
      "env": {
        "CHATWOOT_BASE_URL": "https://your-chatwoot-instance.com",
        "CHATWOOT_API_TOKEN": "your-api-token"
      }
    }
  }
}

利用可能なツール（147）

アカウント（2）

account_get, account_update

エージェントボット（5）

agent_bots_list, agent_bots_create, agent_bots_get, agent_bots_update, agent_bots_delete

エージェント（4）

agents_list, agents_create, agents_update, agents_delete

監査ログ（1）

audit_logs_list

自動化ルール（5）

automation_rules_list, automation_rules_create, automation_rules_get, automation_rules_update, automation_rules_delete

定型応答（4）

canned_responses_list, canned_responses_create, canned_responses_update, canned_responses_delete

コンタクト（11）

contacts_list, contacts_create, contacts_get, contacts_update, contacts_delete, contacts_conversations, contacts_search, contacts_filter, contacts_create_contact_inbox, contacts_contactable_inboxes, contacts_merge

コンタクトラベル（2）

contact_labels_list, contact_labels_set

会話（12）

conversations_meta, conversations_list, conversations_create, conversations_filter, conversations_get, conversations_update, conversations_toggle_status, conversations_toggle_priority, conversations_set_custom_attributes, conversations_get_labels, conversations_set_labels, conversations_reporting_events

会話の割り当て（1）

conversation_assignments_assign

メッセージ（3）

messages_list, messages_create, messages_delete

カスタム属性（5）

custom_attributes_list, custom_attributes_create, custom_attributes_get, custom_attributes_update, custom_attributes_delete

カスタムフィルター（5）

custom_filters_list, custom_filters_create, custom_filters_get, custom_filters_update, custom_filters_delete

ヘルプセンター（5）

help_center_portals_list, help_center_portals_create, help_center_portals_update, help_center_categories_create, help_center_articles_create

受信トレイ（11）

inboxes_list, inboxes_get, inboxes_create, inboxes_update, inboxes_get_agent_bot, inboxes_set_agent_bot, inbox_members_list, inbox_members_create, inbox_members_update, inbox_members_delete

統合（4）

integrations_list_apps, integrations_create_hook, integrations_update_hook, integrations_delete_hook

プロフィール（1）

profile_get

レポート（9）

reports_account_overview, reports_account_summary, reports_agent_summary, reports_conversation_metrics, reports_v2_overview, reports_v2_agents, reports_v2_inboxes, reports_v2_teams, reports_v2_labels

チーム（9）

teams_list, teams_create, teams_get, teams_update, teams_delete, team_members_list, team_members_add, team_members_update, team_members_delete

Webhook（4）

webhooks_list, webhooks_create, webhooks_update, webhooks_delete

カンバンボード（9） — [indicafacil.ai]

kanban_boards_list, kanban_boards_create, kanban_boards_get, kanban_boards_update, kanban_boards_delete, kanban_boards_update_agents, kanban_boards_update_inboxes, kanban_boards_toggle_favorite, kanban_boards_conversations

カンバンステップ（6） — [indicafacil.ai]

kanban_steps_list, kanban_steps_create, kanban_steps_get, kanban_steps_update, kanban_steps_delete, kanban_steps_reorder

カンバンタスク（6） — [indicafacil.ai]

kanban_tasks_list, kanban_tasks_create, kanban_tasks_get, kanban_tasks_update, kanban_tasks_delete, kanban_tasks_move

カンバンタスク製品（4） — [indicafacil.ai]

kanban_task_products_list, kanban_task_products_create, kanban_task_products_update, kanban_task_products_delete

カンバンタスクコメント（4） — [indicafacil.ai]

kanban_task_comments_list, kanban_task_comments_create, kanban_task_comments_update, kanban_task_comments_delete

カンバン製品（5） — [indicafacil.ai]

kanban_products_list, kanban_products_get, kanban_products_create, kanban_products_update, kanban_products_delete

カンバンレポート（7） — [indicafacil.ai]

kanban_reports_summary, kanban_reports_funnel, kanban_reports_stage_durations, kanban_reports_agent_performance, kanban_reports_cfd, kanban_reports_aging, kanban_reports_timeseries

カンバン監査イベント（2） — [indicafacil.ai]

kanban_audit_events_list, kanban_audit_events_get

予約メッセージ（4） — [indicafacil.ai]

scheduled_messages_list, scheduled_messages_create, scheduled_messages_update, scheduled_messages_delete

開発

# Run tests
bun test

# Lint & format
bun run lint
bun run format

# Type check
bun run build-check

# Full check (lint + type-check + tests)
bun run check

ライセンス

MIT