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 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
• D'autres clients compatibles MCP (Cursor, Windsurf, etc.)

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à à l'aise pour utiliser des outils en ligne de commande, et la CLI leur donne 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"
• Consulter l'analytique - "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 des webhooks - "Abonne https://my-site.com/webhook pour recevoir les événements de clic"

Bien démarrer

Le serveur Linkly MCP hébergé se trouve à https://mcp.linklyhq.com. Il n'y a rien à installer et pas de 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 vous permettre de vous connecter et d'approuver l'accès.

Claude Code (CLI)

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

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

Ensuite, exécutez /mcp dans Claude Code, choisissez 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 :

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

« Authentification échouée » / le navigateur continue à demander de se connecter

Effacez les identifiants MCP mis en cache de votre client et réautorisez. Dans Claude Code, exécutez /mcp → linkly → reconnectez-vous. 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 fonctionne (vérifiez 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