Skip to content
Kibi Connect
Handboek Kibi Connect

MCP-interface: AI-assistenten verbinden

Bijgewerkt op Leestijd: 10 min

Op deze pagina

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

Info

De pagina MCP-servers is beschikbaar voor systeemadministrators. Wie AI-assistenten mag verbinden, stel je in via het recht „AI-assistenten verbinden via MCP“ in de rollen. Standaard hebben alleen systeemadministrators dit recht.

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 in een groep 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.

De MCP-server in de administratie#

Open Administratie → Integraties → MCP-servers. De pagina heeft vier tabbladen.

Tabblad „Overzicht“ van de pagina MCP-servers met de vrijgegeven rollen en de verbindings-URL
  • Overzicht: Onder Wie mag AI-assistenten verbinden? zie je welke rollen dit recht hebben. Daaronder staan de verbinding-URL, die je aan je medewerkers doorgeeft, en een korte uitleg over het inloggen.

  • Verbonden clients: Alle AI-assistenten die toegang hebben tot jouw platform, met gebruik en laatste toegang.

  • Beveiliging: Welke clients nieuwe verbindingen mogen maken, wat er gebeurt bij nieuwe AI-assistenten en wie op de hoogte wordt gesteld.

  • Handleiding & techniek: Een kant-en-klare tekst om te kopiëren (Handleiding kopiëren), die medewerkers in hun AI-chat kunnen plakken. De assistent begeleidt hen stap voor stap door de instellingen. Daaronder staan onder Technische adressen de eindpunten, voor het geval een programma daarom vraagt.

Op de kaart MCP-servers onder Integraties → Overzicht zie je ook voor wie MCP geldt: Actief voor: en de rollen, of Uit met de melding Niet vrijgegeven voor enige rol.

Waarschuwing

Welke tools een assistent mag gebruiken, stel je niet in op de MCP-server. Dit wordt bepaald door drie dingen: of een rol van de persoon het recht „AI-assistenten verbinden via MCP“ heeft, welke modules actief zijn op jouw platform en welke aanvullende rechten de persoon heeft. Een externe assistent ziet en doet nooit meer dan wat de persoon zelf op het platform mag.

Wie AI-assistenten mag verbinden#

Of een persoon AI-assistenten mag verbinden, wordt alleen bepaald door diens rol.

Recht voor rollen vrijgeven#

Open Administratie → Integraties → MCP-servers, tabblad Overzicht.

Klik op Rollen openen. De catalogus met machtigingen opent direct met het recht AI-assistenten verbinden via MCP.

Dialoogvenster „AI-assistenten verbinden via MCP“ met de rollenlijst, Systeemadmin is aangevinkt

Vink de rollen aan die het recht moeten krijgen. Alles toestaan en Alles intrekken wijzigen alle rollen in één keer.

Klik op Opslaan.

Het dialoogvenster Wijziging bevestigen toont hoeveel personen het recht krijgen of verliezen. Bevestig met Opslaan.

Bij eigen en aanpasbare rollen vind je het recht ook in de rol-editor: Administratie → Rollen & rechten, open de rol, tabblad Machtigingen, register Systeem, sectie AI-assistenten (MCP). De rol Systeemadmin is in de rol-editor alleen-lezen. Voor deze rol wijzig je het recht alleen via de hierboven beschreven dialoog.

  • 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 ze 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 vrijgaveverzoek aan de administratie.

  • Recht ingetrokken: Verliest een persoon het recht, dan blokkeert het platform onmiddellijk al zijn bestaande verbindingen. Als ze het recht terugkrijgen, werken de verbindingen weer.

MCP helemaal uitschakelen#

Om de interface volledig uit te schakelen, klik je in de hierboven beschreven dialoog op Alles intrekken en sla je op. Dit geldt bij dit ene recht uitzonderlijk ook voor de rol Systeemadmin. Heeft geen enkele rol het recht meer, dan vindt geen enkele AI-assistent de interface: inloggen en registreren geven „niet gevonden“ (404) terug, verbonden assistenten verliezen de toegang. In het tabblad Overzicht staat dan Niet vrijgegeven voor enige rol. Een eigen aan/uit-schakelaar is er niet.

Waarschuwing

„Terugzetten naar standaard“ geeft de rol Systeemadmin het recht terug. Het dialoogvenster wijst daar op: als MCP op dat moment voor geen enkele rol is vrijgegeven, is het daarna weer ingeschakeld.

Beveiliging: welke assistenten zich mogen verbinden#

Wie mag verbinden, wordt geregeld door de rollen. Onder Beveiliging stel je in wát: elke AI-assistent met een https-adres kan zichzelf registreren bij jouw platform (Dynamic Client Registration). Toegang krijgt hij pas als een persoon met het recht inlogt en op de toestemmingspagina uitdrukkelijk toestemming geeft.

Tabblad „Beveiliging“ met de kaarten „Toegestane clients“ en „Nieuwe AI-assistenten“

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

Wijzigingen op dit tabblad gelden pas als je rechtsboven in de kop van de pagina op Opslaan klikt. Daarna toont de knop weer Opgeslagen.

Alleen bekende clients toestaan#

Met de schakelaar Alleen bekende clients toestaan in de kaart Toegestane clients beperk je nieuwe verbindingen tot een lijst met domeinen. De lijst is vooraf ingevuld met bekende clients: Claude, ChatGPT, Cursor, Langdock en Microsoft Copilot Studio. Je kunt items verwijderen of eigen domeinen toevoegen, tot maximaal 20 items (alleen het adres met https:// zonder pad, bijvoorbeeld 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 indien nodig in.

Nieuwe AI-assistenten: melden of vrijgeven#

In de kaart Nieuwe AI-assistenten stel je 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 ontvangt een melding zodra iemand een AI-assistent voor het eerst verbindt. Zo valt een ongewenste toegang snel op en kan deze worden ingetrokken.

  • Vrijgave door admin vereist: Een nieuwe AI-assistent krijgt pas toegang als de administratie dit toestaat. De persoon wacht dan. Assistenten op de lijst Toegestane clients zijn al vrijgegeven. Zolang Alleen bekende clients toestaan aan staat, is deze optie niet beschikbaar, want dan kan alleen verbinden wat op de lijst staat.

Bij Alleen melden kies je daaronder onder Wie wordt op de hoogte gesteld?, bij vrijgave onder Wie wordt op de hoogte gesteld en geeft vrij?: Alle admins of Bepaalde admins. Valt een geselecteerde persoon af, dan gaan meldingen weer naar iedereen.

Zo verloopt de vrijgave#

Een persoon verbindt een AI-assistent waarvan het adres nog niet is vrijgegeven. Na het inloggen ziet deze een wachtpagina: „Laat dit venster open“. Zodra de vrijgave er is, gaat het daar vanzelf verder.

De geselecteerde admins ontvangen een push-melding en in de chat een kaart. Een klik daarop opent het dialoogvenster AI-assistent controleren: naam, adres, of de assistent geverifieerd of onbekend is, hoeveel personen al verbonden zijn en wie de aanvraag heeft gedaan. Een klik op de naam opent een chat met deze persoon.

Met Toestaan wordt het adres vrijgegeven: alle latere verbindingen van dezelfde assistent gaan zonder nieuwe aanvraag door. Met Weigeren kun je optioneel een reden opgeven die de persoon in zijn melding ziet.

Heeft de persoon het wachtvenster gesloten, dan ontvangt deze een melding dat de assistent is vrijgegeven en dat hij deze nu opnieuw kan verbinden, of dat deze niet is vrijgegeven, inclusief reden.

  • Geweigerde aanvragen later toestaan: Onder Beveiliging → Aanvragen staan openstaande en geweigerde aanvragen. Een geweigerde aanvraag kan daar achteraf met Toch toestaan alsnog worden vrijgegeven.

  • Assistenten op de eigen computer: Lokale assistenten zoals Claude Code of programma's in de ontwikkelomgeving (IDE) hebben geen vrijgave nodig.

  • Bestaande verbindingen: Als je de vrijgave inschakelt, blijven bestaande verbindingen geldig.

Assistenten verbinden (handleiding voor medewerkers)#

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

Info

Voorwaarde: Een van je rollen heeft het recht „AI-assistenten verbinden via MCP“. Heb je dit niet, dan zie je in je profiel geen sectie AI-assistenten (MCP). Neem dan contact op met je administratie.

Voer de verbindings-URL in je AI-assistent in (zie instellingen per programma). Je vindt deze in je profiel onder het tabblad Integraties bij AI-assistenten (MCP).

De assistent meldt zich automatisch aan bij jouw platform en opent een browservenster met de inlogpagina.

Log in. Op de toestemmingspagina zie je wat de assistent mag lezen en in jouw naam mag doen, en waar de toegang naartoe gaat.

Toestemmingspagina „Toegang toestaan“ met gele waarschuwing voor een onbekende client

Klik op Toegang toestaan.

Klaar: de assistent werkt vanaf nu in jouw naam. De toegang geldt 365 dagen.

Tip

Kom je na het inloggen op het dashboard in plaats van op de toestemmingspagina, start dan de verbinding in de AI-assistent gewoon nog een keer. Omdat je nu ingelogd bent, verschijnt de toestemmingspagina direct.

Waarschuwing

Geel bericht op de toestemmingspagina: als de toepassing geen bekende client is, noemt de waarschuwing het adres waar de vrijgavecode naartoe gaat. Sta de toegang alleen toe als je de verbinding zelf hebt ingesteld.

Heeft de administratie de vrijgave van nieuwe AI-assistenten ingeschakeld en is de assistent nog niet vrijgegeven, dan verschijnt na het inloggen een wachtpagina. Laat het venster open; na de vrijgave gaat het vanzelf verder. Wie het sluit, ontvangt een melding en verbindt de assistent na de vrijgave gewoon opnieuw.

Eigen assistenten in het profiel#

In je profiel is er onder het tabblad Integraties de sectie AI-assistenten (MCP). Deze is alleen zichtbaar als een van je rollen het recht heeft.

Sectie „AI-assistenten (MCP)“ in het profiel met verbindings-URL en een verbonden assistent
  • Verbindings-URL: Het adres om in te voeren in de AI-assistent, met Kopiëren, en een korte uitleg onder Zo werkt het.

  • Jouw AI-assistenten: Je eigen verbindingen met naam, adres, aanduiding (bijvoorbeeld Onbekende client), Verbonden sinds, Laatste toegang en Actieve toegang. Als de vrijgave door admins is ingeschakeld, staan hier ook je eigen aanvragen: Wacht op vrijgave, Niet vrijgegeven (met reden, indien opgegeven) of Vrijgegeven – nu opnieuw verbinden.

  • Verbinding verbreken: Beëindigt direct de toegang van de assistent tot je inhoud. Dit geldt alleen voor je eigen verbinding: andere personen die dezelfde assistent gebruiken, blijven verbonden. Om hem opnieuw te verbinden, log je in de assistent opnieuw in.

  • Handleiding voor je AI-assistent: Een uitklapbare tekst om te kopiëren. Plak deze in de AI-chat, en de assistent begeleidt je stap voor stap door de instellingen.

Instellingen per programma#

Vervang jouw-platform door het adres van jouw platform. De exacte verbindings-URL staat in het tabblad Overzicht en in je profiel.

  • Claude (claude.ai of Claude Desktop): Instellingen → Connectors → Voeg een aangepaste connector toe. URL: https://jouw-platform.kibi.de/api/mcp. Kies daarna „Verbinden“ en log in in de browser.

  • Claude Code: Voer in de terminal claude mcp add --transport http kibi https://jouw-platform.kibi.de/api/mcp uit, open daarna in Claude Code /mcp en start de inlogprocedure.

  • Langdock: Voeg in de Langdock-workspace onder Integraties een eigen MCP-server toe, URL https://jouw-platform.kibi.de/api/mcp, kies authenticatie „OAuth 2.0 (Dynamic Client Registration)“, verbind dan en log in 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 log in in de browser.

  • ChatGPT en andere programma's: Maak een MCP-server aan van het type „Streamable HTTP“ met de verbindings-URL en authenticatie „OAuth“.

Taken aanmaken via een AI-assistent#

Een verbonden assistent kan voor jou taken aanmaken uit een vergaderverslag, bijvoorbeeld met dit verzoek: „Maak uit dit verslag de taken aan in de groep Verkoop, met het trefwoord Verslag, en hang het verslag aan de eerste taak.“

Taak die een AI-assistent in de groep „Verkoop“ heeft aangemaakt, met status „In behandeling“, trefwoord „Verslag“ en een subtaak

Daarbij kan de assistent:

  • In een groep aanmaken: De naam van de groep is voldoende. Dit werkt in je eigen groepen waar taken zijn ingeschakeld. Een groepsopdracht blijft on toegekend als je niemand noemt. Zonder groep ontstaat een persoonlijke taak voor jou.

  • Als subtaak aanmaken: De taak komt dan onder een bestaande taak te hangen en behoort tot diens groep.

  • Trefwoorden instellen en daarop zoeken: De assistent wijst trefwoorden toe en vindt taken terug via een trefwoord.

  • De status instellen: Een nieuwe taak start als Te doen, In behandeling of Afgerond.

  • Bestanden bijvoegen: De assistent voegt bestanden toe aan een taak die je mag zien, of een bestand dat hij net heeft geüpload. De taak krijgt een kopie; het origineel blijft waar het is.

Vindt de assistent geen passende groep van jou, dan maakt hij niets aan en meldt dit.

Logboek en intrekking#

Tabblad „Verbonden clients“ met een client, de aanduiding „Onbekend domein“ en de actie „Intrekken“
  • Logboek: Elke oproep van een externe assistent wordt gelogd.

  • Verbonden clients: Het tabblad toont per client naam en adres, of deze Geverifieerd is of een Onbekend domein gebruikt, de actieve toegang en de laatste toegang. Een klik op de regel opent de details met status, Terugkeeradressen, Gebruikt door en Verbonden sinds.

  • Intrekken: Beëindigt direct de toegang van een client; al zijn toegangsmogelijkheden worden ongeldig. De vermelding blijft in de lijst staan en toont dan Geen actieve toegang. De assistent moet opnieuw worden ingesteld. Zonder intrekking geldt een toegang 365 dagen.

  • Verbinding verbreken in profiel: Iedere persoon kan zijn eigen verbinding zelf verbreken. Andere personen die dezelfde assistent gebruiken, blijven verbonden.

Kai uitbreiden met externe tools#

Externe MCP-servers koppel je als derdesysteem. De uitgebreide handleiding staat op de pagina Hoe koppel ik een derdesysteem aan Kibi?.

Open Administratie → Integraties → Derdesystemen.

Klik op Derdesysteem aanmaken en kies als Type MCP-server (tools voor Kai).

Voer naam, adres (alleen https) en de inloggegevens in, en maak het derdesysteem aan.

Bekijk op de detailpagina welke tools de server aanbiedt, en stel in wie ze mag gebruiken.

Met Persoonlijke connectors toestaan mogen medewerkers daarnaast eigen MCP-connectors alleen voor zichzelf aan Kai koppelen. De schakelaar vind je in de administratie onder AI & workflows in de Instellingen van Kai. Als deze aan staat, vinden medewerkers in Kai onder Instellingen het tabblad Connectors en stellen daar hun verbindingen in. Zulke verbindingen zijn alleen voor de betrokken persoon zichtbaar.

Waarschuwing

Privacy: verzoeken aan externe MCP-servers verlaten jouw platform. Koppel alleen diensten die jij en je medewerkers vertrouwen. Elk toolgebruik wordt gelogd, en in de chat is zichtbaar wanneer Kai een externe tool gebruikt.

Veelgestelde vragen#

  • Waarom kan ik geen AI-assistent verbinden? Waarschijnlijk heeft geen van je rollen het recht „AI-assistenten verbinden via MCP“. Dan toont de toestemmingspagina de melding dat de verbinding voor jouw account niet is vrijgegeven, en ontbreekt in je profiel de sectie AI-assistenten (MCP). De administratie kan het recht aan meer rollen geven.

  • 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. Je stuurt de toegang via de rechten van personen en de actieve modules, of je neemt het recht van alle rollen weg.

  • Wat betekent de gele waarschuwing op de toestemmingspagina? De toepassing 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 MCP-servers → Beveiliging bij Nieuwe AI-assistenten de optie Vrijgave door admin vereist in.

  • Hoe ontnem ik een assistent de toegang? Klik in het tabblad Verbonden clients bij de client op Intrekken. Iedere persoon kan zijn eigen assistent ook in het profiel met Verbinding verbreken zelf verbreken.

  • Kan een assistent taken van een groep aanmaken? Ja, in je eigen groepen, ook als subtaak, met trefwoorden, status en bestanden. Meer hierover onder „Taken aanmaken via een AI-assistent“.

  • 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? Neem het recht via Rollen openen met Alles intrekken van alle rollen weg. Daarna vindt geen enkele AI-assistent de interface meer; verbonden assistenten verliezen direct de toegang.