Koppel een agent

Je agentclient communiceert via één endpoint. Je agent kan je merk- en kanaalgegevens lezen, video’s en teksten genereren, bestanden uploaden, posts inplannen en versturen en de resultaten ophalen.

De agent kan geen socialmediakanaal koppelen of je pakket wijzigen. De scopes en de maandelijkse creditlimiet van het token bepalen hoeveel de agent mag verbruiken. Idempotentiesleutels voorkomen dat je bij opnieuw proberen dubbel betaalt. Om een kanaal te koppelen moet je via een browser inloggen. Je doet dit dus in de app.

Maak een persoonlijk toegangstoken aan in je instellingen. Je krijgt het geheime token maar één keer te zien en het werkt alleen op dit endpoint.

• Scopes bepalen wat je met het token kunt doen: read geeft leestoegang. Voeg generate toe voor alles wat credits verbruikt en publish om posts te plaatsen.
• Beperk het token tot één merk. Het geeft dan alleen toegang tot de kanalen, generaties, posts en teksten van dat merk. De creditportemonnee, uploads, acteurs en producten blijven beschikbaar voor alle merken binnen je account.
• Stel een maandelijkse creditlimiet in. Zodra het maandverbruik die limiet bereikt, kun je met het token geen betaalde aanroepen meer starten. Voor tekst die al wordt gegenereerd, betaal je het werkelijke verbruik. Dat kan iets boven de limiet uitkomen.

1POST https://www.socialfaktory.com/mcp

Streamable HTTP, protocolversie 2025-06-18, bearer-authenticatie via de Authorization-header. Je hoeft geen sessie-id mee te sturen: het token is de sessie. Een GET geeft 405 terug.

Voeg SocialFaktory toe als aangepaste connector in de instellingen van je client en plak dit adres als server-URL. Dit werkt hetzelfde in Claude Desktop, claude.ai, ChatGPT en Gemini. Je hebt geen tussenprogramma of lokaal proces nodig.

1https://www.socialfaktory.com/mcp

• Je hoeft geen token te plakken of client-id aan te maken. De app registreert zichzelf.
• Op het toestemmingsscherm kies je welke scopes je toestaat: read, generate en publish. Je kiest ook voor welk merk de koppeling geldt, hoeveel credits die per maand mag verbruiken en hoelang die geldig blijft.
• Je kunt de koppeling op elk moment verbreken via Instellingen → API-tokens. De app heeft dan meteen geen toegang meer.

1. 1Log in bij SocialFaktory als je dat nog niet hebt gedaan. Het scherm toont de naam van de app die je heeft doorgestuurd.
2. 2Lezen is altijd toegestaan en geeft toegang tot je merken, media en posts. Vink de andere machtigingen aan die je wilt geven. Met Genereren maakt de app video’s en teksten met je credits. Met Publiceren plant en verstuurt de app posts op je kanalen. Vink dit uit totdat je erop vertrouwt dat je briefing het gewenste resultaat oplevert.
3. 3Beperk de koppeling tot één merk of laat alle merken geselecteerd. Dan kan de app publiceren op elk gekoppeld kanaal.
4. 4Kies hoelang de koppeling geldig blijft: 30, 60 of 90 dagen.
5. 5Stel een maandelijkse creditlimiet in of laat het veld leeg als je geen limiet wilt. Klik daarna op Koppelen. Je gaat terug naar de app en kunt meteen aan de slag. De app kan nooit een kanaal koppelen, je pakket wijzigen of namens jou inloggen.

Voor de connectorgids van Claude heeft SocialFaktory een eigen adres. Via die koppeling beheert Claude je account, schrijft posts, uploadt je eigen media en plant en publiceert posts op elk gekoppeld kanaal.

1. Open de vermelding van SocialFaktory in de connectorgids van Claude.
2. Klik op Koppelen. Claude stuurt je naar SocialFaktory.
3. Log in op je SocialFaktory-account.
4. Kies of Claude posts mag schrijven en publiceren. Stel ook het merk, de maandelijkse creditlimiet en de geldigheidsduur van de koppeling in. Bevestig je keuzes. Je gaat terug naar Claude en kunt meteen een briefing geven.

1https://www.socialfaktory.com/mcp/claude

• De connector genereert geen AI-afbeeldingen, video's, stemmen of muziek. Maak die in de app: zodra ze in je mediabibliotheek staan, kan Claude ze inplannen en publiceren.
• Een koppeling via de gids werkt alleen op dit adres. Een koppeling via /mcp werkt alleen op /mcp. Een token dat je zelf plakt, werkt op beide adressen.

Claude Code, Codex en curl koppel je sneller met een token dat je zelf plakt. De voorbeelden hieronder kun je ongewijzigd gebruiken.

Verstuur JSON-RPC 2.0 via POST. Accepteer zowel JSON als het type event-stream en vermeld bij elk verzoek de protocolversie.

1POST https://www.socialfaktory.com/mcp
2Authorization: Bearer sfp_…
3Content-Type: application/json
4Accept: application/json, text/event-stream
5MCP-Protocol-Version: 2025-06-18
6
7{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Bij elke tool staat welke scope nodig is. Zonder die scope wordt de aanroep geweigerd voordat de tool wordt uitgevoerd. Met quote_generation kun je vooraf de prijs van een video opvragen. Dat is optioneel. generate_text reserveert vooraf een paar credits en rekent daarna het werkelijke verbruik voor de tekst af.

Geef dit argument mee bij elke aanroep die credits verbruikt of publiceert. Een herhaling binnen 24 uur geeft het oorspronkelijke resultaat terug, gemarkeerd als herhaling, in plaats van het werk opnieuw uit te voeren.

• 120 aanroepen per minuut per token en 300 verzoeken per 5 minuten per adres.
• Een video klonen via een link en stilstaande afbeeldingen of carrousels genereren is nog niet mogelijk via een agent.

Gemini-app: voeg het adres toe als aangepaste app. De app registreert zichzelf, dus je hoeft geen clientgegevens in te voeren bij de geavanceerde functies. Google staat aangepaste apps momenteel alleen toe voor persoonlijke accounts van gebruikers van 18 jaar of ouder in de Verenigde Staten. De taal moet Engels zijn, de eerste koppeling moet via het web gebeuren en het opslaan van activiteit moet ingeschakeld zijn.

Gemini Enterprise: een beheerder voegt een aangepaste MCP-server toe met de autorisatie- en tokenadressen uit het discovery-document. De client-id en het clientgeheim komen uit een registratie op /oauth/register met token_endpoint_auth_method client_secret_post en het callbackadres van de beheerder. Schakel PKCE in en geef de scopes read, generate en publish op. Alleen Streamable HTTP wordt ondersteund. Dat is het transport dat dit endpoint gebruikt.

Gemini CLI: installeer de extensie. De CLI regelt zelf het inloggen, inclusief het toestemmingsscherm.

1gemini extensions install https://github.com/socialfaktory/socialfaktory-gemini-extension

Beheerde agents van de Gemini API: geef het endpoint op als servertool, met een zelf aangemaakt token in de Authorization-header.

1{
2  "type": "mcp_server",
3  "name": "socialfaktory",
4  "url": "https://www.socialfaktory.com/mcp",
5  "headers": { "Authorization": "Bearer sfp_…" }
6}

Werkt er iets niet of heb je een vraag over een koppeling? Je krijgt binnen één werkdag antwoord. Mail vanaf het e-mailadres van je account naar [email protected]