API-Referenz

RedReplier MCP-Server verbinden

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

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

Authentifizierung

Richte deinen MCP-Client auf die URL aus und melde dich 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 ein 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_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 }
activate_pending_keywordsKeine Argumente{ websites: Website[] }
preview_activate_pendingKeine ArgumenteKeyword-Abrechnungsvorschau
preview_keyword_billingdesiredKeywordCountKeyword-Abrechnungsvorschau
keyword_change_usageKeine ArgumenteKeyword-Edit-Nutzung
list_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offsetpaginierte Mention[]
count_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsKeine ArgumenteAlert-Einstellungen
update_alert_settingsenabled, optional cadenceMinutesAlert-Einstellungen

Hinweise

Beginne mit list_websites, damit der Client die verfügbaren websiteId- und keywordId-Werte kennt. Rufe preview_activate_pending vor activate_pending_keywords auf, da die Aktivierung ein kostenpflichtiges Tarif-Upgrade auslösen kann.

Fehlerbehebung

  • Ein 401 bei einer Anfrage ohne Token ist die OAuth-Aufforderung und erwartet. Dein Client sollte ein Anmeldefenster öffnen. Ein 401 mit Token bedeutet, dass das Bearer-Token falsch formatiert, abgelaufen, widerrufen ist oder nicht mit redreplier_ beginnt.
  • 404-Fehler bedeuten meist, dass die ID zu einer anderen Account-Gruppe gehört oder gelöscht wurde.
  • Bei kostenpflichtigen Aktionen zuerst vorab prüfen und vor der Aktivierung ausstehender Keywords die Kosten bestätigen lassen.