Connecter Claude à vos données GEOConfigurer le MCP de Refine pour Claude Desktop, Claude Code et l’API

Résumé

Claude est un client MCP de premier plan : Claude Code se connecte à Refine en une commande dans le terminal, Claude Desktop avec une courte configuration JSON, et l’API Claude via son connecteur MCP. Une fois connecté, Claude peut récupérer votre taux de mention et l’historique de votre visibilité, examiner les réponses brutes de l’IA derrière vos scores, gérer vos prompts suivis et vos concurrents, et générer du contenu prêt à publier. Ce guide détaille les trois configurations, avec des extraits prêts à copier.

Ce qu’il vous faut avant de commencer

• Un compte Refine sur l’offre Visibility ou Autopilot, avec au moins une marque configurée.
• Une clé API Refine : créée depuis votre tableau de bord, elle commence par rfn_live_ et ne s’affiche qu’une fois. Conservez-la dans un gestionnaire de mots de passe.
• L’URL de l’endpoint : https://app.refine-app.com/api/mcp/mcp. C’est un serveur MCP distant en Streamable HTTP : rien à installer ni à héberger.

Connecter Claude Code (une commande)

Claude Code enregistre les serveurs MCP distants depuis le terminal. Lancez cette commande une fois, en remplaçant la clé par la vôtre :

claude mcp add --transport http refine \
  https://app.refine-app.com/api/mcp/mcp \
  --header "Authorization: Bearer rfn_live_your_key"

Redémarrez Claude Code : les outils Refine apparaissent automatiquement. Tapez /mcp dans une session pour vérifier que le serveur est connecté et voir les quinze outils disponibles.

Connecter Claude Desktop

Claude Desktop lit ses serveurs MCP dans claude_desktop_config.json (Réglages → Développeur → Modifier la configuration). Ajoutez le bloc refine sous mcpServers :

{
  "mcpServers": {
    "refine": {
      "type": "http",
      "url": "https://app.refine-app.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer rfn_live_your_key"
      }
    }
  }
}

Redémarrez l’application. Refine apparaît parmi vos outils, et Claude vous demandera votre accord la première fois qu’il appelle chaque outil : acceptez une fois, il s’en souviendra.

Connecter via l’API Claude

Pour les agents programmatiques, l’API Claude propose un connecteur MCP : passez le serveur dans le paramètre mcp_servers d’une requête Messages, et Claude appelle les outils en pleine conversation sans que vous écriviez de code de gestion des outils.

response = client.beta.messages.create(
    model="claude-sonnet-5",
    max_tokens=2048,
    betas=["mcp-client-2025-04-04"],
    mcp_servers=[{
        "type": "url",
        "url": "https://app.refine-app.com/api/mcp/mcp",
        "name": "refine",
        "authorization_token": "rfn_live_your_key",
    }],
    messages=[{
        "role": "user",
        "content": "How is my AI visibility trending over 30 days?",
    }],
)

Les premiers prompts à essayer

• « Liste mes prompts suivis et signale ceux qui se recoupent ou visent la même question. »
• « Quel est mon taux de mention et mon rang moyen sur les 30 derniers jours ? Comment la tendance se compare-t-elle aux 90 derniers ? »
• « Récupère les résultats bruts de mon prompt le moins performant et dis-moi quels concurrents les moteurs IA recommandent à ma place. »
• « Génère un article de blog pour ce prompt, en t’appuyant sur ces deux URL sources, et montre-moi le brouillon quand il est prêt. »
• « Ajoute [concurrent] à mes concurrents suivis et tague tous mes prompts liés aux prix avec un nouveau tag Tarifs. »

Dépannage

• 401 Unauthorized : l’en-tête Authorization est absent ou la clé est erronée. Vérifiez qu’il ne manque pas le préfixe « Bearer » et que la clé n’a pas été révoquée dans votre tableau de bord.
• Les outils n’apparaissent pas : redémarrez le client après avoir modifié la configuration ; dans Claude Code, tapez /mcp pour voir l’état de la connexion.
• La génération de contenu renvoie un contentId mais pas de texte : la génération est asynchrone. Demandez à Claude d’interroger get_content jusqu’à ce que le statut soit completed ; un long article peut prendre quelques minutes.
• Limite de requêtes atteinte : chaque clé autorise 60 requêtes par minute. Un agent qui tourne en boucle serrée peut l’atteindre ; demandez-lui de regrouper ses lectures plutôt que d’interroger en continu.