Publieke API

Een AI-assistent koppelen (MCP)

Maak een API-sleutel met alleen de scopes die de assistent nodig heeft en geef de client het adres https://api.mosaqo.app/v1/mcp met die sleutel als bearer-token. De assistent kan precies wat de sleutel toestaat en niets meer, en u kunt de koppeling altijd verbreken onder Bulk & API.

Gecontroleerd op 20 augustus 2026

Stappen

1. Open Bulk & API → API keys en maak een sleutel. Geef eerst alleen leesscopes; een tweede met schrijfrechten geeft u uit zodra u weet wat de assistent doet.
2. Kopieer het adres uit het blok AI assistants (MCP) op datzelfde scherm.
3. Voeg in de assistent een server met dat adres toe en stuur de sleutel in de header Authorization: Bearer. De meeste clients nemen een JSON-blok met url en headers.
4. Sommige connectors vragen u bij Mosaqo aan te melden in plaats van een sleutel te plakken. Die route laat zien wie het vraagt, welke werkruimte het zou raken en wat het zou kunnen, vóórdat er iets is verleend — alleen een eigenaar of beheerder mag goedkeuren.
5. Vraag de assistent wat hij kan. Hij somt de tools op die uw sleutel toestaat, wat de snelste bevestiging is dat de koppeling zo smal is als bedoeld.

Hoe je het resultaat controleert

Vraag iets dat alleen deze werkruimte weet: hoeveel codes u heeft, of hoe een enquête loopt. Een antwoord met uw echte namen en getallen betekent dat de koppeling werkt; een weigering die een scope noemt betekent dat de sleutel smaller is dan de vraag.

Wat er meestal misgaat

• Meteen schrijfrechten op de eerste sleutel. Begin alleen-lezen en verbreed als u weet wat ermee gebeurt.
• Verwachten dat hij leest wat mensen in een enquête schreven. Die antwoorden gaan niet naar een sleutel of een assistent — scores en aantallen wel, de zinnen blijven in de inbox.
• Verwachten dat hij een code verwijdert. Dat kan hij niet: de doorverwijzing achter een gedrukte code vernietigen is onomkeerbaar, dus krijgt hij archiveren aangeboden, en dat draait terug.
• Een koppeling vergeten. Een via aanmelding gekoppelde assistent houdt toegang tot hij onder Bulk & API wordt ontkoppeld, net zoals een sleutel geldt tot hij wordt ingetrokken.