API y MCP: conecta un asistente de IA

API & MCP (en Users, al final de la barra lateral) te permite conectar un asistente de IA, como Claude u otro cliente MCP, para configurar y gestionar tu espacio de trabajo. MCP es un estándar abierto que permite que un asistente use herramientas en una app en tu nombre. Los mismos tokens de acceso abren la REST API.

Qué necesitas #

• El endpoint MCP, que aparece en la parte superior de la página. Pulsa Copy URL.
• Un token de acceso que indique qué puede hacer el asistente.

Crear un token de acceso #

1. Pulsa Create token.
2. Ponle un nombre y elige su acceso: Workspace setup, o Custom permissions para seleccionarlos uno a uno (por ejemplo "Read fans and conversations" o "Read sales").
3. Guarda. El token se muestra una sola vez: pulsa Copy token, o Copy client configuration para obtener una configuración lista para tu asistente.
4. Pulsa Done, I saved it.

Captura de pantalla

Conecta tu asistente #

1. Crea un acceso dedicado para este asistente (un token por cada herramienta que conectes).
2. Añade la conexión HTTP MCP en tu asistente, con el endpoint y el token (pasos exactos abajo).
3. Pregúntale qué puede ver, para comprobar que los permisos son correctos.
4. Trabaja en borradores: deja que prepare cambios, pruébalos y luego publícalos.

Los mismos pasos, con el endpoint, encabezado y configuración listos para copiar, están en Connect your assistant al final de la página API & MCP. En cada ejemplo abajo, reemplaza la URL por la de tu espacio de trabajo (Copy URL) y YOUR_MCP_TOKEN por tu token.

Claude Code #

Un comando en tu terminal:

claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Luego escribe /mcp en Claude Code: lanachat aparece como conectado, con sus herramientas.

Cursor #

Añade esto a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto), luego activa lanachat en Settings › MCP:

{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

VS Code (GitHub Copilot) #

Añade esto a .vscode/mcp.json en tu proyecto:

{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Claude Desktop #

Claude Desktop inicia servidores locales desde su archivo de configuración, así que accede a LanaChat a través del pequeño puente mcp-remote (Node.js 18 o superior). Abre Settings › Developer › Edit Config y añade:

{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Reinicia Claude Desktop; las herramientas de LanaChat aparecen en el menú de herramientas de un chat nuevo.

ChatGPT y otros asistentes #

Cualquier cliente MCP que pueda enviar un encabezado en una conexión HTTP funciona con la configuración anterior. Los conectores web que solo ofrecen inicio de sesión OAuth (conectores ChatGPT, conectores personalizados en claude.ai) no pueden enviar un token de acceso, por lo que aún no pueden conectarse.

Comprobar la conexión #

El Inspector MCP lista las herramientas que tu token abre, sin necesidad de un asistente:

npx @modelcontextprotocol/inspector

Elige Streamable HTTP, pega el endpoint, añade el encabezado Authorization: Bearer YOUR_MCP_TOKEN, luego Connect y List tools.

Gestionar tokens #

La tabla Access tokens muestra los permisos, expiración y estado de cada token. Usa Edit, Rotate (o Renew) y Revoke. Show revoked tokens lista los antiguos.

El endpoint MCP #

La URL exacta de tu espacio de trabajo aparece en la parte superior de la página API & MCP (Copy URL). El token va en el encabezado Authorization, igual que en la API. Una configuración cliente se ve así:

{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Herramientas que obtiene el asistente #

El asistente solo ve las herramientas que su token permite. Una herramienta que no puede usar no aparece en la lista. Al conectarse, el servidor envía los argumentos exactos de cada herramienta (nombre, tipo, obligatorio) al asistente, para que nunca los tengas que escribir tú. La última columna es el endpoint API que hace lo mismo, donde sus parámetros están documentados.

Qué pedirle #

Háblale como a un colega que conoce la Console. Algunos comandos que funcionan bien:

• "Lista mis creadoras y dime cuáles tienen configuración pendiente."
• "Lee la persona de Lea y sugiere tres respuestas de banco de frases para fans que preguntan si es real. No guardes nada."
• "Redacta un guion de recuperación para Lea: tres pasos en dos días, el último un set pagado de 250 Stars. Déjalo inactivo."
• "Sube las fotos de esta carpeta al Vault de Lea, en una carpeta llamada Beach, y sugiere una descripción para cada una."
• "Cambia el borrador del brain de Lea para que la primera oferta llegue tras 6 mensajes, pruébalo en el Playground con un fan que hable inglés, y muéstrame las respuestas antes de publicar."
• "¿Cuánto vendió cada creadora ayer, y qué enlace de seguimiento trajo más compradores esta semana?"

Endpoints de tokens #

La página anterior llama a estas rutas; la guía del equipo lista las mismas acciones en la API pública (/v1/tokens).

Estas rutas de Console reciben y devuelven los permisos como campos booleanos (can_setup, can_engine, can_publish, can_ai_test, can_ai_tune, can_ai_publish, can_commercial_reports, can_fan_read, can_fan_import, can_sales_read). Crear un token responde { "token": "…", "grant": { … } }: token es el secreto, mostrado una vez; grant es el acceso con su id, name, scope, enabled, created y expires (segundos Unix). Rotar revoca el acceso antiguo y responde un nuevo token y grant. Un nombre faltante responde 400, un id desconocido 404, un acceso revocado 409.

Más en la página de la función API y MCP.