Utiliser Elido dans Claude Desktop et Cursor

Elido expose un serveur Model Context Protocol (MCP) à https://api.elido.app/mcp. Une fois connecté, Claude ou Cursor peut lire vos analyses de liens, raccourcir des URL et rechercher des détails de liens — directement depuis le chat ou l'éditeur.

Ce que MCP vous offre#

• Demandez "Combien de clics spring-2026 a-t-il eus cette semaine ?" — Claude interroge Elido et répond avec le vrai nombre.
• Dites "Raccourcis https://example.com/very-long-path avec le tag newsletter" — Claude crée le lien et vous montre l'URL courte.
• Dans Cursor, décrivez une version et demandez-lui de "créer un lien court pour le billet de blog de la version" — il raccourcit en ligne.

L'accès en lecture seule est le comportement par défaut. L'accès en écriture (créer, mettre à jour des liens) nécessite votre accord lors de l'autorisation.

Étape 1 — Générer un jeton API Elido#

1. Allez dans Dashboard → Clés API → Nouvelle clé.
2. Choisissez les portées :
   • links:read analytics:read pour la lecture seule.
   • Ajoutez links:write si vous souhaitez que Claude puisse créer des liens.
3. Copiez le jeton (commence par ek_).

Connecter dans Claude Desktop#

Claude Desktop stocke la configuration du serveur MCP dans ~/.claude.json (ou l'interface de paramètres Claude sur les versions récentes).

Option A — Interface de paramètres (Claude Desktop 0.10+) :

1. Ouvrez Claude Desktop → Paramètres → Connecteurs → Ajouter un connecteur → Serveur MCP personnalisé.
2. Collez l'URL du serveur : https://api.elido.app/mcp
3. Sous Authentification, choisissez Jeton Bearer et collez votre jeton API Elido.
4. Cliquez sur Connecter. Claude récupère le manifeste des outils (~2 secondes) et affiche les outils Elido disponibles.

Option B — Édition directe du fichier de configuration :

Ouvrez ~/.claude.json dans un éditeur de texte et ajoutez une entrée sous mcpServers :

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

Enregistrez le fichier. Redémarrez Claude Desktop. Le connecteur Elido apparaît dans la liste des connecteurs.

Connecter dans Cursor#

1. Ouvrez Cursor → Paramètres → MCP (ou Cmd/Ctrl + , → rechercher "MCP").
2. Cliquez sur Ajouter un serveur MCP.
3. URL du serveur : https://api.elido.app/mcp
4. En-tête d'authentification : Authorization: Bearer ek_your_token_here
5. Cliquez sur Enregistrer. Cursor récupère le manifeste. Les outils disponibles apparaissent dans le panneau MCP.

Alternative — Claude Code CLI (pour les utilisateurs du terminal) :

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

Cela ajoute le serveur à votre ~/.claude.json depuis la ligne de commande. Définissez ELIDO_TOKEN dans votre profil shell pour qu'il soit disponible à chaque session.

Outils disponibles#

Outil	Portée requise	Ce qu'il fait
list_links	links:read	Liste les liens avec des filtres optionnels (tag, domaine, recherche)
get_link	links:read	Retourne un seul lien par slug ou ID
get_analytics	analytics:read	Retourne le compteur de clics + décomposition pour un lien
create_link	links:write	Crée un nouveau lien court
update_link	links:write	Met à jour la destination, le slug, les tags ou l'expiration

Les outils sont en lecture seule par défaut. La création et la mise à jour de liens nécessitent la portée links:write sur votre jeton API.

Portée d'accès#

Le serveur MCP ne présente que les données du workspace auquel appartient le jeton API. Il ne peut pas accéder aux autres workspaces. Si vous avez plusieurs workspaces, créez un jeton séparé pour chacun et ajoutez plusieurs entrées de serveur MCP avec des noms différents (elido-workspace-a, elido-workspace-b).

Résolution des problèmes#

"Échec de récupération du manifeste d'outils" — L'URL du serveur MCP est incorrecte ou inaccessible. Confirmez en ouvrant https://api.elido.app/mcp dans un navigateur — il devrait retourner un manifeste JSON. Si vous obtenez une erreur de certificat, votre réseau bloque peut-être TLS vers api.elido.app.

"Unauthorized" lors de l'appel d'un outil — Le jeton API est manquant ou incorrect dans l'en-tête Authorization. Vérifiez que le format de l'en-tête est exactement Authorization: Bearer ek_... (pas d'espaces supplémentaires, préfixe correct).

Les outils apparaissent mais les outils d'écriture retournent "forbidden" — Votre jeton API n'a pas links:write. Générez un nouveau jeton avec cette portée et mettez à jour l'en-tête dans votre configuration MCP.

Claude Desktop ne montre pas Elido dans les connecteurs après l'édition de la configuration — Redémarrez Claude Desktop complètement (Quitter, pas seulement fermer la fenêtre). Sur macOS, vérifiez la barre de menus pour une instance Claude en cours d'exécution.

Le panneau MCP de Cursor affiche "déconnecté" — Cursor récupère le manifeste à chaque session. Si api.elido.app est lent à répondre, Cursor peut expirer. Essayez de cliquer sur Reconnecter dans le panneau MCP. Si le problème persiste, vérifiez la page de statut d'Elido.