Serveur MCP Linkly

Le serveur MCP Linkly vous permet de connecter des assistants IA à votre compte Linkly en utilisant le Model Context Protocol. Une fois connecté, vous pouvez créer et gérer des liens courts grâce à la conversation naturelle.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA de se connecter de manière sécurisée à des outils et sources de données externes. Au lieu de copier-coller entre les applications, vous pouvez demander à votre assistant IA d'effectuer des actions directement.

Assistants IA supportés

Le serveur MCP Linkly fonctionne avec :

• Claude Desktop
• ChatGPT Desktop
• Autres clients compatibles MCP (Cursor, Windsurf, etc.)

Où le trouver

Le serveur MCP Linkly est listé dans les principaux répertoires MCP, vous pouvez donc l'installer depuis n'importe quel endroit où vous cherchez des connecteurs :

• Répertoire de connecteurs Claude — connexion en un clic dans Claude (web et Desktop)
• Registre MCP officiel — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — le plugin Linkly pour Claude Code et Cowork
• Source sur GitHub — sous licence MIT

Serveur MCP ou CLI Linkly ?

Si votre assistant IA est un agent de codage capable d'exécuter des commandes shell — comme Claude Code ou Cursor — la CLI Linkly est souvent plus adaptée que le serveur MCP. Les agents de codage sont déjà habitués à utiliser des outils en ligne de commande, et la CLI leur fournit une sortie --json sur chaque commande plus une commande linkly schema qui affiche l'arborescence complète des commandes, afin que l'agent puisse découvrir tout ce qu'il peut faire. Le serveur MCP reste le meilleur choix pour les assistants qui ne peuvent pas exécuter de commandes shell, comme Claude Desktop et ChatGPT Desktop.

Ce que vous pouvez faire

Une fois connecté, vous pouvez demander à votre assistant IA de :

• Créer des liens courts - « Crée un lien court pour https://example.com »
• Suivre les performances - « Combien de clics mes liens ont-ils reçus cette semaine ? »
• Gérer les liens - « Mets à jour le lien appelé 'promo' avec une nouvelle destination »
• Afficher l'analytique - « Montre-moi les clics par pays pour les 30 derniers jours »
• Rechercher des liens - « Trouve tous les liens liés au lancement du produit »
• Gérer les domaines - « Liste mes domaines personnalisés »
• Configurer les webhooks - « Abonne https://my-site.com/webhook pour recevoir les événements de clics »

Commencer

Le serveur MCP Linkly hébergé se trouve à https://mcp.linklyhq.com. Il n'y a rien à installer et aucune clé API à copier — le serveur utilise OAuth, donc la première fois que votre assistant IA se connecte, une fenêtre de navigateur s'ouvre vous demandant de vous connecter à Linkly et d'approuver l'accès. Après cela, votre assistant reste connecté.

https://mcp.linklyhq.com

Configuration

Claude Desktop

Dans Claude Desktop, allez à Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Entrez un nom (Linkly) et l'URL du serveur MCP distant :

https://mcp.linklyhq.com

Cliquez sur Ajouter, puis Connecter sur le connecteur Linkly. Un onglet de navigateur s'ouvre pour vous permettre de vous connecter et d'approuver l'accès. Claude Desktop reste ensuite connecté — aucun fichier de configuration ou outil supplémentaire n'est nécessaire.

Claude Code (CLI)

Claude Code supporte les serveurs MCP distants nativement. Ajoutez Linkly avec une seule commande :

claude mcp add --transport http linkly https://mcp.linklyhq.com

Ensuite, exécutez /mcp dans Claude Code, sélectionnez linkly, et autorisez dans le navigateur lorsqu'on vous le demande.

ChatGPT Desktop

Ouvrez votre fichier de configuration ChatGPT :

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Ajoutez le serveur MCP Linkly :

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Outils disponibles

Options de création de lien

Lors de la création de liens, vous pouvez spécifier :

• Basique : url, name, note, domain, slug, enabled
• Paramètres UTM : utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph : og_title, og_description, og_image
• Suivi : fb_pixel_id, ga4_tag_id, gtm_id
• Avancé : cloaking, forward_params, block_bots, hide_referrer
• Expiration : expiry_datetime, expiry_destination

Dépannage

« Impossible de se connecter au serveur MCP »

• Confirmez que https://mcp.linklyhq.com est accessible depuis votre machine
• Dans Claude Code, exécutez /mcp et sélectionnez linkly pour relancer le flux OAuth

« Authentification échouée », « invalid_client », ou le navigateur continue à demander de se connecter

Cela signifie que votre client maintient un enregistrement de connexion périmé. Effacez les identifiants en cache et réautorisez. Dans Claude Code, exécutez /mcp → linkly → reconnecter. Dans Claude Desktop, supprimez le connecteur Linkly sous Paramètres → Connecteurs et rajoutez-le, puis reconnectez-vous.

Les outils n'apparaissent pas

• Redémarrez votre assistant IA après avoir enregistré la configuration
• Vérifiez que la syntaxe JSON dans votre fichier de configuration est valide
• Vérifiez que le serveur MCP est en cours d'exécution (recherchez l'icône des outils dans votre assistant)

Ressources associées

• Intégration Claude Desktop
• Intégration ChatGPT
• Documentation API Linkly
• CLI Linkly
• Webhooks
• Model Context Protocol