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 par 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 compatibles

Le serveur MCP Linkly fonctionne avec :

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

Serveur MCP ou CLI Linkly ?

Si votre assistant IA est un agent de codage qui peut 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à à l'aise pour utiliser les outils en ligne de commande, et la CLI leur fournit une sortie --json sur chaque commande plus une commande linkly schema qui imprime 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 les statistiques - « Montre-moi les clics par pays des 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 clic »

Premiers pas

Le serveur MCP Linkly hébergé se trouve à l'adresse 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 alors connecté — aucun fichier de configuration ou outil supplémentaire nécessaire.

Claude Code (CLI)

Claude Code prend en charge 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 à l'intérieur de Claude Code, choisissez linkly, et autorisez dans le navigateur quand vous y êtes invité.

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 choisissez linkly pour relancer le flux OAuth

« Échec de l'authentification », « invalid_client », ou le navigateur demande continuellement de se connecter

Cela signifie que votre client détient un enregistrement de connexion obsolète. 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 ajoutez-le à nouveau, puis reconnectez-vous.

Les outils n'apparaissent pas

• Redémarrez votre assistant IA après avoir sauvegardé la configuration
• Vérifiez que la syntaxe JSON dans votre fichier de configuration est valide
• Vérifiez que le serveur MCP fonctionne (cherchez 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