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
Conector personalizado con OAuth.
- 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. - Claude abre Leitvik en el navegador. Inicia sesión si te lo pide: para autorizar hace falta haber entrado en los últimos diez minutos.
- Elige el espacio y qué puede hacer Claude en él. Las lecturas vienen marcadas; activa solo las escrituras que necesite.
- Pídele a Claude que use
leitvik_contexty comprueba el nombre del espacio.
ChatGPT
Conector en modo desarrollador, con OAuth.
- En ChatGPT, con el modo desarrollador activado, crea un conector con la URL
https://app.leitvik.com/api/mcpy autenticación OAuth. Deja vacíos el client ID y el secreto. - ChatGPT abre Leitvik en el navegador. Inicia sesión si te lo pide.
- Elige el espacio y los permisos, y confirma.
- Pídele a ChatGPT que use
leitvik_contexty comprueba el nombre del espacio.
Cursor
Configuración MCP con un token en la cabecera Bearer.
- Crea un token de API en Ajustes > Tokens de API con los permisos que vaya a necesitar Cursor.
- Define dos variables de entorno donde se ejecute Cursor:
LEITVIK_URLconhttps://app.leitvik.com(sin barra final) yLEITVIK_TOKENcon el token. - Añade este servidor a tu
.cursor/mcp.jsono a tu configuración MCP de usuario, sin borrar los que ya tengas. - Pídele al agente que use
leitvik_context.
{
"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
Servidor MCP personalizado añadido desde el chat, con un token en la cabecera Bearer.
- 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:writeycaptures:write. - En un chat de Grok Bot, pide: «Add a custom MCP server called leitvik at
https://app.leitvik.com/api/mcp». - Cuando te pida la autenticación, indica
Authorizationcomo nombre de la cabecera yBearer qre_…con tu token como valor. No pegues el token en ningún otro punto de la conversación. - Pídele a Grok que use
leitvik_contexty 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
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_contextantes 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.