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 un standard ouvert 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 pris en charge

Le serveur MCP Linkly fonctionne avec :

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"
  • Voir les analyses - "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"

Prise en main

Le serveur MCP Linkly hébergé est accessible à l'adresse https://mcp.linklyhq.com. 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 et vous demande de vous connecter à Linkly et d'autoriser l'accès. Ensuite, 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 vous connectiez et autorisiez l'accès.

Claude Code (CLI)

Claude Code prend en charge nativement les serveurs MCP distants. Ajoutez Linkly en 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 MCP Linkly :

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

Outils disponibles

OutilDescription
create_linkCréer un nouveau lien court avec paramètres UTM, pixels optionnels, etc.
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 clics récentes
get_analyticsObtenir des données de clics 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 webhook de l'espace de travail
subscribe_webhookAbonner 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 :

  • 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"

  • Vérifiez que https://mcp.linklyhq.com est accessible depuis votre machine
  • Si votre client utilise mcp-remote, assurez-vous que Node.js v18 ou ultérieur est installé
  • Dans Claude Code, exécutez /mcp et choisissez linkly pour relancer le flux OAuth

"Échec de l'authentification" / le navigateur demande sans cesse de se connecter

Effacez les identifiants MCP mis en cache par votre client et autorisez à nouveau. Dans Claude Code, exécutez /mcplinkly → reconnectez-vous. Dans Claude Desktop, quittez l'application, supprimez le jeton 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 de 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 associées

FAQ sur le serveur MCP

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

Non. Le serveur hébergé sur https://mcp.linklyhq.com utilise OAuth — vous vous connectez une fois dans le navigateur et votre assistant IA reste connecté. Il n'y a rien à installer sur votre machine en dehors de votre 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 aucune clé API à copier ou coller où que ce soit.

Quels assistants IA prennent en charge MCP ?

Claude Desktop, Claude Code (CLI) et ChatGPT Desktop prennent tous en charge MCP. D'autres outils comme Cursor et Windsurf ont également un 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 saisi ailleurs 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.

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

Non, MCP nécessite les applications de bureau ou la CLI Claude Code. Les versions web ne prennent pas en charge les connexions MCP.

Comment mettre à jour le serveur MCP ?

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

Suivez 500 clics mensuels avec toutes les fonctionnalités incluses.

Aucune carte de crédit requise