CivielControl Grondverzet & Infra
Demo aanvragen
Functies AI-agent Voor wie Prijzen Demo Demo aanvragen

Handleiding

Je eigen AI-assistent koppelen aan CivielControl

Je hebt al een Claude-, ChatGPT- of Copilot-abonnement. Deze pagina laat per assistent zien welke knoppen je indrukt om hem aan jouw omgeving te koppelen. Je hoeft niets te installeren en er is geen wachtwoord te delen: je logt in met je eigen CivielControl-account en geeft toestemming, net als bij elke andere koppeling.

Naar Claude Wat mag een agent zien?

Eerst dit: wat mag hij zien, en wat kan hij nooit

Twee beslissingen gelden voor elke assistent hieronder. Neem ze één keer, dan is de rest invullen.

1

Alleen meekijken, of ook vastleggen

Onder Instellingen → AI-agenten kies je één van twee: alleen meekijken, of mag ook vastleggen. Begin met meekijken. Dat is de keuze die niet fout kan gaan, en je kunt hem later verruimen zonder opnieuw te koppelen.

2

Wat een agent nooit kan

Niets verwijderen. Geen factuur versturen of nummeren. Geen werkbon indienen of laten ondertekenen. Geen zelffacturatie voor een ZZP'er. Geen medewerker deactiveren. Die handelingen bestaan niet als gereedschap — ze zijn niet geblokkeerd, ze zijn er gewoon niet.

3

Je adres

Elke assistent hieronder vraagt om één adres. Dat is https://jouwbedrijf.civielcontrol.nl/mcp — met je eigen subdomein. Het staat kant-en-klaar onder Instellingen → AI-agenten, dus kopieer het daar.

Claude (claude.ai en de desktop-app)

Werkt op Free (één connector), Pro, Max, Team en Enterprise.

  1. Open Claude en ga naar Customize → Connectors.
  2. Klik op + en kies 'Add custom connector'.
  3. Plak het adres van je omgeving en bevestig.
  4. Claude stuurt je naar een inlogscherm van CivielControl. Log in met je eigen account.
  5. Je ziet welke assistent toegang vraagt en waartoe. Lees het en klik op toestaan.

Op Team en Enterprise voegt een eigenaar de connector eerst één keer toe onder Organization settings → Connectors; daarna verbindt iedere collega zich er zelf mee, met zijn eigen account en zijn eigen rechten.

Afkoppelen doe je op dezelfde plek, of vanuit CivielControl onder Instellingen → AI-agenten — daar trek je de toestemming in, en dan stopt het meteen.

Claude Code (voor de technische collega)

Onder Instellingen → AI-agenten staat het commando al ingevuld met jouw adres. Kopiëren, in de terminal plakken, klaar. Hier hoort wél een sleutel bij; die zie je één keer, dus bewaar hem in je wachtwoordkluis.

ChatGPT

Op een betaald abonnement. Let op: eigen connectoren zitten bij OpenAI nog achter een ontwikkelaarsstand en zijn niet in elk gesprek bruikbaar — dit is de minst voorspelbare van de vier.

  1. Ga naar Settings → Connectors.
  2. Open Advanced settings en zet Developer mode aan.
  3. Kies 'Add custom connector' en plak het adres van je omgeving.
  4. Doorloop het inlogscherm van CivielControl en geef toestemming.
  5. Onder Configure kies je welk gereedschap deze connector mag gebruiken.

Microsoft Copilot (via Copilot Studio)

Bij Microsoft koppel je niet je persoonlijke Copilot, maar een agent die je in Copilot Studio maakt. Iets meer werk, en daarna kan het hele kantoor hem gebruiken.

  1. Open je agent in Copilot Studio en ga naar Tools.
  2. Kies Add a tool → New tool → Model Context Protocol.
  3. Vul een naam en omschrijving in, en bij Server URL het adres van je omgeving.
  4. Kies OAuth 2.0 als authenticatie en doorloop het inlogscherm van CivielControl.
  5. Klik op Create.

Google Gemini

Alleen via Gemini Enterprise, en alleen door een beheerder: die voegt CivielControl toe als custom MCP-server onder de connectoren. Een persoonlijk Gemini-abonnement kan dit niet.

Cursor, VS Code en andere MCP-clients

Alles wat MCP spreekt kan verbinden. Je hebt twee dingen nodig: het adres van je omgeving en een sleutel uit Instellingen → AI-agenten, die je meestuurt als Authorization-header. Op datzelfde scherm staat het al voorgekauwd.

Bouw je zelf iets? De technische documentatie — welk gereedschap er is, welke rechten het vraagt, welke protocolversies we spreken — staat in je eigen omgeving onder /api/docs/mcp.

Werkt het?

Vraag je assistent: 'welke projecten lopen er?' Krijg je je eigen projecten terug met hun nummers, dan staat de verbinding. Kijk daarna in CivielControl onder Instellingen → AI-agenten: daar zie je de aanroep binnenkomen, met welk gereedschap, hoe laat en met welke uitkomst. Wat een agent doet, staat altijd in dat logboek.

Als het niet lukt

Negen van de tien keer staat er een subdomein van een ander bedrijf in het adres, of ontbreekt /mcp aan het eind. Kopieer het adres opnieuw uit Instellingen → AI-agenten in plaats van het over te typen.
Dan kijkt hij waarschijnlijk in de omgeving van iemand anders, of met te weinig rechten. Kijk in het logboek onder Instellingen → AI-agenten of de aanroep binnenkwam en wat de uitkomst was — 'geweigerd' betekent te weinig rechten, en dan verruim je de toestemming.
Dat is de standaardkeuze en die is expres zo. Wil je meer, laat je beheerder onder Instellingen → AI-agenten 'mag ook vastleggen' kiezen. Sommige dingen blijven ook dan onmogelijk — verwijderen, factureren, een werkbon ondertekenen.
Kijk of de toestemming is ingetrokken onder Instellingen → AI-agenten, of dat iemand alle agenttoegang heeft uitgezet. Die knop stopt alle agenten in één keer; je gewone koppelingen, zoals de boekhouding, blijven dan gewoon draaien.
Dan spreekt jouw assistent een oudere versie van het koppeltaaltje dan wij verwachten. Wij praten twee versies mee, en een assistent die nóg ouder is krijgt van ons te horen welke versie hij wél kan gebruiken. Werkt het daarna nog niet, werk je assistent dan bij naar de nieuwste versie — het ligt in dit geval niet aan je omgeving of je rechten.
Nee. Er hoeft aan onze kant niets per assistent opengezet te worden, en het maakt niet uit of je koppelt vanuit de app, de website of een editor. Wat je koppeling beschermt is de toestemming die je zelf hebt gegeven: zonder die toestemming komt niemand binnen, ook niet vanaf een website die net doet alsof hij jouw assistent is. Intrekken doe je onder Instellingen → AI-agenten.

Nog geen omgeving om aan te koppelen?

Vraag een demo aan, dan zetten we een omgeving voor je klaar en koppelen we je assistent er samen aan.

Demo aanvragen Wat kan een AI-agent hier?