Utiliser Elido dans Claude Desktop et Cursor

Elido fournit un serveur Model Context Protocol (MCP) sous forme de programme local. Il s'exécute sur votre machine, appelle l'API REST d'Elido avec votre clé API et dialogue avec votre client en stdio. Il n'existe ni URL MCP hébergée ni connecteur OAuth : vous ne pouvez pas coller une URL de serveur dans l'écran Connectors de Claude.

Étape 1 : compiler le serveur

Depuis une copie du dépôt Elido, exécutez les commandes ci-dessous. Elles produisent packages/mcp-server/dist/index.js ; notez le chemin absolu.

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

Étape 2 : créer une clé API

1. Ouvrez Dashboard → API Keys → New key.
2. Choisissez les permissions (links:read et analytics:read en lecture seule, plus links:write pour créer des liens).
3. Copiez la clé. Elle est envoyée à l'API sous la forme Authorization: Bearer ….

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

Modifiez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows), puis redémarrez complètement Claude Desktop.

Cursor

Ajoutez le même bloc mcpServers dans .cursor/mcp.json de votre projet (ou ~/.cursor/mcp.json pour tous les projets) et redémarrez Cursor.

Claude Code

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

Lancez claude mcp list pour vérifier que le serveur est connecté.

Outils disponibles

Outil	Fonction
create_link	Raccourcit une URL avec slug, domaine, titre et tags facultatifs
list_links	Liste les liens récents de l'espace de travail
query_analytics	Série temporelle de clics pour l'espace ou un lien, avec fuseau horaire
generate_qr	QR code (SVG ou PNG) pour un lien existant
list_workspaces	Liste les espaces de travail accessibles à la clé API

Variables d'environnement : ELIDO_API_KEY (obligatoire), ELIDO_WORKSPACE_ID (facultative si la clé voit plusieurs espaces), ELIDO_API_BASE (par défaut https://api.elido.app, à modifier pour l'auto-hébergement).

Dépannage

Le client affiche le serveur en échec. Vérifiez que le chemin dans args est absolu et que dist/index.js existe (relancez la compilation). Exécutez ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js dans un terminal pour voir les erreurs de démarrage.

« Unauthorized ». La clé est absente, erronée ou révoquée. Créez-en une nouvelle dans Dashboard → API Keys.

La création de lien renvoie « forbidden ». La clé n'a pas links:write.