Hoe configureer je een MCP-verbinding?

Inleiding

Om je mobile-calendar-account te verbinden met Claude of ChatGPT, hoef je alleen het serveradres te kopiëren in het paneel, het toe te voegen in de AI-app en toestemming te geven op de website van mobile-calendar. Je configureert de verbinding eenmalig en kunt de toegang op elk moment intrekken. In het artikel Wat is een MCP-server? lees je wat deze functie inhoudt en wat de app kan doen.

Instructies

Het serveradres kopiëren

• Klik in het linkermenu op het tabblad Integraties -> API & MCP.
• Ga naar het tabblad MCP-server.
• Op het scherm verschijnt een kaart ‘MCP-server’ met het serveradres, de verbindingsstappen en de beveiligingsregels.

• Klik in het gedeelte ‘Hoe verbind je?’ op de knop Adres kopiëren.
• Het adres uit het veld MCP-serveradres wordt naar het klembord gekopieerd.

De server toevoegen in de Claude-app

• Open de instellingen in de Claude-app en selecteer Connectoren (Connectors).
• Kies voor het toevoegen van een eigen connector (Add custom connector).
• Voer een naam in voor de connector, bijvoorbeeld mobile-calendar, en plak het gekopieerde serveradres.
• Bevestig het toevoegen van de connector. Verschijnt de knop Connect bij de connector, klik er dan op.
• In je browser wordt het toestemmingsscherm van mobile-calendar geopend.

De server toevoegen in de ChatGPT-app

• Open in ChatGPT in je browser de pagina Plug-ins (Plugins).
• Klik op de knop + en selecteer Add custom MCP server.
• Voer een naam in, bijvoorbeeld mobile-calendar, en plak het gekopieerde serveradres in het veld Server URL.
• Vraagt de app naar de inlogmethode (Authentication), selecteer dan OAuth.
• Bevestig de waarschuwing over het risico (I understand and want to continue) en klik op Create as a plugin.
• Installeer de aangemaakte plug-in om deze in een gesprek te gebruiken.
• Tijdens het verbinden wordt het toestemmingsscherm van mobile-calendar in je browser geopend.

Toestemming geven

• Log in bij mobile-calendar zoals je dat ook in het paneel doet. Je geeft toestemming op de website van mobile-calendar; de AI-app krijgt je wachtwoord niet te zien.
• Controleer op het toestemmingsscherm:
  • de naam en het adres van de app die toegang tot het account vraagt,
  • het account bij ‘Ingelogd als’,
  • de lijst ‘De app kan:’, oftewel de toegangsrechten op basis van jouw rechten.

• Klik op Toestaan om de app te verbinden. Met Weigeren verbreek je de verbinding.
• De app verschijnt in de lijst ‘Verbonden apps’.
• De accounteigenaar ontvangt een bericht met als onderwerp ‘Nieuwe AI-app verbonden met account’ op het e-mailadres van de accounteigenaar. Heeft een medewerker de app verbonden, dan ontvangt die medewerker het bericht ook.

Het gele label ‘App niet geverifieerd’ betekent dat niet kon worden bevestigd wie er achter de app zit, ook als de naam of het adres vertrouwd lijkt. Verbind zo’n app alleen als je zeker weet waar deze vandaan komt.

Een verbonden app gebruiken

• Schrijf in een gesprek met de AI-app wat je nodig hebt, bijvoorbeeld: ‘Welke reserveringen komen er morgen aan?’
• De app leest gegevens uit je mobile-calendar-account of slaat daarin een wijziging op waar je om vraagt.

Een app verbreken

• Ga naar het tabblad Integraties -> API & MCP en open het tabblad MCP-server.
• Zoek in de lijst ‘Verbonden apps’ de app waarvan je de toegang wilt intrekken.

• Klik bij de geselecteerde app op Verbreken.
  • Midden op het scherm verschijnt het venster ‘App verbreken?’.
  • Klik op Verbreken.

• De app verliest meteen toegang tot het account. Je kunt de app later opnieuw verbinden.

Wanneer je abonnement verloopt, verliezen verbonden apps toegang tot het account totdat je het abonnement verlengt.

Apps van medewerkers

Een medewerker verbindt een app met eigen inloggegevens, op dezelfde manier als de accounteigenaar. De app ziet en wijzigt alleen wat de medewerker in het paneel kan zien en wijzigen, volgens diens rechten en toegewezen kamers.

• Verbindingslijst: de accounteigenaar ziet in de lijst ‘Verbonden apps’ ook de apps van medewerkers en kan deze verbreken. De kolom Wie heeft verbonden laat zien van wie de verbinding is. Een medewerker ziet alleen apps die met diens eigen inloggegevens zijn verbonden.
• Rechten wijzigen: dit gebeurt meteen, ook in de verbonden app.
• Toegang verliezen: de apps van een medewerker worden verbroken wanneer de eigenaar diens wachtwoord of e-mailadres wijzigt, diens apparaten uitlogt of de medewerker verwijdert.

Bewerkingen in de logboeken controleren

• Ga naar het tabblad Integraties -> API & MCP en open het tabblad Logboeken.
• Selecteer in het uitklapmenu in het veld Account de optie MCP-server.

• De lijst toont alleen bewerkingen die door verbonden apps zijn uitgevoerd.

De optie MCP-server verschijnt in de lijst nadat je de eerste app hebt verbonden en omvat alle verbonden apps. In het veld Account kun je ook Mobi en je eigen API-accounts selecteren. De overige filters en gegevens van een logboekvermelding worden beschreven in het artikel Logboeken.

Veelvoorkomende problemen

De AI-app vraagt om bevestiging voordat er iets wordt gewijzigd

Claude en ChatGPT kunnen je vragen een bewerking te bevestigen voordat ze een wijziging opslaan. Dit is een beveiligingsmaatregel van de AI-app, geen verbindingsfout. Controleer wat de app wil wijzigen en bevestig of wijs de bewerking af.

De app heeft geweigerd de bewerking uit te voeren

Een externe AI-app voert sommige bewerkingen niet uit. Zo verlaagt de app de prijs niet met de helft of meer, geeft deze geen deurcode door en verstuurt deze geen bericht naar iemand anders dan de gast van de reservering. Voer zo’n bewerking uit in het paneel of met Mobi.

De optie om een server toe te voegen ontbreekt in de AI-app

Of je een eigen MCP-server kunt toevoegen, hangt af van je abonnement bij Claude of ChatGPT. Bij zakelijke abonnementen hangt dit ook af van de rechten die de beheerder heeft toegekend. Raadpleeg de helpfunctie van de betreffende app of vraag het aan de beheerder van je organisatie.

Het toestemmingsscherm is in een andere taal

Klik rechtsboven op het toestemmingsscherm op de taalvlag en selecteer je taal.

De app staat niet in de lijst ‘Verbonden apps’

Klik in de lijst ‘Verbonden apps’ op Vernieuwen. Verschijnt de app nog steeds niet, verbind deze dan opnieuw in de AI-app.