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/list y prompts/list devuelven listas vacías.
  • Autentícate con Authorization: Bearer YOUR_TOKEN o X-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

  1. En Claude, abre Settings → Connectors → Add custom connector.
  2. URL: https://letl.ink/mcp.
  3. Encabezado de autenticación: Authorization: Bearer más tu token.
  4. Una vez conectado, pídele a Claude que resuma el espacio de trabajo, liste enlaces o cree una URL corta con seguimiento.

Conectar ChatGPT

  1. En ChatGPT, abre Settings → Connectors → MCP.
  2. Usa la misma URL y el mismo token Bearer.
  3. 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
initialize mínimo (después de HTTPS + Bearer)
{
  "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.

¿Todavía tienes preguntas?

Estamos aquí para ayudarte. Escríbenos y te responderemos lo antes posible.