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/mcpVolledige 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
| Tool | Argumenten | Geeft terug |
|---|---|---|
list_workspaces | Geen argumenten | { workspaces: Workspace[] } |
list_websites | Geen argumenten | { websites: Website[] } |
get_website | websiteId | Website |
create_website | url, optioneel name, keywords, description | Website |
update_website | websiteId, optioneel 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 | Geen argumenten | gebruik van trefwoordbewerkingen |
list_mentions | optioneel websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offset | gepagineerde Mention[] |
count_mentions | optioneel 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 | Geen argumenten | meldingsinstellingen |
update_alert_settings | enabled, optioneel cadenceMinutes | meldingsinstellingen |
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_deniedbetekent dat deze login niet bij dieworkspaceIdkan; kies er een uitlist_workspaces. Een 403 metcode: subscription_requiredbetekent dat het abonnement van de workspace geen API-toegang bevat. Een 403 metcode: permission_deniedbetekent dat je rol in die workspace geenredreplier.writeheeft, 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
PENDINGblijft 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.