Elido in Claude Desktop und Cursor verwenden

Elido liefert einen Model-Context-Protocol-Server (MCP) als lokales Programm. Er läuft auf Ihrem Rechner, spricht mit Ihrem API-Schlüssel die Elido-REST-API an und kommuniziert per stdio mit Ihrem Client. Es gibt keine gehostete MCP-URL und keinen OAuth-Connector: Eine Server-URL lässt sich nicht in den Claude-Bildschirm Connectors einfügen.

Schritt 1: Server bauen

Führen Sie in einem Checkout des Elido-Repositorys die Befehle unten aus. Sie erzeugen packages/mcp-server/dist/index.js; merken Sie sich den absoluten Pfad.

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

Schritt 2: API-Schlüssel erstellen

1. Öffnen Sie Dashboard → API Keys → New key.
2. Wählen Sie die Berechtigungen (links:read und analytics:read für Lesezugriff, dazu links:write zum Erstellen von Links).
3. Kopieren Sie den Schlüssel. Er wird als Authorization: Bearer … an die API gesendet.

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"
      }
    }
  }
}

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) und starten Sie Claude Desktop vollständig neu.

Cursor

Fügen Sie denselben mcpServers-Block in .cursor/mcp.json Ihres Projekts (oder ~/.cursor/mcp.json für alle Projekte) ein und starten Sie Cursor neu.

Claude Code

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

Mit claude mcp list prüfen Sie, ob der Server verbunden ist.

Verfügbare Tools

Tool	Funktion
create_link	Kürzt eine URL mit optionalem Slug, Domain, Titel und Tags
list_links	Listet die letzten Links des Workspace
query_analytics	Klick-Zeitreihe für Workspace oder Link, zeitzonenbewusst
generate_qr	QR-Code (SVG oder PNG) für einen bestehenden Link
list_workspaces	Listet die Workspaces, auf die der API-Schlüssel zugreifen kann

Umgebungsvariablen: ELIDO_API_KEY (erforderlich), ELIDO_WORKSPACE_ID (optional, wenn der Schlüssel mehrere Workspaces sieht), ELIDO_API_BASE (Standard https://api.elido.app, für Self-Hosting anpassen).

Fehlerbehebung

Der Client zeigt den Server als fehlgeschlagen. Prüfen Sie, ob der Pfad in args absolut ist und dist/index.js existiert (Build wiederholen). Starten Sie ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js im Terminal, um Startfehler zu sehen.

„Unauthorized“. Der Schlüssel fehlt, ist falsch oder widerrufen. Erstellen Sie unter Dashboard → API Keys einen neuen.

Link-Erstellung liefert „forbidden“. Dem Schlüssel fehlt links:write.