Omnichannel MCP Server for Claude

# ChatbotX Model Context Protocol (MCP) Server for Claude Desktop

Connect Anthropic Claude Desktop to ChatbotX via native Model Context Protocol (MCP). Claude inspects customer interactions, resolves CRM contacts, applies segmentation tags, and triggers multi-channel chatbot workflows with nuanced reasoning.

## Connection Setup for Claude Desktop
- Protocol: Model Context Protocol (MCP) via Server-Sent Events (SSE)
- Endpoint: https://app.chatbotx.io/mcp/sse
- Authentication: Header "x-workspace-token: <YOUR_WORKSPACE_TOKEN>"
- Documentation: https://chatbotx.io/docs/mcp/introduction

### Configuration (claude_desktop_config.json)
```json
{
  "mcpServers": {
    "chatbotx": {
      "url": "https://app.chatbotx.io/mcp/sse",
      "headers": {
        "x-workspace-token": "YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}
```

## Available MCP Tools
- contacts_search: Look up contacts by email, international phone (+84...), or workspace identifier.
- contacts_tag: Dynamically apply or remove segmentation tags to categorize customers.
- contacts_custom_field: Query and update custom CRM fields on contact records.
- flows_trigger: Programmatically trigger automated multi-step chatbot flows and sequences.
- conversations_list: Retrieve conversation threads with status, channel, and message history filters.
- messages_send: Send direct responses or notification messages across customer channels.
- broadcasts_list: Inspect broadcast campaign history, audiences, and delivery statuses.
- channels_list: Verify connected channels and active webhook listener health.

## Example Prompts for Claude
- "Look up contact for '[email protected]', analyze their conversation history, and suggest a high-empathy response to their shipping complaint."
- "Find all contacts tagged 'Enterprise Trial' that haven't received a message in 7 days, and trigger the check-in sequence."
- "List open conversations on WhatsApp and summarize the top 3 product issues raised by customers this morning."

## Supported Messaging Channels
WhatsApp, Messenger, Instagram, TikTok, Telegram, Zalo OA, Webchat, SMTP, and API.

## Safety & Guardrails
Claude prompts for user confirmation before dispatching mass broadcasts or executing destructive updates.