Usa Elido in Claude Desktop e Cursor

Elido fornisce un server Model Context Protocol (MCP) come programma locale. Gira sul tuo computer, chiama l'API REST di Elido con la tua chiave API e parla con il client via stdio. Non esistono un URL MCP ospitato né un connettore OAuth: non puoi incollare l'URL di un server nella schermata Connectors di Claude.

Passo 1: compila il server

Da una copia del repository di Elido esegui i comandi sotto. Generano packages/mcp-server/dist/index.js; annota il percorso assoluto.

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

Passo 2: crea una chiave API

1. Apri Dashboard → API Keys → New key.
2. Scegli i permessi (links:read e analytics:read per la sola lettura, più links:write per creare link).
3. Copia la chiave. Viene inviata all'API come 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"
      }
    }
  }
}

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) e riavvia completamente Claude Desktop.

Cursor

Aggiungi lo stesso blocco mcpServers in .cursor/mcp.json del progetto (o ~/.cursor/mcp.json per tutti) e riavvia Cursor.

Claude Code

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

Esegui claude mcp list per verificare che il server sia connesso.

Strumenti disponibili

Strumento	Cosa fa
create_link	Accorcia un URL con slug, dominio, titolo e tag facoltativi
list_links	Elenca i link recenti dello spazio di lavoro
query_analytics	Serie temporale dei clic per lo spazio o un link, con fuso orario
generate_qr	QR code (SVG o PNG) per un link esistente
list_workspaces	Elenca gli spazi di lavoro accessibili alla chiave API

Variabili d'ambiente: ELIDO_API_KEY (obbligatoria), ELIDO_WORKSPACE_ID (facoltativa se la chiave vede più spazi), ELIDO_API_BASE (predefinita https://api.elido.app, da cambiare per il self-hosting).

Risoluzione dei problemi

Il client mostra il server come in errore. Verifica che il percorso in args sia assoluto e che dist/index.js esista (ripeti la compilazione). Esegui ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js in un terminale per vedere gli errori di avvio.

«Unauthorized». La chiave manca, è errata o è stata revocata. Creane una nuova in Dashboard → API Keys.

La creazione di un link restituisce «forbidden». Alla chiave manca links:write.