Saltar al contenidoleitvik

Documentación

Conectar un asistente

Todos los asistentes se conectan al mismo endpoint. Claude y ChatGPT entran con OAuth; Cursor, Grok Bot y los clientes que se configuran con cabecera usan un token de API.

Antes de empezar

  • Tienes que ser propietario o admin del espacio de Leitvik que quieres conectar.
  • Este es el endpoint: https://app.leitvik.com/api/mcp
  • Decide qué puede cambiar el asistente. Empieza con permisos de lectura y añade escrituras más adelante.

Claude

OAuthPendiente de verificación en vivo

Conector personalizado con OAuth.

  1. En Claude, añade un conector personalizado con la URL https://app.leitvik.com/api/mcp. Deja vacíos el client ID y el secreto.
  2. Claude abre Leitvik en el navegador. Inicia sesión si te lo pide: para autorizar hace falta haber entrado en los últimos diez minutos.
  3. Elige el espacio y qué puede hacer Claude en él. Las lecturas vienen marcadas; activa solo las escrituras que necesite.
  4. Pídele a Claude que use leitvik_context y comprueba el nombre del espacio.

ChatGPT

OAuthPendiente de verificación en vivo

Conector en modo desarrollador, con OAuth.

  1. En ChatGPT, con el modo desarrollador activado, crea un conector con la URL https://app.leitvik.com/api/mcp y autenticación OAuth. Deja vacíos el client ID y el secreto.
  2. ChatGPT abre Leitvik en el navegador. Inicia sesión si te lo pide.
  3. Elige el espacio y los permisos, y confirma.
  4. Pídele a ChatGPT que use leitvik_context y comprueba el nombre del espacio.

Cursor

Token de APIPendiente de verificación en vivo

Configuración MCP con un token en la cabecera Bearer.

  1. Crea un token de API en Ajustes > Tokens de API con los permisos que vaya a necesitar Cursor.
  2. Define dos variables de entorno donde se ejecute Cursor: LEITVIK_URL con https://app.leitvik.com (sin barra final) y LEITVIK_TOKEN con el token.
  3. Añade este servidor a tu .cursor/mcp.json o a tu configuración MCP de usuario, sin borrar los que ya tengas.
  4. Pídele al agente que use leitvik_context.
.cursor/mcp.json
{
  "mcpServers": {
    "leitvik": {
      "url": "${env:LEITVIK_URL}/api/mcp",
      "headers": { "Authorization": "Bearer ${env:LEITVIK_TOKEN}" }
    }
  }
}

Cursor sustituye ${env:…} con las variables de entorno del cliente en marcha. Un servidor remoto no puede usar la opción envFile, que es solo para stdio.

Grok Bot

Token de APIPendiente de verificación en vivo

Servidor MCP personalizado añadido desde el chat, con un token en la cabecera Bearer.

  1. Crea un token de API en Ajustes > Tokens de API. Para el día a día, marca los permisos de lectura y además tasks:write, opportunities:write y captures:write.
  2. En un chat de Grok Bot, pide: «Add a custom MCP server called leitvik at https://app.leitvik.com/api/mcp».
  3. Cuando te pida la autenticación, indica Authorization como nombre de la cabecera y Bearer qre_… con tu token como valor. No pegues el token en ningún otro punto de la conversación.
  4. Pídele a Grok que use leitvik_context y confirma el espacio. Mantén la aprobación por herramienta en las escrituras hasta que veas cómo se comporta.

Grok Bot funciona en un ordenador en la nube, así que necesita el endpoint público por HTTPS. El paso de la cabecera sale de una guía de terceros; no hemos encontrado una página oficial de xAI que lo explique.

Otros clientes MCP

Pendiente de verificación en vivo

Cualquier cliente que admita servidores remotos por Streamable HTTP.

URL
https://app.leitvik.com/api/mcp
Transporte
Streamable HTTP (sin estado, respuestas JSON)
Autenticación
OAuth 2.1 con descubrimiento, o la cabecera Authorization: Bearer qre_…

Después de conectar

  • Comprueba el espacio con leitvik_context antes de trabajar con datos del CRM.
  • Usa una credencial distinta para cada asistente, así puedes retirar cada una por separado.
  • Para desconectar, revoca el token o la aplicación conectada en Ajustes > Tokens de API.