crisp-mcp-server

Un servidor Model Context Protocol para la API REST de Crisp, desplegado en Cloudflare Workers.

Expone los sitios web, operadores y conversaciones de Crisp como herramientas MCP, de modo que un agente de IA compatible con MCP pueda consultarlos, publicar notas privadas y gestionar segmentos de conversación.

Herramientas

Related MCP server: neon-mcp

Autenticación

El servidor es sin estado y sin credenciales: no almacena ningún token de Crisp. Cada cliente MCP pasa el token de Crisp directamente al endpoint.

La API REST de Crisp utiliza autenticación Basic con un par de claves token_id:token_key. Codifica en Base64 la cadena token_id:token_key y pásala como token Bearer al endpoint de MCP:

Authorization: Bearer <base64(token_id:token_key)>

El worker reenvía ese valor como Authorization: Basic <base64(...)> a la API de Crisp.

Nivel

Los tokens de Crisp son de tipo website (un solo espacio de trabajo) o plugin (varios espacios de trabajo). Selecciona el nivel con el parámetro de consulta tier:

• ?tier=website (por defecto) — establece X-Crisp-Tier: website

• ?tier=plugin — establece X-Crisp-Tier: plugin

Genera tokens desde la aplicación de Crisp: Configuración → Configuración del espacio de trabajo → Configuración avanzada → Token de API (website), o desde Crisp Marketplace (plugin).

Desarrollar

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

Desplegar

npm run deploy

Después apunta un cliente MCP a https://<your-worker>.workers.dev/mcp?tier=website con la cabecera Authorization: Bearer <base64(...)>.

Ejemplo de Claude Desktop / Claude Code

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

Cómo funciona

• src/index.ts — Punto de entrada del Worker. Extrae el token Bearer y el nivel de la solicitud, crea un servidor MCP nuevo por solicitud y se lo pasa a createMcpHandler (transporte Streamable HTTP sin estado).

• src/crisp.ts — Cliente REST de Crisp ligero y de solo lectura (https://api.crisp.chat/v1).

• src/tools.ts — Registra las herramientas MCP anteriores.

Notas

• Mayormente de solo lectura: solo las notas privadas y los segmentos de conversación se pueden escribir; todas las demás herramientas son de solo lectura.

• Sin estado: no hay Durable Objects, ni sesiones, ni credenciales almacenadas.

• El token de Crisp lo envía el cliente en cada conexión; si se filtra, puedes rotarlo desde la aplicación de Crisp.