Référence de l'API

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/mcp

Configuration 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

OutilArgumentsRenvoie
list_workspacesSans argument{ workspaces: Workspace[] }
list_websitesSans argument{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, facultatif name, keywords, descriptionWebsite
update_websitewebsiteId, facultatif name, descriptionWebsite
delete_websitewebsiteId{ deleted: true }
analyze_websiteurl{ description: string }
add_keywordswebsiteId, keywordsWebsite
edit_keywordkeywordId, valueKeyword
disable_keywordkeywordIdKeyword
enable_keywordkeywordIdKeyword
delete_keywordkeywordId{ deleted: true }
keyword_change_usageSans argumentutilisation des modifications de mots-clés
list_mentionsfacultatif websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offsetMention[] paginé
count_mentionsfacultatif websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsSans argumentparamètres d’alerte
update_alert_settingsenabled, facultatif cadenceMinutesparamè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_denied signifie que le workspaceId n'est pas accessible avec cette connexion; choisissez-en un dans list_workspaces. Un 403 avec code: subscription_required signifie que l'abonnement de l'espace de travail n'inclut pas l'accès à l'API. Un 403 avec code: permission_denied signifie que votre rôle dans cet espace de travail n'a pas redreplier.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 PENDING n’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é.