Folosiți Elido în Claude Desktop și Cursor

Elido expune un server Model Context Protocol (MCP) la https://api.elido.app/mcp. Odată conectat, Claude sau Cursor pot citi analizele linkurilor dumneavoastră, pot scurta URL-uri și pot căuta detalii despre linkuri — direct din chat sau din editor.

Ce vă oferă MCP

• Întrebați „Câte clicuri a primit spring-2026 săptămâna aceasta?” — Claude interoghează Elido și răspunde cu numărul real.
• Spuneți „Scurtează https://example.com/very-long-path cu tag-ul newsletter” — Claude creează linkul și vă arată URL-ul scurt.
• În Cursor, descrieți o lansare și cereți-i să „creeze un link scurt pentru articolul de blog al lansării” — îl scurtează direct în editor.

Accesul doar-citire este implicit. Accesul de scriere (creare, actualizare linkuri) necesită activare explicită în timpul autorizării.

Pasul 1 — Generați un token API Elido

1. Mergeți la Dashboard → API Keys → New key.
2. Alegeți permisiunile:
   • links:read analytics:read pentru doar-citire.
   • Adăugați links:write dacă doriți ca Claude să poată crea linkuri.
3. Copiați tokenul (începe cu ek_).

Conectare în Claude Desktop

Claude Desktop stochează configurația serverului MCP în ~/.claude.json (sau în interfața de setări Claude, în versiunile mai noi).

Opțiunea A — Interfața de setări (Claude Desktop 0.10+):

1. Deschideți Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Lipiți URL-ul serverului: https://api.elido.app/mcp
3. La Authentication, alegeți Bearer token și lipiți tokenul API Elido.
4. Faceți clic pe Connect. Claude preia manifestul de instrumente (~2 secunde) și afișează instrumentele Elido disponibile.

Opțiunea B — Editarea directă a fișierului de configurare:

Deschideți ~/.claude.json într-un editor de text și adăugați o intrare sub mcpServers:

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

Salvați fișierul. Reporniți Claude Desktop. Conectorul Elido apare în lista de conectori.

Conectare în Cursor

1. Deschideți Cursor → Settings → MCP (sau Cmd/Ctrl + , → căutați „MCP”).
2. Faceți clic pe Add MCP server.
3. URL server: https://api.elido.app/mcp
4. Header de autentificare: Authorization: Bearer ek_your_token_here
5. Faceți clic pe Save. Cursor preia manifestul. Instrumentele disponibile apar în panoul MCP.

Alternativă — Claude Code CLI (pentru utilizatorii de terminal):

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

Aceasta adaugă serverul în ~/.claude.json direct din linia de comandă. Setați ELIDO_TOKEN în profilul shell-ului dumneavoastră, astfel încât să fie disponibil în fiecare sesiune.

Instrumente disponibile

Instrument	Permisiune necesară	Ce face
list_links	links:read	Listează linkurile cu filtre opționale (tag, domeniu, căutare)
get_link	links:read	Returnează un singur link după slug sau ID
get_analytics	analytics:read	Returnează numărul de clicuri și defalcarea pentru un link
create_link	links:write	Creează un link scurt nou
update_link	links:write	Actualizează destinația, slug-ul, tag-urile sau expirarea

Instrumentele sunt doar-citire în mod implicit. Crearea și actualizarea linkurilor necesită permisiunea links:write pe tokenul dumneavoastră API.

Domeniul de acces

Serverul MCP expune date doar din workspace-ul căruia îi aparține tokenul API. Nu poate accesa alte workspace-uri. Dacă aveți mai multe workspace-uri, creați un token separat pentru fiecare și adăugați mai multe intrări de server MCP cu nume diferite (elido-workspace-a, elido-workspace-b).

Depanare

„Failed to fetch tool manifest” — URL-ul serverului MCP este greșit sau inaccesibil. Confirmați deschizând https://api.elido.app/mcp într-un browser — ar trebui să returneze un manifest JSON. Dacă primiți o eroare de certificat, rețeaua dumneavoastră poate bloca TLS către api.elido.app.

„Unauthorized” la apelarea unui instrument — Tokenul API lipsește sau este incorect în header-ul Authorization. Verificați că formatul header-ului este exact Authorization: Bearer ek_... (fără spații suplimentare, prefixul corect).

Instrumentele apar, dar cele de scriere returnează „forbidden” — Tokenul dumneavoastră API nu are links:write. Generați un token nou cu această permisiune și actualizați header-ul din configurația MCP.

Claude Desktop nu afișează Elido în conectori după editarea configurației — Reporniți complet Claude Desktop (Quit, nu doar închiderea ferestrei). Pe macOS, verificați bara de meniu pentru o instanță Claude care rulează încă.

Panoul MCP din Cursor arată „disconnected” — Cursor reîncarcă manifestul la fiecare sesiune. Dacă api.elido.app răspunde lent, Cursor poate expira timpul de așteptare. Încercați să faceți clic pe Reconnect în panoul MCP. Dacă problema persistă, verificați pagina de status a Elido.