Usa Elido in Claude Desktop e Cursor

Elido espone un server Model Context Protocol (MCP) su https://api.elido.app/mcp. Una volta connesso, Claude o Cursor possono leggere le tue analisi dei link, abbreviare URL e cercare dettagli sui link — direttamente dalla chat o dall'editor.

Cosa ti dà MCP#

• Chiedi "Quanti clic ha ricevuto spring-2026 questa settimana?" — Claude interroga Elido e risponde con il numero reale.
• Dì "Abbrevia https://example.com/very-long-path con il tag newsletter" — Claude crea il link e mostra l'URL abbreviato.
• In Cursor, descrivi un rilascio e chiedigli di "creare un link abbreviato per il post del blog sul rilascio" — abbrevia inline.

L'accesso in sola lettura è il default. L'accesso in scrittura (crea, aggiorna link) richiede che tu ti attivi durante l'autorizzazione.

Step 1 — Genera un token API Elido#

1. Vai su Dashboard → API Keys → Nuova chiave.
2. Scegli gli scope:
   • links:read analytics:read per sola lettura.
   • Aggiungi links:write se vuoi che Claude possa creare link.
3. Copia il token (inizia con ek_).

Connetti in Claude Desktop#

Claude Desktop conserva la configurazione del server MCP in ~/.claude.json (o nell'interfaccia delle impostazioni Claude nelle versioni più recenti).

Opzione A — Interfaccia Impostazioni (Claude Desktop 0.10+):

1. Apri Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Incolla l'URL del server: https://api.elido.app/mcp
3. Sotto Authentication, scegli Bearer token e incolla il tuo token API Elido.
4. Fai clic su Connect. Claude recupera il manifest degli strumenti (~2 secondi) e mostra gli strumenti Elido disponibili.

Opzione B — Modifica diretta del file di configurazione:

Apri ~/.claude.json in un editor di testo e aggiungi una voce sotto mcpServers:

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

Salva il file. Riavvia Claude Desktop. Il connettore Elido appare nella lista dei connettori.

Connetti in Cursor#

1. Apri Cursor → Settings → MCP (o Cmd/Ctrl + , → cerca "MCP").
2. Fai clic su Add MCP server.
3. URL server: https://api.elido.app/mcp
4. Header auth: Authorization: Bearer ek_your_token_here
5. Fai clic su Save. Cursor recupera il manifest. Gli strumenti disponibili appaiono nel pannello MCP.

Alternativa — Claude Code CLI (per utenti terminale):

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

Questo aggiunge il server al tuo ~/.claude.json dalla riga di comando. Imposta ELIDO_TOKEN nel tuo profilo shell per averlo disponibile in ogni sessione.

Strumenti disponibili#

Strumento	Scope richiesto	Cosa fa
list_links	links:read	Elenca link con filtri opzionali (tag, dominio, ricerca)
get_link	links:read	Restituisce un singolo link per slug o ID
get_analytics	analytics:read	Restituisce conteggio clic + dettaglio per un link
create_link	links:write	Crea un nuovo link abbreviato
update_link	links:write	Aggiorna destinazione, slug, tag o scadenza

Gli strumenti sono di sola lettura per default. Creare e aggiornare link richiede lo scope links:write sul tuo token API.

Scope di accesso#

Il server MCP espone solo i dati del workspace a cui appartiene il token API. Non può accedere ad altri workspace. Se hai più workspace, crea un token separato per ognuno e aggiungi più voci del server MCP con nomi diversi (elido-workspace-a, elido-workspace-b).

Risoluzione dei problemi#

"Failed to fetch tool manifest" — L'URL del server MCP è errato o irraggiungibile. Conferma aprendo https://api.elido.app/mcp in un browser — dovrebbe restituire un manifest JSON. Se ricevi un errore del certificato, la tua rete potrebbe stare bloccando TLS su api.elido.app.

"Unauthorized" durante la chiamata di uno strumento — Il token API è mancante o errato nell'header Authorization. Verifica che il formato dell'header sia esattamente Authorization: Bearer ek_... (nessuno spazio extra, prefisso corretto).

Gli strumenti appaiono ma gli strumenti di scrittura restituiscono "forbidden" — Il tuo token API non ha links:write. Genera un nuovo token con quello scope e aggiorna l'header nella tua configurazione MCP.

Claude Desktop non mostra Elido nei connettori dopo la modifica del config — Riavvia completamente Claude Desktop (Esci, non solo chiudi la finestra). Su macOS, controlla la barra dei menu per un'istanza Claude in esecuzione.

Il pannello MCP di Cursor mostra "disconnected" — Cursor recupera il manifest ad ogni sessione. Se api.elido.app risponde lentamente, Cursor potrebbe andare in timeout. Prova a fare clic su Reconnect nel pannello MCP. Se il problema persiste, controlla la pagina di stato di Elido.