Elido in Claude Desktop und Cursor verwenden

Elido stellt einen Model Context Protocol (MCP)-Server unter https://api.elido.app/mcp bereit. Nach der Verbindung kann Claude oder Cursor Ihre Link-Analytics lesen, URLs verkürzen und Link-Details nachschlagen — direkt aus dem Chat oder Editor.

Was MCP Ihnen bietet#

• Fragen Sie "Wie viele Klicks hatte spring-2026 diese Woche?" — Claude fragt Elido ab und antwortet mit der echten Zahl.
• Sagen Sie "Kürze https://example.com/very-long-path mit dem Tag newsletter" — Claude erstellt den Link und zeigt Ihnen die Kurz-URL.
• Beschreiben Sie in Cursor ein Release und bitten Sie es, "einen Kurzlink für den Release-Blog-Beitrag zu erstellen" — es kürzt inline.

Lesezugriff ist der Standard. Schreibzugriff (Links erstellen, aktualisieren) erfordert Ihre Zustimmung während der Autorisierung.

Schritt 1 — Einen Elido-API-Token generieren#

1. Gehen Sie zu Dashboard → API-Keys → Neuer Key.
2. Scopes auswählen:
   • links:read analytics:read für schreibgeschützten Zugriff.
   • links:write hinzufügen, wenn Sie möchten, dass Claude Links erstellen kann.
3. Den Token kopieren (beginnt mit ek_).

In Claude Desktop verbinden#

Claude Desktop speichert die MCP-Server-Konfiguration in ~/.claude.json (oder der Claude-Einstellungs-UI auf neueren Versionen).

Option A — Einstellungs-UI (Claude Desktop 0.10+):

1. Öffnen Sie Claude Desktop → Einstellungen → Connectors → Connector hinzufügen → Benutzerdefinierter MCP-Server.
2. Fügen Sie die Server-URL ein: https://api.elido.app/mcp
3. Wählen Sie unter Authentifizierung Bearer-Token und fügen Sie Ihren Elido-API-Token ein.
4. Klicken Sie auf Verbinden. Claude ruft das Tool-Manifest ab (~2 Sekunden) und zeigt die verfügbaren Elido-Tools.

Option B — Direkte Konfigurationsdatei bearbeiten:

Öffnen Sie ~/.claude.json in einem Texteditor und fügen Sie einen Eintrag unter mcpServers hinzu:

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

Speichern Sie die Datei. Starten Sie Claude Desktop neu. Der Elido-Connector erscheint in der Connector-Liste.

In Cursor verbinden#

1. Öffnen Sie Cursor → Einstellungen → MCP (oder Cmd/Ctrl + , → nach "MCP" suchen).
2. Klicken Sie auf MCP-Server hinzufügen.
3. Server-URL: https://api.elido.app/mcp
4. Auth-Header: Authorization: Bearer ek_your_token_here
5. Klicken Sie auf Speichern. Cursor ruft das Manifest ab. Verfügbare Tools erscheinen im MCP-Panel.

Alternative — Claude Code CLI (für Terminal-Benutzer):

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

Damit wird der Server zu Ihrer ~/.claude.json von der Kommandozeile hinzugefügt. Setzen Sie ELIDO_TOKEN in Ihrem Shell-Profil, damit es in jeder Sitzung verfügbar ist.

Verfügbare Tools#

Tool	Erforderlicher Scope	Was es tut
list_links	links:read	Listet Links mit optionalen Filtern (Tag, Domain, Suche) auf
get_link	links:read	Gibt einen einzelnen Link nach Slug oder ID zurück
get_analytics	analytics:read	Gibt Klickanzahl + Aufschlüsselung für einen Link zurück
create_link	links:write	Erstellt einen neuen Kurzlink
update_link	links:write	Aktualisiert Destination, Slug, Tags oder Ablauf

Tools sind standardmäßig schreibgeschützt. Das Erstellen und Aktualisieren von Links erfordert den links:write-Scope in Ihrem API-Token.

Zugriffsbereich#

Der MCP-Server zeigt nur Daten aus dem Workspace an, dem der API-Token gehört. Er kann nicht auf andere Workspaces zugreifen. Wenn Sie mehrere Workspaces haben, erstellen Sie für jeden einen separaten Token und fügen Sie mehrere MCP-Server-Einträge mit unterschiedlichen Namen hinzu (elido-workspace-a, elido-workspace-b).

Fehlerbehebung#

"Tool-Manifest konnte nicht abgerufen werden" — Die MCP-Server-URL ist falsch oder nicht erreichbar. Bestätigen Sie, indem Sie https://api.elido.app/mcp in einem Browser öffnen — es sollte ein JSON-Manifest zurückgeben. Wenn Sie einen Zertifikatsfehler erhalten, blockiert Ihr Netzwerk möglicherweise TLS zu api.elido.app.

"Unauthorized" beim Aufrufen eines Tools — Der API-Token fehlt oder ist im Authorization-Header falsch. Überprüfen Sie, ob das Header-Format genau Authorization: Bearer ek_... ist (keine zusätzlichen Leerzeichen, korrektes Präfix).

Tools erscheinen, aber Schreib-Tools geben "forbidden" zurück — Ihr API-Token hat kein links:write. Generieren Sie einen neuen Token mit diesem Scope und aktualisieren Sie den Header in Ihrer MCP-Konfiguration.

Claude Desktop zeigt Elido nach der Konfigurationsbearbeitung nicht in den Connectors — Starten Sie Claude Desktop vollständig neu (Beenden, nicht nur das Fenster schließen). Überprüfen Sie auf macOS die Menüleiste auf eine laufende Claude-Instanz.

Cursor-MCP-Panel zeigt "getrennt" — Cursor ruft das Manifest bei jeder Sitzung erneut ab. Wenn api.elido.app langsam antwortet, kann Cursor eine Zeitüberschreitung haben. Versuchen Sie, im MCP-Panel auf Erneut verbinden zu klicken. Wenn das Problem bestehen bleibt, überprüfen Sie die Statusseite von Elido.