Handleidingen · AI-agents
Een AI-agent met formbase verbinden
Een AI-agent bereikt formbase via MCP, het protocol dat AI-tools gebruiken om andere apps aan te roepen. Je plakt één URL, logt in, en kiest een werkruimte; de agent kan dan formulieren bouwen, aanvragen versturen en antwoorden lezen in die werkruimte.
Last checked
Voordat je begint
- Een formbase-account dat lid is van de werkruimte die je wilt verbinden.
Een AI-tool die remote MCP-servers ondersteunt. Sommige tools beperken dit tot bepaalde abonnementen; de tabel hieronder linkt naar de eigen handleiding van elke tool.
Het werk van een agent verbruikt geen formbase AI-credits; je eigen AI-tool rekent dat af volgens zijn eigen prijzen. Zie AI-credits & gebruik.
1. Voeg de formbase-server toe aan je AI-tool
Elke tool vraagt om hetzelfde: de server-URL:
https://api.formbase.so/api/mcpLaat een eventueel veld voor client-ID, secret of token leeg. De tool vindt de inlogpagina via de server en registreert zichzelf. Waar je de URL plakt, hangt af van de tool:
| Tool | Waar je de URL toevoegt | Officiële handleiding |
|---|---|---|
| Claude (web, desktop en mobiel) | Customize › Connectors › + › Add custom connector. Een connector die je op claude.ai toevoegt, werkt ook in de desktop- en mobiele app. Op Team en Enterprise voegt een eigenaar hem eerst toe onder Organization settings › Connectors; op Free kun je zelf één aangepaste connector toevoegen. | Anthropic |
| Claude Code | Voer claude mcp add --transport http formbase https://api.formbase.so/api/mcp uit, en typ dan /mcp in Claude Code om in te loggen. | Anthropic |
| ChatGPT | Schakel de ontwikkelaarsmodus in, en ga dan naar Settings › Apps › Create. Formulieren maken en wijzigen vereist ChatGPT Business, Enterprise of Edu, op het web. Op Business schakelt een werkruimtebeheerder de ontwikkelaarsmodus eerst in. | OpenAI |
| Codex | Voer codex mcp add formbase --url https://api.formbase.so/api/mcp uit, en dan codex mcp login formbase. | OpenAI |
| Cursor | Klik op Toevoegen aan Cursor. Of voeg {"mcpServers": {"formbase": {"url": "https://api.formbase.so/api/mcp"}}} toe aan .cursor/mcp.json in je project, of aan ~/.cursor/mcp.json voor elk project. | Cursor |
| VS Code | Voer MCP: Add Server uit vanuit het Command Palette en kies HTTP. | Microsoft |
Elke andere tool die remote MCP-servers met inloggen ondersteunt, werkt op dezelfde manier: zoek naar waar hij een server via URL toevoegt.
2. Inloggen en de werkruimte kiezen
De eerste keer dat de agent formbase gebruikt, opent je AI-tool een formbase-pagina in de browser. Log in als daarom wordt gevraagd. formbase toont dan welke tool het vraagt, wat hij mag doen, en de werkruimtes waartoe je behoort:
Kies de werkruimte en klik op Authorize. De browser keert terug naar je AI-tool. De verbinding bereikt alleen die ene werkruimte; om een andere werkruimte te gebruiken, voeg je formbase een tweede keer toe aan je tool en kies je de andere.
3. Controleren of het werkt
Vraag de agent iets wat alleen formbase kan beantwoorden:
List my formbase forms and whether each one is published.De agent roept formbase aan en antwoordt met de formulieren in de werkruimte die je hebt gekozen. Sommige tools, zoals Claude Code, zeggen eerst dat ze tooldefinities laden: formbase biedt al zijn tools in één keer aan, en de tool haalt de details op van de tools die een taak nodig heeft.
Sommige acties vragen eerst om bevestiging
Een formulier verwijderen, het depubliceren, een aanvraag annuleren en een paar andere acties zijn gemarkeerd voor bevestiging, en de meeste AI-tools vragen het je voordat ze worden uitgevoerd. De prompt komt van je AI-tool, dus controleer de eigen goedkeuringsinstellingen daarvan. De volledige lijst staat in de MCP-serverreferentie.
De verbinding bekijken of verwijderen
Open in formbase OAuth en API-sleutels in de zijbalk van de werkruimte. Je verbinding staat vermeld onder Verbonden apps, met wanneer hij is verbonden en het laatst is gebruikt:
Klik op de knop Verbreken en bevestig. De agent verliest meteen de toegang, en vraagt je de volgende keer dat hij formbase nodig heeft opnieuw om in te loggen.