Usar Elido en Claude Desktop y Cursor

Elido expone un servidor MCP (Model Context Protocol) en https://api.elido.app/mcp. Una vez conectado, Claude o Cursor pueden leer sus análisis de enlaces, acortar URLs y buscar detalles de enlaces — directamente desde el chat o el editor.

Qué le ofrece MCP#

• Pregunte "¿Cuántos clics obtuvo spring-2026 esta semana?" — Claude consulta Elido y responde con el número real.
• Diga "Acorta https://example.com/very-long-path con la etiqueta newsletter" — Claude crea el enlace y le muestra la URL corta.
• En Cursor, describa un lanzamiento y pida que "cree un enlace corto para la publicación del blog del lanzamiento" — lo acorta inline.

El acceso de solo lectura es el predeterminado. El acceso de escritura (crear, actualizar enlaces) requiere que lo active durante la autorización.

Paso 1 — Genere un token de API de Elido#

1. Vaya a Dashboard → API Keys → New key.
2. Elija los scopes:
   • links:read analytics:read para solo lectura.
   • Agregue links:write si desea que Claude pueda crear enlaces.
3. Copie el token (comienza con ek_).

Conectar en Claude Desktop#

Claude Desktop almacena la configuración del servidor MCP en ~/.claude.json (o en la interfaz de configuración en versiones más recientes).

Opción A — Interfaz de configuración (Claude Desktop 0.10+):

1. Abra Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Pegue la URL del servidor: https://api.elido.app/mcp
3. En Authentication, elija Bearer token y pegue su token de API de Elido.
4. Haga clic en Connect. Claude obtiene el manifiesto de herramientas (~2 segundos) y muestra las herramientas de Elido disponibles.

Opción B — Editar el archivo de configuración directamente:

Abra ~/.claude.json en un editor de texto y agregue una entrada en mcpServers:

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

Guarde el archivo. Reinicie Claude Desktop. El conector de Elido aparece en la lista de conectores.

Conectar en Cursor#

1. Abra Cursor → Settings → MCP (o Cmd/Ctrl + , → busque "MCP").
2. Haga clic en Add MCP server.
3. Server URL: https://api.elido.app/mcp
4. Auth header: Authorization: Bearer ek_your_token_here
5. Haga clic en Save. Cursor obtiene el manifiesto. Las herramientas disponibles aparecen en el panel MCP.

Alternativa — Claude Code CLI (para usuarios de terminal):

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

Esto agrega el servidor a su ~/.claude.json desde la línea de comandos. Configure ELIDO_TOKEN en su perfil de shell para que esté disponible en cada sesión.

Herramientas disponibles#

Herramienta	Scope requerido	Qué hace
list_links	links:read	Lista enlaces con filtros opcionales (etiqueta, dominio, búsqueda)
get_link	links:read	Devuelve un único enlace por slug o ID
get_analytics	analytics:read	Devuelve el recuento de clics y el desglose para un enlace
create_link	links:write	Crea un nuevo enlace corto
update_link	links:write	Actualiza el destino, slug, etiquetas o fecha de expiración

Las herramientas son de solo lectura por defecto. Crear y actualizar enlaces requiere el scope links:write en su token de API.

Alcance del acceso#

El servidor MCP solo expone datos del workspace al que pertenece el token de API. No puede acceder a otros workspaces. Si tiene varios workspaces, cree un token separado para cada uno y agregue múltiples entradas de servidor MCP con diferentes nombres (elido-workspace-a, elido-workspace-b).

Solución de problemas#

"Failed to fetch tool manifest" — La URL del servidor MCP es incorrecta o no está disponible. Confírmelo abriendo https://api.elido.app/mcp en un navegador — debería devolver un manifiesto JSON. Si obtiene un error de certificado, su red puede estar bloqueando TLS a api.elido.app.

"Unauthorized" al llamar a una herramienta — El token de API falta o es incorrecto en el encabezado Authorization. Verifique que el formato sea exactamente Authorization: Bearer ek_... (sin espacios adicionales, prefijo correcto).

Las herramientas aparecen pero las herramientas de escritura devuelven "forbidden" — Su token de API no tiene links:write. Genere un nuevo token con ese scope y actualice el encabezado en su configuración MCP.

Claude Desktop no muestra Elido en conectores después de editar la configuración — Reinicie Claude Desktop completamente (Quit, no solo cerrar la ventana). En macOS, compruebe la barra de menú para ver si hay una instancia de Claude en ejecución.

El panel MCP de Cursor muestra "disconnected" — Cursor vuelve a obtener el manifiesto en cada sesión. Si api.elido.app tarda en responder, Cursor puede agotar el tiempo de espera. Intente hacer clic en Reconnect en el panel MCP. Si el problema persiste, compruebe la página de estado de Elido.