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 externes et des sources de données. Au lieu de copier-coller entre les applications, vous pouvez demander à votre assistant IA d'effectuer des actions directement.

Assistants IA pris en charge

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 capable d'exécuter des commandes shell — comme Claude Code ou Cursor — la CLI Linkly est souvent un meilleur choix que le serveur MCP. Les agents de codage sont déjà à l'aise pour utiliser les outils de ligne de commande, et la CLI leur offre 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 au cours 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

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 MCP Linkly :

{
  "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 puissiez vous connecter et approuver l'accès.

Claude Code (CLI)

Claude Code prend en charge les serveurs MCP distants de manière native. Ajoutez Linkly avec une seule commande :

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

Exécutez ensuite /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 MCP Linkly :

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

Outils disponibles

Options de création de liens

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 sélectionnez linkly pour relancer le flux OAuth

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

Effacez les identifiants MCP 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 jeton mcp-remote en cache dans ~/.mcp-auth/, puis redémarrez.

Les outils n'apparaissent pas

• Redémarrez votre assistant IA après l'enregistrement de 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 connexes

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