Usar Elido en Claude Desktop y Cursor

Elido ofrece un servidor Model Context Protocol (MCP) como programa local. Se ejecuta en tu equipo, llama a la API REST de Elido con tu clave de API y habla con tu cliente por stdio. No hay URL MCP alojada ni conector OAuth: no puedes pegar una URL de servidor en la pantalla Connectors de Claude.

Paso 1: compila el servidor

Desde una copia del repositorio de Elido, ejecuta los comandos de abajo. Generan packages/mcp-server/dist/index.js; anota la ruta absoluta.

pnpm install
pnpm --filter @elido/mcp-server build

Paso 2: crea una clave de API

1. Abre Dashboard → API Keys → New key.
2. Elige los permisos (links:read y analytics:read para solo lectura, más links:write para crear enlaces).
3. Copia la clave. Se envía a la API como Authorization: Bearer ….

Claude Desktop

{
  "mcpServers": {
    "elido": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "ELIDO_API_KEY": "your_api_key",
        "ELIDO_WORKSPACE_ID": "42"
      }
    }
  }
}

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) y reinicia Claude Desktop por completo.

Cursor

Añade el mismo bloque mcpServers en .cursor/mcp.json de tu proyecto (o ~/.cursor/mcp.json para todos) y reinicia Cursor.

Claude Code

claude mcp add elido --env ELIDO_API_KEY=your_api_key -- \
  node /absolute/path/to/packages/mcp-server/dist/index.js

Ejecuta claude mcp list para confirmar que el servidor está conectado.

Herramientas disponibles

Herramienta	Qué hace
create_link	Acorta una URL con slug, dominio, título y etiquetas opcionales
list_links	Lista los enlaces recientes del espacio de trabajo
query_analytics	Serie temporal de clics del espacio o de un enlace, con zona horaria
generate_qr	Código QR (SVG o PNG) para un enlace existente
list_workspaces	Lista los espacios de trabajo accesibles con la clave de API

Variables de entorno: ELIDO_API_KEY (obligatoria), ELIDO_WORKSPACE_ID (opcional si la clave ve varios espacios), ELIDO_API_BASE (por defecto https://api.elido.app, cámbiala para self-hosting).

Solución de problemas

El cliente muestra el servidor como fallido. Comprueba que la ruta de args sea absoluta y que exista dist/index.js (repite la compilación). Ejecuta ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js en un terminal para ver errores de arranque.

«Unauthorized». Falta la clave, es incorrecta o está revocada. Crea una nueva en Dashboard → API Keys.

Crear un enlace devuelve «forbidden». A la clave le falta links:write.