crisp-mcp-server

Сервер Model Context Protocol для REST API Crisp, развёрнутый на Cloudflare Workers.

Он предоставляет сайты, операторов и диалоги Crisp в виде инструментов MCP, чтобы MCP-совместимый ИИ-агент мог запрашивать их, оставлять приватные заметки и управлять сегментами диалогов.

Инструменты

Related MCP server: neon-mcp

Аутентификация

Сервер не хранит состояние и не требует учётных данных: он не сохраняет токен Crisp. Каждый MCP-клиент передаёт токен Crisp напрямую в эндпоинт.

REST API Crisp использует Basic-аутентификацию с парой ключей token_id:token_key. Закодируйте строку token_id:token_key в Base64 и передайте её как Bearer-токен в эндпоинт MCP:

Authorization: Bearer <base64(token_id:token_key)>

Worker передаёт это значение в API Crisp как Authorization: Basic <base64(...)>.

Уровень

Токены Crisp бывают двух типов: website (одна рабочая область) или plugin (несколько рабочих областей). Выберите уровень с помощью параметра запроса tier:

• ?tier=website (по умолчанию) — задаёт X-Crisp-Tier: website

• ?tier=plugin — задаёт X-Crisp-Tier: plugin

Создавайте токены в приложении Crisp: Settings → Workspace Settings → Advanced configuration → API Token (website) или в Crisp Marketplace (plugin).

Разработка

npm install
npm run dev      # local dev at http://localhost:8787
npm run typecheck

Развёртывание

npm run deploy

Затем укажите MCP-клиенту адрес https://<your-worker>.workers.dev/mcp?tier=website с заголовком Authorization: Bearer <base64(...)>.

Пример для Claude Desktop / Claude Code

{
  "mcpServers": {
    "crisp": {
      "url": "https://<your-worker>.workers.dev/mcp?tier=website",
      "headers": {
        "Authorization": "Bearer <base64(token_id:token_key)>"
      }
    }
  }
}

Как это работает

• src/index.ts — точка входа Worker. Извлекает Bearer-токен и уровень из запроса, создаёт новый MCP-сервер для каждого запроса и передаёт его в createMcpHandler (транспорт Streamable HTTP без сохранения состояния).

• src/crisp.ts — тонкий REST-клиент Crisp только для чтения (https://api.crisp.chat/v1).

• src/tools.ts — регистрирует указанные выше инструменты MCP.

Примечания

• Преимущественно чтение: запись доступна только для приватных заметок и сегментов диалогов; все остальные инструменты — только для чтения.

• Без состояния: нет Durable Objects, сессий и сохранённых учётных данных.

• Токен Crisp отправляется клиентом при каждом подключении; если он утёк, смените его в приложении Crisp.