Serveur Linkly MCP

Le serveur Linkly MCP 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 le 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 Linkly MCP fonctionne avec :

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

Ce que vous pouvez faire

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

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

Prise en main

Le serveur Linkly MCP 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

Ouvrez votre fichier de configuration Claude Desktop :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur Linkly MCP :

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Redémarrez Claude Desktop. La première fois que vous utilisez un outil Linkly, un onglet de navigateur s'ouvre pour que vous vous connectiez et approuviez l'accès.

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

Puis exécutez /mcp dans Claude Code, sélectionnez linkly, et autorisez dans le navigateur lorsque 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 Linkly MCP :

{
  "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 :

• De base : 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
• Si votre client utilise mcp-remote, assurez-vous que Node.js v18 ou version ultérieure est installé
• Dans Claude Code, exécutez /mcp et sélectionnez linkly pour redéclencher le flux OAuth

« Échec de l'authentification » / le navigateur continue de demander la connexion

Effacez les credentials MCP mis en cache de votre client et réautorisez. Dans Claude Code, exécutez /mcp → linkly → reconnectez. Dans Claude Desktop, quittez l'application, supprimez le token mcp-remote mis en cache dans ~/.mcp-auth/, puis redémarrez.

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 (vérifiez l'icône des outils dans votre assistant)

Ressources associées

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