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 werkt namens de gebruiker die toestemming gaf. Zonder integrationId gebruiken tools de gekoppelde portal; met integrationId een andere portal waar die gebruiker toegang toe heeft. 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.
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.
Projectminiatuur
get_project en list_projects geven thumbnail of null terug. Upload met
upload_project_draft_image en geef input: { thumbnail: { draftFileId: "bestand-uuid" } }
aan update_project_draft. Een bestaande miniatuur van hetzelfde project gebruikt { id }.
Een galerijafbeelding vereist een aparte upload. Weglaten behoudt de miniatuur;
thumbnail: null verwijdert deze na publicatie. De galerij blijft ongewijzigd.
Voorbeeld, revisie en afzonderlijke publicatiegoedkeuring blijven vereist.
Formulieren en bieden
create_project_draft en update_project_draft accepteren bestaande workflowId en
preValidationWorkflowId uit dezelfde portal. De eerste accepteert GENERAL of
BIDDING, de tweede alleen PRE_VALIDATION. Met null verwijder je de koppeling.
Deze tools maken of wijzigen geen formulieren.
Met settings: { isBiddingActive: true, biddingStatus: "open" } bereid je bieden voor.
De statussen zijn not-started, open, closed en cancelled. Andere instellingen
blijven behouden. Publicatie na goedkeuring kan openbaar bieden inschakelen, maar
publiceert geen biedlogboek. Revisies, portalrechten en abonnementslimieten blijven
gelden. Concepten uit het dashboard kun je alleen daar afronden.
Wordt Content-toegang na opnieuw verbinden geweigerd? De toestemming kan niet verder
gaan dan allowedScopes van de OAuth-client. Registreer een client met content:read
en content:write, verbind opnieuw en keur deze scopes goed. Bestaande clients en
toestemmingen worden niet automatisch uitgebreid.