Projecten configureren via MCP
Bereid concepten voor, upload afbeeldingen, koppel agenda's en publiceer na goedkeuring.
Projecten configureren via MCP
Verbinding en rechten
De MCP-server staat op https://api.sparki.app/external-ai/mcp en gebruikt OAuth. De verbinding hoort bij één portal en één gebruiker. Deel beheertokens nooit met browsercode of een CMS.
- Lezen en schrijven hebben afzonderlijke scopes voor projecten, content en agenda's.
- Nieuwe scopes vereisen opnieuw verbinden en expliciete toestemming.
- De beschikbare toolcatalogus via tools/list is leidend.
Goedkeuring bij schrijven
Elke schrijfactie begint met een voorbeeld zonder approved. Na controle herhaal je exact dezelfde argumenten met approved: true en het approvalToken. De goedkeuring verloopt na tien minuten.
- Gebruik bij een herhaling dezelfde idempotencyKey.
- Gewijzigde argumenten vereisen een nieuw voorbeeld.
- Een tool kan nooit naar een andere portal wisselen via een portal-ID.
Beschikbare taken
De MCP-tools kunnen contentvertalingen lezen en bijwerken, projectconcepten voorbereiden, afbeeldingen uploaden, agenda's koppelen en een goedgekeurd concept publiceren. Vertaalde velden gebruiken een object zoals { default: 'Tekst', nlNL: 'Tekst', enGB: 'Text' }.
- Publiceren en beschikbaarheid toevoegen zijn afzonderlijke goedkeuringen.
- MCP maakt geen klantafspraak en wijzigt geen facturatie.
- Controleer nieuwe configuratie altijd eerst in een afgeschermde demoportal.