Connecter le serveur MCP RedReplier
RedReplier expose un serveur MCP hébergé qui enveloppe la même API REST publique. Utilisez-le lorsqu’un client IA doit gérer directement les sites web, les mots-clés, les mentions, les espaces de travail et les paramètres d’alerte.
URL MCP: https://mcp.redreplier.com/mcp
Authentification
Pointez votre client MCP vers l’URL et connectez-vous quand le navigateur s’ouvre. Le serveur répond aux requêtes non authentifiées par un 401 et un en-tête WWW-Authenticate, et les clients compatibles OAuth (Claude Code, Claude Desktop, ChatGPT, Cursor) ouvrent la connexion RedReplier d’eux-mêmes. Aucune clé API à coller.
Vous préférez une clé ? Les agents sans interface et les clients sans OAuth peuvent envoyer à la place un token API RedReplier dans l’en-tête Authorization. Le serveur résout le compte depuis ce token.
Configuration du client
Commande unique pour Claude Code :
claude mcp add --transport http redreplier https://mcp.redreplier.com/mcpConfiguration complète pour tout client MCP :
{
"mcpServers": {
"redreplier": {
"type": "http",
"url": "https://mcp.redreplier.com/mcp"
}
}
}Alternative avec clé API, pour les agents sans interface et les clients sans OAuth :
{
"mcpServers": {
"redreplier": {
"type": "http",
"url": "https://mcp.redreplier.com/mcp",
"headers": {
"Authorization": "Bearer redreplier_your_key"
}
}
}
}Outils
| Outil | Arguments | Renvoie |
|---|---|---|
list_workspaces | Sans argument | { workspaces: Workspace[] } |
list_websites | Sans argument | { websites: Website[] } |
get_website | websiteId | Website |
create_website | url, facultatif name, keywords, description | Website |
update_website | websiteId, facultatif name, description | Website |
delete_website | websiteId | { deleted: true } |
analyze_website | url | { description: string } |
add_keywords | websiteId, keywords | Website |
edit_keyword | keywordId, value | Keyword |
disable_keyword | keywordId | Keyword |
enable_keyword | keywordId | Keyword |
delete_keyword | keywordId | { deleted: true } |
keyword_change_usage | Sans argument | utilisation des modifications de mots-clés |
list_mentions | facultatif websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offset | Mention[] paginé |
count_mentions | facultatif websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to | { total: number } |
update_mention_status | mentionId, status | Mention |
explain_mention | mentionId | Mention | null |
get_alert_settings | Sans argument | paramètres d’alerte |
update_alert_settings | enabled, facultatif cadenceMinutes | paramètres d’alerte |
Notes
Une connexion OAuth peut atteindre plusieurs espaces de travail. Appelez list_workspaces pour les lister, puis passez l’id dans l’argument facultatif workspaceId qu’accepte chaque autre outil. Sans workspaceId, les outils agissent dans l’espace de travail par défaut.
Commencez par list_websites afin que le client connaisse les valeurs websiteId et keywordId disponibles. Les mots-clés au-delà de la limite du forfait restent PENDING jusqu’à ce qu’une place se libère. Désactiver ou supprimer un mot-clé actif, ou supprimer un site web, libère une place, que prend le plus ancien mot-clé en attente qui y tient. Seul l’utilisateur peut changer de forfait, dans l’app RedReplier. delete_keyword fonctionne sur un mot-clé dans n’importe quel statut et supprime aussi ses mentions, demandez donc confirmation à l’utilisateur avant.
Dépannage
- Un 401 sur une requête sans token est le défi OAuth et c’est attendu. Votre client devrait ouvrir une fenêtre de connexion. Un 401 avec un token signifie que le token Bearer est mal formé, expiré, révoqué ou ne commence pas par
redreplier_. - Un 403 avec
code: workspace_access_deniedsignifie que leworkspaceIdn'est pas accessible avec cette connexion; choisissez-en un danslist_workspaces. Un 403 aveccode: subscription_requiredsignifie que l'abonnement de l'espace de travail n'inclut pas l'accès à l'API. Un 403 aveccode: permission_deniedsignifie que votre rôle dans cet espace de travail n'a pasredreplier.write, que détiennent Admin et Editor; demandez à un admin de l'espace de travail un rôle qui l'a. - Les erreurs 404 indiquent généralement que l’ID appartient à un autre groupe de compte ou a été supprimé.
- Un mot-clé qui reste en
PENDINGn’a pas de place dans le forfait. Demandez à l’utilisateur de changer de forfait dans l’app RedReplier, ou désactivez ou supprimez un autre mot-clé.