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 en toute sécurité à 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 pris en charge

Le serveur Linkly MCP fonctionne avec :

Où le trouver

Le serveur Linkly MCP est répertorié dans les principaux répertoires MCP, vous pouvez donc l'installer depuis n'importe où vous cherchez déjà des connecteurs :

Serveur MCP ou Linkly CLI ?

Si votre assistant IA est un agent de codage qui peut exécuter des commandes shell — comme Claude Code ou Cursor — le Linkly CLI est souvent plus approprié que le serveur MCP. Les agents de codage sont déjà à l'aise avec les outils en ligne de commande, et le CLI fournit une sortie --json sur chaque commande plus une commande linkly schema qui imprime l'arborescence complète des commandes, ce qui permet à l'agent de 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éer 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 - « 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 clic »

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

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 que vous vous connectiez et approuviez 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 nativement les serveurs MCP distants. Ajoutez Linkly avec une 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 si demandé.

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

OutilDescription
create_linkCréer un nouveau lien court avec paramètres UTM, pixels et plus optionnels
update_linkMettre à jour les paramètres d'un lien existant
delete_linkSupprimer un lien
get_linkObtenir les détails d'un lien spécifique
list_linksLister tous les liens de votre espace de travail
search_linksRechercher des liens par nom, URL ou note
get_clicksObtenir les données de clic récentes
get_analyticsObtenir les données de clic en série temporelle pour les graphiques
get_analytics_byObtenir les clics groupés par pays, navigateur, plateforme, etc.
list_domainsLister vos domaines personnalisés
list_webhooksLister les abonnements aux webhooks de l'espace de travail
subscribe_webhookS'abonner à une URL pour recevoir les événements de clic

Options de création de liens

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

  • 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
  • Vos propres données : metadata, paires clé-valeur telles que les ID de votre système. Elles sont renvoyées avec le lien et incluses dans les charges utiles des webhooks. Voir métadonnées de lien

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 de demander de se connecter

Cela signifie que votre client maintient un enregistrement de connexion obsolète. Effacez les identifiants en cache et autorisez à nouveau. Dans Claude Code, exécutez /mcp → linkly → vous reconnecter. Dans Claude Desktop, supprimez le connecteur Linkly sous Paramètres → Connecteurs et ajoutez-le à nouveau, puis connectez-vous.

Les outils n'apparaissent pas

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

Ressources associées

FAQ du serveur MCP

Dois-je installer quelque chose pour utiliser le serveur MCP ?

Non. Le serveur hébergé à https://mcp.linklyhq.com utilise OAuth — vous vous connectez une fois dans le navigateur et votre assistant IA reste connecté. Il n'y a aucun logiciel à installer sur votre machine au-delà de l'assistant IA lui-même.

Ai-je besoin d'une clé API ?

Non. Le serveur MCP utilise OAuth — vous vous connectez à Linkly via votre navigateur la première fois que votre assistant IA se connecte, et il n'y a pas de clé API à copier ou coller nulle part.

Quels assistants IA supportent MCP ?

Claude Desktop, Claude Code (CLI) et ChatGPT Desktop supportent tous MCP. D'autres outils comme Cursor et Windsurf ont également le support MCP.

Mon compte est-il sécurisé ?

Oui. Le serveur hébergé utilise OAuth 2.1 avec PKCE — votre mot de passe Linkly n'est jamais entré que sur app.linklyhq.com, et votre assistant IA ne voit qu'un jeton d'accès limité à votre espace de travail. Le modèle IA lui-même ne voit jamais vos identifiants.

Le serveur MCP respecte-t-il mon rôle dans l'espace de travail ?

Oui. Votre assistant IA peut faire tout ce que votre rôle permet et rien de plus. Si vous avez le rôle Lecture, il peut consulter les liens et les analyses mais ne peut pas créer, modifier ou supprimer quoi que ce soit.

Puis-je utiliser MCP avec les versions web de Claude ou ChatGPT ?

Non, MCP nécessite les applications de bureau ou le Claude Code CLI. Les versions web ne supportent pas les connexions MCP.

Comment mets-je à jour le serveur MCP ?

Il n'y a rien à mettre à jour — nous déployons des améliorations sur le serveur hébergé en continu et chaque client connecté les obtient automatiquement.

Disponibilité du forfait

Disponible sur Pro et supérieur

Comparer les forfaits →

Obtenez 100 liens courts et suivez 500 clics mensuels gratuitement.