@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: OpenWA 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

웹훅 (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