Meilleurs Outils SEO
Tous les articles
Par La rédactionmcppromptwatchclaudecursorguide

Connecter Promptwatch MCP à Claude et Cursor

Guide pratique pour connecter le serveur MCP de Promptwatch à Claude et Cursor, avec clé Bearer, clés en lecture seule et masquage des outils d'écriture.

Le serveur MCP de Promptwatch expose toute la donnée de visibilité IA à vos agents. Une fois connecté, Claude Desktop, Claude Code et Cursor peuvent lister vos prompts, lire les citations, suivre les journaux de crawlers et même publier du contenu GEO, sans quitter la conversation. Ce guide explique la configuration, la clé Bearer, et surtout le bon usage des clés en lecture seule pour masquer les outils d'écriture quand vous ne voulez pas qu'un agent publie.

Le serveur Promptwatch MCP

Promptwatch héberge un serveur MCP streamable HTTP à l'adresse https://server.promptwatch.com/mcp. L'authentification se fait par OAuth ou par clé Bearer. Le plugin ChatGPT et le connecteur Claude tournent déjà sur ce serveur. Cursor se connecte via un fichier .cursor/mcp.json.

Le serveur publie deux familles d'outils. Les outils en lecture couvrent la mesure : listPrompts, getPrompt, getVisibilityTimeSeries, getCitations, getCitationTopPages, listRedditCitations, listYoutubeCitations, getCompetitorHeatmap, listContentGapPrompts, getContentGapRecommendations, listQueryFanouts, getCrawlerTrend, getTopCrawlerPages, getVisitorTrend, getVisitorTopPages, getVisitorTopSources, getResponseSentimentTimeSeries, listAds, listAdPrompts, listShoppingItems, getContentGapStats, getSiteHealth, listActionItems. Les outils en écriture couvrent l'action : createContent, listContentSlots, acceptContentSlot, publishContentLive, createReport, createActionItem, updateActionItemStatus, createPrompt, createPromptsBulk, addShoppingTrackedProducts.

L'accès MCP et l'API sont inclus dès l'offre payante d'entrée, Essential à 95 $ par mois. Explore est gratuit mais limité à 10 prompts sur ChatGPT.

Étape 1, créer une clé Bearer

Dans l'interface Promptwatch, créez une clé API depuis les paramètres d'intégration. Donnez-lui un nom clair, par exemple cursor-lecture-seule, pour la retrouver plus tard. L'interface vous propose de restreindre la clé en lecture seule. Cochez cette option pour votre première connexion. Une clé en lecture seule masque tous les outils d'écriture côté serveur. Le client MCP ne les voit pas, donc le modèle ne peut pas les invoquer, même si on lui demande.

C'est la protection la plus solide, parce qu'elle ne dépend pas du client. Même si vous configurez Cursor avec une clé en lecture seule puis copiez le fichier ailleurs, la clé reste en lecture seule. Gardez la clé d'écriture pour un second profil, dédié à la publication de contenu, et ne le branchez que quand vous supervisez.

Étape 2, connecter Cursor

Cursor lit sa configuration MCP dans un fichier .cursor/mcp.json à la racine de votre projet, ou dans le fichier global de l'utilisateur. Pour un projet, créez .cursor/mcp.json avec le contenu suivant.

{
  "mcpServers": {
    "promptwatch": {
      "url": "https://server.promptwatch.com/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_BEARER"
      }
    }
  }
}

Remplacez VOTRE_CLE_BEARER par la clé créée à l'étape 1. Le serveur est de type streamable HTTP, donc on utilise la clé url et non command. Redémarrez Cursor, ouvrez les paramètres MCP, et vérifiez que le serveur promptwatch apparaît avec ses outils. Si la clé est en lecture seule, vous ne verrez pas les outils createContent, publishContentLive et les autres outils d'écriture. C'est le comportement attendu.

Pour tester, ouvrez le chat Cursor en mode agent et demandez : « Liste mes prompts Promptwatch et donne-moi le score de visibilité de chacun. » L'agent invoque listPrompts puis getVisibilityTimeSeries et répond avec vos données. Aucune copie manuelle depuis le tableau de bord.

Étape 3, connecter Claude Desktop et Claude Code

Claude Desktop lit sa configuration dans claude_desktop_config.json. Sur macOS, le fichier se trouve dans ~/Library/Application Support/Claude/. Ajoutez un bloc mcpServers avec le même contenu que pour Cursor.

{
  "mcpServers": {
    "promptwatch": {
      "url": "https://server.promptwatch.com/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_BEARER"
      }
    }
  }
}

Redémarrez Claude Desktop. Le serveur apparaît dans la liste des connecteurs. Le connecteur Claude officiel de Promptwatch tourne déjà sur ce même serveur, donc si vous avez déjà activé le connecteur officiel, vérifiez que vous ne le dupliquez pas avec une seconde clé.

Pour Claude Code, le client en ligne de commande d'Anthropic, la configuration se fait par projet avec claude mcp add. La commande ressemble à ceci.

claude mcp add promptwatch --transport http https://server.promptwatch.com/mcp --header "Authorization: Bearer VOTRE_CLE_BEARER"

Là encore, utilisez la clé en lecture seule pour le travail courant. Gardez la clé d'écriture pour un profil nommé promptwatch-write que vous activez seulement au moment de publier.

Étape 4, masquer les outils d'écriture

Le masquage des outils d'écriture se fait côté serveur, pas côté client. C'est important. Les clients MCP laissent parfois l'utilisateur désactiver un outil dans l'interface, mais cette désactivation est locale au profil. Si la clé porte le droit d'écriture, un autre profil ou un autre client peut réexposer l'outil.

La règle pratique tient en trois points. Premièrement, créez deux clés : une en lecture seule nommée pour le travail courant, une en lecture et écriture nommée pour la publication. Deuxièmement, ne branchez la clé d'écriture que dans un profil dédié, et seulement quand vous supervisez la publication. Troisièmement, faites tourner la clé d'écriture plus souvent que la clé de lecture, parce que son risque est plus élevé.

Avec ce schéma, un agent qui s'emballe ne peut pas publier un article GEO par accident. La clé en lecture seule ne lui donne même pas la fonction. C'est la différence entre « le modèle a décidé de ne pas publier » et « le modèle ne peut pas publier ».

Étape 5, un premier flux utile

Une fois la clé en lecture seule connectée, essayez un flux en trois étapes qui montre l'intérêt du MCP pour le GEO.

D'abord, demandez à l'agent : « Quels sont mes écarts de contenu les plus urgents ? » L'agent invoque listContentGapPrompts puis getContentGapRecommendations et répond avec une liste priorisée.

Ensuite, demandez : « Pour ces trois écarts, quelles pages sont déjà citées et par quels crawlers ? » L'agent enchaîne getCitations et getCitationTopPages côté contenu, puis getCrawlerTrend et getTopCrawlerPages côté crawlers, et croise les deux. Vous voyez si vos pages sont lues par les crawlers IA avant d'être citées.

Enfin, demandez : « Rédige-moi un brief d'article pour combler le plus gros écart, basé sur les fan-outs de la requête. » L'agent appelle listQueryFanouts pour récupérer les variantes de la requête, puis rédige le brief. Si vous voulez aller jusqu'à la publication, basculez sur le profil avec la clé d'écriture et demandez à l'agent d'appeler createContent puis publishContentLive vers votre CMS connecté.

Quand passer à la clé d'écriture

La clé d'écriture ouvre les Content Agents, la publication vers Webflow et Framer, la création de prompts en masse et le tableau d'actions. C'est la boucle fermée. Tant que vous découvrez le produit ou que vous laissez un agent tourner sans surveillance, restez en lecture seule. Le risque d'une publication involontaire est plus élevé que le gain de quelques minutes.

Quand votre équipe est à l'aise et que la boîte de relecture des Content Agents est en place, passez à la clé d'écriture pour le profil dédié. La boîte de relecture reste une barrière côté produit : un brouillon publié par createContent attend votre approbation dans la boîte avant que publishContentLive ne le mette en ligne. La clé d'écriture ne contourne pas la relecture, elle la déclenche.

En résumé

Le serveur MCP de Promptwatch se connecte en quelques minutes à Claude et Cursor. La clé Bearer s'ajoute dans l'en-tête Authorization. Les clés en lecture seule masquent les outils d'écriture côté serveur, ce qui est la protection la plus solide contre une publication involontaire. Pour un programme GEO sérieux, la boucle listContentGapPrompts, getContentGapRecommendations, listQueryFanouts, createContent, publishContentLive se fait entièrement dans la conversation, et c'est la raison pour laquelle ce serveur se distingue des serveurs MCP purement techniques du marché.

Articles liés