MCP-interface: AI-assistenten verbinden

Via de MCP-interface verbinden medewerkers externe AI-assistenten zoals Claude, ChatGPT of Copilot met jouw platform. De assistent handelt daarbij altijd namens de persoon en met precies diens rechten. Omgekeerd kan Kai, de AI-assistent van het platform, tools van externe diensten gebruiken.

Wat is MCP?#

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten toegang krijgen tot andere systemen. Kibi Connect gebruikt het in twee richtingen:

• Externe assistenten op jouw platform

  Claude, ChatGPT, Copilot en andere programma's lezen inhoud en handelen namens een ingelogde persoon – bijvoorbeeld wiki-pagina's zoeken, taken aanmaken of afspraken invoeren.

• Kai met externe tools

  Kai gebruikt tools van externe MCP-servers, bijvoorbeeld uit jouw ERP- of CRM-systeem, uit n8n of Notion, zonder dat medewerkers het platform hoeven te verlaten.

Externe AI-assistenten toegang verlenen#

De MCP-server in de administratie#

Open Administratie → Integraties → MCP-servers. Deze pagina is alleen zichtbaar en bewerkbaar voor systeemadmins. Deze heeft vier tabbladen:

• Overzicht

  Onder Wie mag AI-assistenten verbinden? zie je welke rollen het recht „AI-assistenten via MCP verbinden“ hebben. Dit stel je in via de rollen; standaard hebben alleen admins dit recht. Rollen openen leidt direct naar dit recht in de rolleditor. Daaronder staan de verbindings-URL, die je aan je medewerkers doorgeeft, en een korte uitleg over hoe de aanmelding werkt.

• Verbonden clients

  Een tabel met alle AI-assistenten die toegang hebben tot jouw platform: naam en adres van de client, gebruik (actieve toegang) en laatste toegang. Labels tonen of een client Geverifieerd: <adres> is of een Onbekend domein gebruikt. Een klik op een rij opent de details met alle terugstuuradressen. Met Intrekken beëindig je de toegang.

• Beveiliging

  Hier stel je in welke clients zich nieuw mogen verbinden (Alleen bekende clients toestaan), wat er gebeurt bij nieuwe AI-assistenten (Uit, Alleen melden of Goedkeuring door admin vereist) en wie erop de hoogte wordt gesteld. Onder Verzoeken staan openstaande en afgewezen goedkeuringsverzoeken.

• Handleiding & Techniek

  Een kant-en-klare tekst om te kopiëren, die medewerkers in hun AI-chat kunnen plakken – de assistent leidt hen stap voor stap door de instellingen, ook voor Claude, Claude Code, Langdock, Microsoft Copilot Studio en ChatGPT. Daaronder staan de technische adressen (eindpunten), mocht een programma daarom vragen.

Op de kaart „MCP-servers“ onder Integraties → Overzicht zie je ook voor wie MCP geldt: Actief voor: <rollen> of Voor geen rol vrijgegeven.

Wie mag AI-assistenten verbinden#

Of een persoon AI-assistenten mag verbinden, wordt alleen bepaald door zijn rol. Het recht heet „AI-assistenten via MCP verbinden“ en staat in de rolleditor onder Administratie → Rollen & Machtigingen in het tabblad Systeem, sectie AI-assistenten (MCP).

• Standaard

  Alleen de rol Systeemadmin heeft dit recht. Voor andere rollen schakel je het vrij in de rolleditor, bijvoorbeeld via Rollen openen in het tabblad Overzicht.

• Gasten

  Gasten kunnen nooit AI-assistenten verbinden, ook niet via een rol.

• Zonder het recht

  De persoon ziet in het profiel geen sectie AI-assistenten (MCP). Als hij toch een verbinding probeert, toont de toestemmingspagina: „Voor jouw account is het verbinden van AI-assistenten niet vrijgegeven. Neem contact op met je administratie.“ Er ontstaat geen goedkeuringsverzoek aan de administratie.

• Recht ingetrokken

  Verliest een persoon het recht, dan blokkeert het platform zijn bestaande verbindingen direct. Krijgt hij het terug, dan werken ze weer.

• Bestaande platforms

  De eerdere instelling is overgenomen: Overal waar MCP was ingeschakeld, hebben systeemadmins het recht. Andere rollen schakel je vrij in de rolleditor.

MCP helemaal uitschakelen#

Om de interface volledig uit te schakelen, haal je het recht „AI-assistenten via MCP verbinden“ bij alle rollen weg – bij dit ene recht uitzonderlijk ook bij de rol Systeemadmin. Heeft geen rol dit recht meer, dan vindt geen AI-assistent de interface: aanmelding en registratie antwoorden met „niet gevonden“ (404), verbonden assistenten verliezen de toegang.

Beveiliging: welke assistenten zich mogen verbinden#

Wie mag verbinden, wordt geregeld via de rollen. Onder Beveiliging stel je in waarmee: elke AI-assistent met een https-adres kan zichzelf registreren bij jouw platform (Dynamic Client Registration). Toegang krijgt hij echter pas als een persoon met het recht „AI-assistenten via MCP verbinden“ zich aanmeldt en op de toestemmingspagina uitdrukkelijk toestemming geeft. Daar ziet hij wat de assistent mag lezen en in zijn naam mag doen, en naar welk adres de toegang gaat.

Assistenten die zich identificeren via een client-metagegevensdocument – zoals Claude, ChatGPT en VS Code – verschijnen als Geverifieerd, zowel op de toestemmingspagina als onder Verbonden clients.

Alleen bekende clients toestaan#

Onder Beveiliging kun je nieuwe verbindingen beperken tot een lijst met domeinen. Deze lijst is vooraf ingevuld met bekende clients – Claude, ChatGPT, Cursor, Langdock en Microsoft Copilot Studio – en is bewerkbaar: vermeldingen verwijderen of eigen domeinen toevoegen (alleen het adres met https:// zonder pad, bv. https://app.voorbeeld.nl). Met Standaardlijst herstellen haal je de vooraf ingevulde lijst terug.

• Assistenten op de eigen computer

  Programma's zoals Claude Code, die op de computer van de persoon draaien, blijven ook met ingeschakelde beperking toegestaan.

• Bestaande verbindingen

  Het inschakelen trekt niets in. Controleer daarom onder Verbonden clients of daar iets staat dat niet op de lijst staat, en trek het zo nodig in.

Nieuwe AI-assistenten: melden of goedkeuren#

Onder Beveiliging stel je in de kaart Nieuwe AI-assistenten in wat er gebeurt als iemand voor het eerst een AI-assistent verbindt:

• Uit

  Geen melding. Iedere persoon bevestigt de verbinding zelf.

• Alleen melden

  De administratie krijgt een melding zodra iemand een AI-assistent voor het eerst verbindt. Zo valt een ongewenste toegang snel op en kan deze worden ingetrokken.

• Goedkeuring door admin vereist

  Een nieuwe AI-assistent krijgt pas toegang als de administratie hem toestaat. De persoon wacht dan. Assistenten op de lijst van toegestane clients zijn al goedgekeurd. Zolang „Alleen bekende clients toestaan“ aan staat, is deze optie uitgeschakeld – dan kan zich immers alleen verbinden wat op de lijst staat.

Daaronder kies je onder Wie wordt op de hoogte gesteld (en keurt goed)? ofwel Alle admins of Bepaalde admins – één of meerdere personen met de rol Systeemadministrator. Als geen van de geselecteerde personen meer admin is, gaan de meldingen en verzoeken weer naar alle admins.

Zo verloopt de goedkeuring#

• Afgewezen verzoeken later alsnog toestaan

  Onder Beveiliging → Verzoeken staan openstaande en afgewezen verzoeken. Een afgewezen verzoek kun je daar met Toch toestaan achteraf goedkeuren.

• Assistenten op de eigen computer

  Lokale assistenten zoals Claude Code of programma's in de ontwikkelomgeving (IDE) hebben geen goedkeuring nodig.

• Bestaande verbindingen

  Als je de goedkeuring inschakelt, blijven bestaande verbindingen geldig.

Assistenten verbinden (handleiding voor medewerkers)#

Er is geen API-sleutel en geen wachtwoord dat doorgegeven moet worden. Iedere persoon verbindt zijn eigen assistent:

Heeft de administratie de goedkeuring van nieuwe AI-assistenten ingeschakeld en is de assistent nog niet goedgekeurd, dan verschijnt na de aanmelding een wachtpagina. Laat het venster open – na de goedkeuring gaat het vanzelf verder. Wie het sluit, krijgt een melding en verbindt de assistent na de goedkeuring gewoon opnieuw.

Eigen assistenten in het profiel#

In het profiel is er in het tabblad Integraties de sectie AI-assistenten (MCP), tussen „Apparaat en apps“ en „API“. Deze is alleen zichtbaar als een van je rollen het recht „AI-assistenten via MCP verbinden“ heeft. Staat er verder niets in het tabblad Integraties, dan ontbreekt zonder dit recht ook het tabblad zelf. De sectie bevat:

• Verbindings-URL

  Het adres om in te voeren bij de AI-assistent, met een knop om te kopiëren, en een korte uitleg over hoe de verbinding werkt.

• Handleiding voor je AI-assistent

  Een tekst om te kopiëren: in de AI-chat plakken, en de assistent leidt stap voor stap door de instellingen.

• Jouw AI-assistenten

  Je eigen verbindingen met naam, doorstuuradres, aanduiding (geverifieerd, bekende of onbekende client), „Verbonden sinds“ en laatste toegang. Een klik op een vermelding opent de details. Als de goedkeuring door admins is ingeschakeld, staan hier ook je eigen verzoeken: Wacht op goedkeuring, Niet goedgekeurd (met reden, indien opgegeven) of Goedgekeurd – nu opnieuw verbinden.

• Verbinding ontkoppelen

  Beëindigt direct de toegang van de assistent tot je eigen inhoud. Dit geldt alleen voor je eigen verbinding: collega's die dezelfde assistent gebruiken, blijven verbonden. Om hem opnieuw te verbinden, meld je je in de assistent opnieuw aan.

Instellingen per programma#

Vervang <jouw-platform> door het adres van jouw platform. De exacte verbindings-URL staat in het tabblad Overzicht en in het profiel onder Integraties → AI-assistenten (MCP).

• Claude (claude.ai of Claude Desktop)

  Instellingen → Connectors → Aangepaste connector toevoegen. URL: https://<jouw-platform>.kibi.de/api/mcp. Kies daarna „Verbinden“ en meld je aan in de browser.

• Claude Code

  Voer in de terminal claude mcp add --transport http kibi https://<jouw-platform>.kibi.de/api/mcp uit, roep dan in Claude Code /mcp aan en start de aanmelding.

• Langdock

  Voeg in de Langdock-workspace onder Integraties een eigen MCP-server toe, voer URL https://<jouw-platform>.kibi.de/api/mcp in, kies authenticatie „OAuth 2.0 (Dynamic Client Registration)“, verbind dan en meld je aan in de browser.

• Microsoft Copilot Studio

  Voeg in de agent onder Tools een nieuwe tool toe van het type „Model Context Protocol“, voer de server-URL in, kies authenticatie „OAuth 2.0“ met dynamische detectie (Dynamic discovery), maak dan de verbinding aan en meld je aan in de browser.

• ChatGPT en andere programma's

  Maak een MCP-server aan van het type „Streamable HTTP“ met de verbindings-URL en aanmelding „OAuth“.

Protocol en intrekking#

• Protocol

  Elke oproep van een externe assistent wordt gelogd.

• Verbonden clients

  Het tabblad Verbonden clients toont per client de naam en het adres, of deze geverifieerd is of een onbekend domein gebruikt, de actieve toegang en de laatste toegang. De details tonen alle terugstuuradressen.

• Intrekken

  Beëindigt direct de toegang van een client; al zijn toegangspogingen worden ongeldig. De assistent moet zich daarna opnieuw verbinden. Zonder intrekking geldt een toegang 365 dagen.

• Verbinding ontkoppelen in het profiel

  Iedere persoon kan zijn eigen verbinding in het profiel onder Integraties → AI-assistenten (MCP) ontkoppelen. Andere personen die dezelfde assistent gebruiken, blijven verbonden.

Kai uitbreiden met externe tools#

Externe MCP-servers koppel je als verbinding: Administratie → Integraties → Derdesystemen, tabblad Connectors.

Met Persoonlijke connectors toestaan mogen medewerkers daarnaast eigen MCP-servers alleen voor zichzelf aan Kai koppelen. Zulke verbindingen zijn alleen zichtbaar voor de betrokken persoon.

Veelgestelde vragen#

• Waarom kan ik geen AI-assistent verbinden?

  Waarschijnlijk heeft geen van je rollen het recht „AI-assistenten via MCP verbinden“. Dan toont de toestemmingspagina „Voor jouw account is het verbinden van AI-assistenten niet vrijgegeven. Neem contact op met je administratie.“ en ontbreekt in het profiel de sectie AI-assistenten (MCP). Standaard hebben alleen systeemadmins dit recht; de administratie kan het aan andere rollen toekennen.

• Welke gegevens ziet een externe AI-assistent?

  Alleen wat de ingelogde persoon zelf mag zien, en alleen uit modules die op jouw platform actief zijn.

• Kan ik afzonderlijke tools voor externe assistenten blokkeren?

  Nee, deze optie bestaat niet meer. Je regelt de toegang via de rechten van personen en de actieve modules – of haalt het recht „AI-assistenten via MCP verbinden“ bij alle rollen weg.

• Wat betekent de gele waarschuwing op de toestemmingspagina?

  De applicatie is geen bekende client. Sta de toegang alleen toe als je de verbinding zelf hebt ingesteld. Wie dit in het algemeen wil uitsluiten, schakelt onder Beveiliging „Alleen bekende clients toestaan“ in.

• Kan ik nieuwe AI-assistenten vooraf controleren?

  Ja. Stel onder Integraties → MCP-servers → Beveiliging bij „Nieuwe AI-assistenten“ de optie „Goedkeuring door admin vereist“ in. Een nieuwe assistent krijgt dan pas toegang als een admin hem toestaat.

• Hoe ontnem ik een assistent de toegang?

  Onder Integraties → MCP-servers in het tabblad Verbonden clients klik je bij de client op „Intrekken“. Iedere persoon kan zijn eigen assistent ook zelf ontkoppelen: in het profiel onder Integraties → AI-assistenten (MCP) op „Verbinding ontkoppelen“.

• Wat kost de MCP-interface?

  Deze is onderdeel van Kibi Connect. Externe diensten die je koppelt, kunnen eigen kosten met zich meebrengen.

• Hoe schakel ik MCP helemaal uit?

  Haalt het recht „AI-assistenten via MCP verbinden“ bij alle rollen weg, ook bij de rol Systeemadmin – bij dit ene recht is dat uitzonderlijk toegestaan. Daarna vindt geen AI-assistent de interface meer; verbonden assistenten verliezen direct de toegang. Let op: „Terugzetten naar standaard“ van de rol Systeemadmin geeft het recht weer terug.