Koppel je AI aan SubReply
SubReply stelt zijn zes Reddit-prospectietools beschikbaar via een Model Context Protocol-server, de standaard die Claude, ChatGPT, Gemini en n8n spreken. Koppel hem in dertig seconden en je assistent zoekt, schrijft en publiceert zonder dat je één HTTP-verzoek schrijft.
Eén endpoint, alleen POST, streambaar HTTP-transport zonder sessie:
https://subreply.io/api/mcpTwee manieren om je te authenticeren: OAuth voor de connectors van de bekende assistenten, een API-sleutel voor al het andere.
OAuth-koppeling (aanbevolen) — claude.ai, ChatGPT, Gemini
De kortste weg, en zonder sleutel om ergens te plakken. De connector stuurt je naar SubReply, je logt in met je gewone account en het staat er.
Instellingen → Connectors → Connector toevoegen- Plak de URL:
https://subreply.io/api/mcp - Verbinden → inloggen bij SubReply → toestemming geven
Instellingen → Developer Mode → Apps → Nieuwe connector- URL:
https://subreply.io/api/mcp, authenticatieOAuth - Vereist een Pro-, Business-, Enterprise- of Edu-abonnement
Google AI Studio → Extensions → Custom MCP- URL:
https://subreply.io/api/mcp - Authenticatie via SubReply-OAuth
De toestemming geldt 30 dagen. Daarna opent de client hetzelfde scherm opnieuw en is één klik genoeg.
Publiceren kan niet via OAuth
publish_reddit_comment weigert OAuth-koppelingen: schrijven op Reddit vraagt een API-sleutel waarvan de publicatietoestemming aanstaat in je API-instellingen. De andere vijf tools werken gewoon.Koppeling met API-sleutel — Claude Code, Claude Desktop, n8n
De sleutel reist mee in de Authorization-header. Elk verzoek wordt opnieuw geauthenticeerd, dus een ingetrokken sleutel stopt op datzelfde moment met werken in plaats van pas als een sessie verloopt. Het is dezelfde sr_live_…-sleutel als voor de REST v1-API, aan te maken op je pagina met API-sleutels.
Claude Code en Claude Desktop
claude mcp add --transport http subreply https://subreply.io/api/mcp \
--header "Authorization: Bearer sr_live_UW_API_SLEUTEL"Of rechtstreeks in het MCP-configuratiebestand, als je het liever in versiebeheer houdt:
{
"mcpServers": {
"subreply": {
"type": "http",
"url": "https://subreply.io/api/mcp",
"headers": {
"Authorization": "Bearer sr_live_UW_API_SLEUTEL"
}
}
}
}n8n
Voeg een MCP Client-node toe en vul vier velden in:
Endpoint—https://subreply.io/api/mcpServer Transport—HTTP StreamableAuthentication—Header Auth- Header Auth-credential — naam
Authorization, waardeBearer sr_live_…
De node toont dan alle zes tools. Let op de timeout: publish_reddit_comment kan twee minuten duren, ruim boven de standaard van n8n.
Controleren of hij antwoordt
Als een client weigert te koppelen, beslecht deze aanroep de kwestie: hij hangt van geen enkele MCP-client af en kost geen credits.
curl -s -X POST https://subreply.io/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer sr_live_UW_API_SLEUTEL" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'Zes tools in de lijst betekent dat de server in orde is en het probleem aan de clientkant zit. Een 401 betekent de sleutel. Een 406 betekent de Accept-header: het transport eist beide types, ook al antwoordt het met puur JSON. De tool ping doet hetzelfde werk zodra je client gekoppeld is: hij antwoordt pong en bewijst meteen dat je sleutel werkt.
Beschikbare tools
| Tool | Wat hij doet | Credits | Goed om te weten |
|---|---|---|---|
ping | Beschikbaarheidssonde. Antwoordt „pong” en bevestigt dat de sleutel geldig is. | gratis | — |
get_account_status | Creditsaldo en abonnementsstatus. De tool om aan te roepen wanneer een andere „onvoldoende credits” antwoordt. | gratis | — |
list_projects | Projecten van het account: id, naam, doeltaal, zoekwoorden, status van de agent. | gratis | — |
scrape_reddit_opportunities | Scant subreddits en geeft de posts terug waarvan de auteur op een klant lijkt, gescoord op relevantie. | gratis | product_description sterk aanbevolen |
generate_reddit_comment | Schrijft een natuurlijke reactie, in de taal van de draad, gemaakt om geen shadowban uit te lokken. Publiceert niets. | 35 | Idempotent op post_url |
publish_reddit_comment | Publiceert echt op Reddit, vanaf een account uit het SubReply-park achter een residentiële proxy. | 50 | Opt-in per API-sleutel vereist |
Dezelfde economie als de REST-API: zoeken is gratis, alleen productie wordt gefactureerd. Een scan die niets vindt kost dus nooit iets.
Scannen is gratis, maar niet voor iedereen open
get_account_status en list_projects blijven wél aanroepbaar bij nul credits. Dat is precies hun nut.Afschrijvingen zijn idempotent per post: valt het netwerk weg en speelt je agent generate_reddit_comment opnieuw af op dezelfde Reddit-URL, dan geeft de tweede aanroep credits_used: 0 terug.
Limieten
| Tool | Limiet |
|---|---|
scrape_reddit_opportunities | 60 aanroepen / minuut |
generate_reddit_comment | 20 aanroepen / minuut |
publish_reddit_comment | 5 aanroepen / minuut |
get_account_statuslist_projects | 60 aanroepen / minuut |
ping | geen |
Quota worden geteld per account en per tool: generate_reddit_comment uitputten remt je andere tools niet af en de accounts van anderen evenmin. ping is bewust onbeperkt — het is de sonde, en die moet juist bereikbaar blijven op het moment dat je erop hamert omdat je een storing vermoedt.
Publiceren op Reddit
publish_reddit_comment schrijft echt op Reddit
De reactie is openbaar zodra de tool terugkeert, geplaatst vanaf een account uit het SubReply-park achter een residentiële proxy. Verwijderen maakt de melding aan de poster niet ongedaan. Roep deze tool pas aan als een mens de exacte tekst heeft goedgekeurd.
Daarom staat hij standaard uit. Om hem aan te zetten, open je je pagina met API-sleutels en schakel je publiceren in op de betreffende sleutel.
De toestemming hangt aan de sleutel en niet aan het account, en dat is bewust: een sleutel voor een n8n-publicatieworkflow mag hem hebben terwijl een sleutel in een gespreksassistent hem niet heeft. Na een lek breekt publiceren uitzetten op die ene sleutel geen enkele andere integratie.
- Maximaal 5 aanroepen per minuut, ver onder wat de infrastructuur aankan. Een reeks publicaties kost niet alleen saldo: het kost een shadowban.
- De 50 credits worden achteraf afgeschreven, zodra de publicatie bevestigd is. Een mislukking kost niets.
- Deze tool is niet idempotent: twee aanroepen op dezelfde URL laten twee reacties achter. De tweede is gratis, maar hij staat er wel degelijk.
- Reken op twee minuten per aanroep — een echte browser opent de post en typt de reactie. Stel de timeout van je client daarop af.
MCP-specifieke fouten
Een mislukte tool werpt nooit een JSON-RPC-uitzondering op: hij geeft een resultaat terug met isError: true, met een zin die de agent kan lezen. Vier gevallen bestaan alleen aan MCP-kant.
| Geval | Wat de tool teruggeeft |
|---|---|
| Quotum overschreden | isError: true en de wachttijd in seconden. Er wordt niets afgeschreven. |
| Onvoldoende credits | isError: true en het ontbrekende saldo. Vul bij op de facturatiepagina. |
publish_reddit_comment zonder opt-in | isError: true: publiceren staat uit op die sleutel. Zet het aan in je API-instellingen. |
publish_reddit_comment via OAuth | isError: true: publiceren vraagt een API-sleutel, een OAuth-koppeling volstaat niet. |
Het quotumbericht bevat de wachttijd, zodat je agent weet wanneer hij weer verder kan in plaats van te blijven doorlopen:
Rate limit exceeded for generate_reddit_comment:
20 calls per minute maximum. Retry in 34 seconds.
No credits were charged.De weigering komt vóór alle bedrijfslogica: er wordt niets aangeroepen en niets afgeschreven. Een agent die zijn 20 generaties per minuut opbrandt, is geen enkele credit kwijt.
Een lege lijst is geen fout
scrape_reddit_opportunities filtert op versheid, klantsignaal en productfit. Nul resultaten is een normaal antwoord. product_description meegeven maakt veel uit — zonder die beschrijving wijst de drempel voor productfit bijna alles af.De HTTP-codes en het foutformaat van de REST-API staan op de pagina foutcodes.
Volledige foutcodes