API-Referenz

RedReplier MCP-Server verbinden

RedReplier stellt einen gehosteten MCP-Server bereit, der dieselbe öffentliche REST-API kapselt. Nutzen Sie ihn, wenn ein KI-Client Websites, Keywords, Mentions, Workspaces und Alert-Einstellungen direkt verwalten soll.

MCP-URL: https://mcp.redreplier.com/mcp

Authentifizierung

Richten Sie Ihren MCP-Client auf die URL aus und melden Sie sich an, wenn sich der Browser öffnet. Der Server beantwortet nicht authentifizierte Anfragen mit 401 und einem WWW-Authenticate-Header, und OAuth-fähige Clients (Claude Code, Claude Desktop, ChatGPT, Cursor) öffnen die RedReplier-Anmeldung von selbst. Kein API-Schlüssel zum Einfügen.

Lieber einen Schlüssel? Headless-Agenten und Clients ohne OAuth können stattdessen ein RedReplier-API-Token im Authorization-Header senden. Der Server ermittelt das Konto aus diesem Token.

Client-Konfiguration

Einzeiler für Claude Code:

claude mcp add --transport http redreplier https://mcp.redreplier.com/mcp

Vollständige Konfiguration für jeden MCP-Client:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp"
    }
  }
}

Alternative mit API-Schlüssel, für Headless-Agenten und Clients ohne OAuth:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp",
      "headers": {
        "Authorization": "Bearer redreplier_your_key"
      }
    }
  }
}

Tools

ToolArgumenteGibt zurück
list_workspacesKeine Argumente{ workspaces: Workspace[] }
list_websitesKeine Argumente{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, optional name, keywords, descriptionWebsite
update_websitewebsiteId, optional 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_usageKeine ArgumenteKeyword-Edit-Nutzung
list_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offsetpaginierte Mention[]
count_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsKeine ArgumenteAlert-Einstellungen
update_alert_settingsenabled, optional cadenceMinutesAlert-Einstellungen

Hinweise

Eine OAuth-Anmeldung kann mehrere Workspaces erreichen. Rufen Sie list_workspaces auf und übergeben Sie die id als optionales Argument workspaceId, das jedes andere Tool annimmt. Ohne workspaceId handeln die Tools im Standard-Workspace.

Beginnen Sie mit list_websites, damit der Client die verfügbaren websiteId- und keywordId-Werte kennt. Keywords über dem Tariflimit bleiben PENDING, bis ein Platz frei wird. Ein aktives Keyword zu deaktivieren oder zu löschen oder eine Website zu löschen macht einen Platz frei, und das älteste ausstehende Keyword, das hineinpasst, rückt nach. Nur der Nutzer kann den Tarif ändern, in der RedReplier-App. delete_keyword funktioniert bei Keywords in jedem Status und löscht auch ihre Mentions, fragen Sie also vorher beim Nutzer nach.

Fehlerbehebung

  • Ein 401 bei einer Anfrage ohne Token ist die OAuth-Aufforderung und erwartet. Ihr Client sollte ein Anmeldefenster öffnen. Ein 401 mit Token bedeutet, dass das Bearer-Token falsch formatiert, abgelaufen, widerrufen ist oder nicht mit redreplier_ beginnt.
  • Ein 403 mit code: workspace_access_denied bedeutet, dass diese Anmeldung die workspaceId nicht erreicht; wählen Sie eine aus list_workspaces. Ein 403 mit code: subscription_required bedeutet, dass der Tarif des Workspace keinen API-Zugang enthält. Ein 403 mit code: permission_denied bedeutet, dass Ihre Rolle in diesem Workspace redreplier.write nicht hat, das Admin und Editor haben; bitten Sie einen Workspace-Admin um eine passende Rolle.
  • 404-Fehler bedeuten meist, dass die ID zu einer anderen Account-Gruppe gehört oder gelöscht wurde.
  • Ein Keyword, das in PENDING bleibt, hat im Tarif keinen Platz. Bitten Sie den Nutzer, den Tarif in der RedReplier-App zu ändern, oder deaktivieren oder löschen Sie ein anderes Keyword.