Elido gebruiken in Claude Desktop en Cursor

Elido biedt een Model Context Protocol (MCP)-server aan op https://api.elido.app/mcp. Eenmaal verbonden kunnen Claude of Cursor je linkanalyses lezen, URL's inkorten en linkgegevens opzoeken — rechtstreeks vanuit de chat of editor.

Wat MCP je oplevert

• Vraag "Hoeveel klikken kreeg spring-2026 deze week?" — Claude bevraagt Elido en antwoordt met het echte aantal.
• Zeg "Kort https://example.com/very-long-path in met tag newsletter" — Claude maakt de link aan en toont je de korte URL.
• Beschrijf in Cursor een release en vraag om "een korte link te maken voor de release-blogpost" — het wordt inline ingekort.

Alleen-lezen toegang is de standaard. Schrijftoegang (links aanmaken, bijwerken) vereist dat je hiervoor kiest tijdens de autorisatie.

Stap 1 — Een Elido API-token genereren

1. Ga naar Dashboard → API-sleutels → Nieuwe sleutel.
2. Kies scopes:
   • links:read analytics:read voor alleen-lezen.
   • Voeg links:write toe als je wilt dat Claude links kan aanmaken.
3. Kopieer het token (begint met ek_).

Verbinden in Claude Desktop

Claude Desktop bewaart de MCP-serverconfiguratie in ~/.claude.json (of de Claude-instellingen-UI in nieuwere versies).

Optie A — Instellingen-UI (Claude Desktop 0.10+):

1. Open Claude Desktop → Instellingen → Connectoren → Connector toevoegen → Aangepaste MCP-server.
2. Plak de server-URL: https://api.elido.app/mcp
3. Kies bij Verificatie Bearer-token en plak je Elido API-token.
4. Klik op Verbinden. Claude haalt het toolmanifest op (~2 seconden) en toont de beschikbare Elido-tools.

Optie B — Configuratiebestand direct bewerken:

Open ~/.claude.json in een teksteditor en voeg een item toe onder mcpServers:

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

Sla het bestand op. Start Claude Desktop opnieuw. De Elido-connector verschijnt in de connectorenlijst.

Verbinden in Cursor

1. Open Cursor → Instellingen → MCP (of Cmd/Ctrl + , → zoek "MCP").
2. Klik op MCP-server toevoegen.
3. Server-URL: https://api.elido.app/mcp
4. Auth-header: Authorization: Bearer ek_your_token_here
5. Klik op Opslaan. Cursor haalt het manifest op. Beschikbare tools verschijnen in het MCP-paneel.

Alternatief — Claude Code CLI (voor terminalgebruikers):

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

Dit voegt de server vanaf de commandoregel toe aan je ~/.claude.json. Stel ELIDO_TOKEN in je shellprofiel in zodat het in elke sessie beschikbaar is.

Beschikbare tools

Tool	Vereiste scope	Wat het doet
list_links	links:read	Toont links met optionele filters (tag, domein, zoeken)
get_link	links:read	Retourneert een enkele link op basis van slug of ID
get_analytics	analytics:read	Retourneert het aantal klikken + uitsplitsing voor een link
create_link	links:write	Maakt een nieuwe korte link aan
update_link	links:write	Werkt bestemming, slug, tags of verlooptermijn bij

Tools zijn standaard alleen-lezen. Voor het aanmaken en bijwerken van links is de scope links:write vereist op je API-token.

Reikwijdte van toegang

De MCP-server toont alleen gegevens uit de workspace waartoe het API-token behoort. Hij heeft geen toegang tot andere workspaces. Als je meerdere workspaces hebt, maak dan voor elke workspace een apart token aan en voeg meerdere MCP-serveritems toe met verschillende namen (elido-workspace-a, elido-workspace-b).

Probleemoplossing

"Failed to fetch tool manifest" — De MCP-server-URL is onjuist of onbereikbaar. Controleer dit door https://api.elido.app/mcp in een browser te openen — dit moet een JSON-manifest teruggeven. Bij een certificaatfout blokkeert je netwerk mogelijk TLS naar api.elido.app.

"Unauthorized" bij het aanroepen van een tool — Het API-token ontbreekt of is onjuist in de Authorization-header. Controleer of het headerformaat exact Authorization: Bearer ek_... is (geen extra spaties, correct voorvoegsel).

Tools verschijnen, maar schrijftools geven "forbidden" terug — Je API-token heeft geen links:write. Genereer een nieuw token met die scope en werk de header in je MCP-configuratie bij.

Claude Desktop toont Elido niet bij connectoren na het bewerken van de configuratie — Start Claude Desktop volledig opnieuw op (Afsluiten, niet alleen het venster sluiten). Controleer op macOS de menubalk op een lopend Claude-exemplaar.

Het MCP-paneel van Cursor toont "disconnected" — Cursor haalt het manifest bij elke sessie opnieuw op. Als api.elido.app traag reageert, kan Cursor een time-out krijgen. Probeer op Reconnect te klikken in het MCP-paneel. Raadpleeg bij aanhoudende problemen de statuspagina van Elido.