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.

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 applications, vous pouvez demander à votre assistant IA d'effectuer des actions directement.

Le serveur MCP Linkly fonctionne avec :

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

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 statistiques - "Montre-moi les clics par pays pour les 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 clics"

Le serveur MCP Linkly est disponible de deux manières :

Utilisez notre serveur MCP hébergé - aucune installation requise :

https://mcp.linklyhq.com

Installez et exécutez localement en utilisant npx :

npx -y linkly-mcp-server

Ou installez globalement :

npm install -g linkly-mcp-server

Consultez le package sur npm.

1. 1Connectez-vous à votre tableau de bord Linkly
2. 2Allez dans Paramètres → Clés API
3. 3Copiez votre Clé API et votre ID d'espace de travail

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", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "votre-clé-api",
        "LINKLY_WORKSPACE_ID": "votre-id-espace-de-travail"
      }
    }
  }
}

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 :

En utilisant npx :

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "votre-clé-api"
      }
    }
  }
}

En utilisant le serveur hébergé :

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "votre-clé-api"
      }
    }
  }
}

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

• Vérifiez que votre clé API et votre ID d'espace de travail sont corrects
• Assurez-vous d'avoir Node.js installé (v18 ou ultérieur)
• Essayez d'exécuter npx linkly-mcp-server dans un terminal pour voir les erreurs

• Vérifiez votre clé API dans le tableau de bord Linkly sous Paramètres → Clés API
• Assurez-vous qu'il n'y a pas d'espaces supplémentaires dans vos identifiants
• Essayez de régénérer votre clé API

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

• Confirmez que le chemin de commande est correct
• Si vous utilisez le serveur hébergé, vérifiez votre connexion Internet
• Vérifiez que le serveur MCP s'exécute manuellement depuis le terminal

• Intégration Claude Desktop
• Intégration ChatGPT
• Documentation de l'API Linkly
• Webhooks
• Serveur MCP sur npm
• Model Context Protocol