Gidsen
Een AI-client verbinden met MCP
Geef een AI-client toegang tot een werkruimte via OAuth, met dezelfde resourcerechten als het lid.
De connector-URL kopiëren
Open in Squario Account → Verbonden apps en kopieer de MCP-server-URL. Voeg die toe als externe of aangepaste MCP-server in een client die externe OAuth-servers ondersteunt. De URL eindigt op /functions/v1/mcp-server/mcp en verschilt van de REST-basis-URL. Gebruik de URL uit de app.
- De client ontdekt de server, registreert zich en opent het toestemmingsscherm.
- Meld je aan, kies de werkruimte en keur de toegang goed.
- De client ontvangt OAuth-tokens en ontdekt de beschikbare tools.
- Trek de verbinding altijd in via Account → Verbonden apps.
Een toestemming handelt als jij
MCP gebruikt OAuth 2.1 met PKCE, geen API-sleutel van een lid. Tokens binden één lid aan één werkruimte. Lidmaatschap, squaria.mcp, recordzichtbaarheid en veldrechten worden bij elke oproep gecontroleerd. Toegangstokens gelden één uur; refreshtokens 30 dagen en roteren bij gebruik. De client hoort die levenscyclus te beheren.
Ontdekken, valideren, dan schrijven
Begin met describe_resource of describe_capabilities, lees daarna de benodigde records. Gebruik validate_change vóór een wijziging. Tools zijn per resource geparameteriseerd en tegen het werkruimteschema gecertificeerd.
| Doel | Voorbeelden |
|---|---|
| Records | list_records, get_record, resolve_reference, global_search |
| Ontdekking | describe_resource, describe_capabilities, list_data_models, list_custom_fields |
| Wijzigingen | validate_change, create_record, update_record, archive_record, restore_record |
| Werkruimtecontext | list_forms, list_drive_items, list_audit_log, kennistools |
| Weergaven en rapporten | list_views, save_view, save_structural_view, run_report |
Goedkeuring, credits en limieten
Gebruik de goedkeuringsfuncties van je client voor schrijftools. MCP-oproepen gebruiken AI-credits van de werkruimte, niet het REST-quotum; een mislukte tooloproep wordt terugbetaald. Een herhaalde aanroep is een nieuwe oproep met nieuw verbruik. Standaard geldt 60/minuut en 1.000/uur per lid en werkruimte. Een begrensd verzoek geeft 429 met Retry-After.
- Drive-tools tonen metadata, nooit bestandsinhoud.
- MCP biedt geen in-app paginanavigatie of detail-layoutacties.
- Beschikbare tools kunnen per serverrelease veranderen. Gebruik de tooldiscovery van de client als contract.