API-referentie

De RedReplier MCP-server koppelen

RedReplier biedt een gehoste MCP-server die dezelfde openbare REST API omvat. Gebruik hem als een AI-client websites, trefwoorden, vermeldingen, workspaces en meldingsinstellingen rechtstreeks moet beheren.

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

Authenticatie

Wijs je MCP-client naar de URL en log in wanneer de browser opent. De server beantwoordt verzoeken zonder authenticatie met een 401 en een header WWW-Authenticate, en clients die OAuth ondersteunen (Claude Code, Claude Desktop, ChatGPT, Cursor) openen zelf de inlogpagina van RedReplier. Je hoeft geen API-sleutel te plakken.

Werk je liever met een sleutel? Headless agents en clients zonder OAuth kunnen in plaats daarvan een RedReplier API-token meesturen in de header Authorization. De server haalt het account uit dat token.

Clientconfiguratie

Eén regel voor Claude Code:

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

Volledige configuratie voor elke MCP-client:

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

Alternatief met een API-sleutel, voor headless agents en clients zonder OAuth:

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

Tools

ToolArgumentenGeeft terug
list_workspacesGeen argumenten{ workspaces: Workspace[] }
list_websitesGeen argumenten{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, optioneel name, keywords, descriptionWebsite
update_websitewebsiteId, optioneel 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_usageGeen argumentengebruik van trefwoordbewerkingen
list_mentionsoptioneel websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offsetgepagineerde Mention[]
count_mentionsoptioneel websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsGeen argumentenmeldingsinstellingen
update_alert_settingsenabled, optioneel cadenceMinutesmeldingsinstellingen

Opmerkingen

Een OAuth-login kan bij meerdere workspaces. Roep list_workspaces aan om ze op te sommen en geef het id mee als het optionele argument workspaceId dat elke andere tool accepteert. Zonder workspaceId werken tools in de standaardworkspace.

Begin met list_websites, zodat de client de beschikbare waarden van websiteId en keywordId kent. Trefwoorden boven de limiet van het abonnement blijven PENDING tot er een plek vrijkomt. Een actief trefwoord uitschakelen of verwijderen, of een website verwijderen, maakt een plek vrij, en het oudste wachtende trefwoord dat past neemt die in. Alleen de gebruiker kan het abonnement wijzigen, in de RedReplier-app. delete_keyword werkt op een trefwoord met elke status en verwijdert ook de bijbehorende vermeldingen, dus vraag de gebruiker eerst om bevestiging.

Problemen oplossen

  • Een 401 op een verzoek zonder token is de OAuth-challenge en is normaal. Je client hoort een inlogvenster te openen. Een 401 met een token betekent dat het Bearer-token onjuist is opgebouwd, verlopen of ingetrokken is, of niet begint met redreplier_.
  • Een 403 met code: workspace_access_denied betekent dat deze login niet bij die workspaceId kan; kies er een uit list_workspaces. Een 403 met code: subscription_required betekent dat het abonnement van de workspace geen API-toegang bevat. Een 403 met code: permission_denied betekent dat je rol in die workspace geen redreplier.write heeft, die Admin en Editor wel hebben; vraag een workspacebeheerder om een rol die dat wel heeft.
  • Een 404 betekent meestal dat het ID bij een andere accountgroep hoort of is verwijderd.
  • Een trefwoord dat in PENDING blijft hangen, past niet meer in het abonnement. Vraag de gebruiker het abonnement te wijzigen in de RedReplier-app, of schakel een ander trefwoord uit of verwijder het.