Integraciones
Servidor MCP para Claude, ChatGPT y n8n
Un endpoint remoto de Model Context Protocol para que los asistentes puedan listar enlaces, leer visitas y crear URL con seguimiento.
Los espacios de trabajo Ultimate exponen un servidor remoto de Model Context Protocol en https://letl.ink/mcp. Claude, ChatGPT y el MCP Client de n8n hablan JSON-RPC sobre Streamable HTTP. El token es el mismo token de API que el de la API REST. Los espacios de trabajo en Free, Solo o Growth reciben 403 en /mcp aunque ya tengan un token por otros motivos.
Protocolo y autenticación
- Versión del protocolo
2025-03-26. - Métodos:
initialize,ping,tools/list,tools/call.resources/listyprompts/listdevuelven listas vacías. - Autentícate con
Authorization: Bearer YOUR_TOKENoX-API-KEY: YOUR_TOKEN. - Los propietarios y administradores generan el token en Integraciones → MCP. Regenerarlo desconecta todos los clientes MCP a la vez.
Conectar Claude
- En Claude, abre Settings → Connectors → Add custom connector.
- URL:
https://letl.ink/mcp. - Encabezado de autenticación:
Authorization: Bearermás tu token. - Una vez conectado, pídele a Claude que resuma el espacio de trabajo, liste enlaces o cree una URL corta con seguimiento.
Conectar ChatGPT
- En ChatGPT, abre Settings → Connectors → MCP.
- Usa la misma URL y el mismo token Bearer.
- Algunos espacios de trabajo de ChatGPT requieren el modo desarrollador para que aparezcan los servidores MCP personalizados. Si falta el conector, revisa primero esa opción.
Conectar n8n
Nodo MCP Client → transporte Streamable HTTP → URL https://letl.ink/mcp → encabezado Authorization: Bearer YOUR_TOKEN. Los detalles y las otras dos vías de n8n están en el artículo de n8n.
Herramientas
| Herramienta | Qué devuelve / hace |
|---|---|
| workspace_summary | Nombre del espacio de trabajo, plan, enlaces usados/máximo, clics de este mes natural, dominios, códigos QR, días de retención, si la geolocalización y la API están activas, y si Bloquear bots está activado |
| list_links | Enlaces activos (limit opcional, 50 por defecto, máximo 200) |
| get_link | Un enlace por id numérico o short_code |
| get_recent_visits | Últimos clics registrados (limit opcional, 25 por defecto, máximo 100), con país |
| create_link | Crea un enlace con seguimiento. type puede ser direct, utm, appstore, instagram, mobile o device. Los tipos inteligentes dependen del plan; las URL de destino, UTM y tiendas coinciden con el cuerpo de creación de la REST |
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": { "name": "docs", "version": "1" }
}
}
Qué se le indica al modelo
Al inicializarse, el servidor se identifica como letlink e indica a los clientes que consulten y creen enlaces cortos con seguimiento para este espacio de trabajo, incluidos los campos geográficos. Las herramientas devuelven JSON como contenido de texto y como structuredContent, para que los clientes que entienden resultados estructurados no tengan que analizarlo.
Seguridad
Trata a un asistente conectado como a un compañero con acceso a la API: puede leer registros de visitas (incluida la IP en algunos payloads de visitas) y crear enlaces que cuentan para los límites. No pegues el token Bearer en un chat. Desactiva el conector y rota el token si ya no necesitas un cliente.