MCP-acties

MCP (Model Context Protocol) is een open standaard waarmee een AI de tools van een andere dienst rechtstreeks kan gebruiken. Je hoeft geen endpoint en parameters met de hand te beschrijven: een MCP-server publiceert zijn eigen tools, die je AI-agent ontdekt en gebruikt.

Voor de meeste diensten volstaat één klik om verbinding te maken. Ga naar Acties en MCP’s, klik op + Actie toevoegen en kies MCP.

Controleer een voorbeeld van een MCP-verbinding met de documentatie van Cloudflare of het Microsoft Learn-endpoint. Deze controle voert alleen initialisatie- en toollijstverzoeken uit, zonder aanmelding of uitvoering van tools.

Optionele configuratietools

• Bekijk een voorbeeld van MCP-geheugenkoppelingen. Pas opgegeven geheugenregels toe op een voorbeeldresultaat van een MCP-tool zonder een tool aan te roepen of het gespreksgeheugen te wijzigen.

• Vergelijk MCP-toollijsten. Vergelijk twee opgegeven toollijsten en ingestelde activeringsopties op gewijzigde definities en aandachtspunten. Dit maakt geen verbinding met een server en bewijst geen compatibiliteit.

• Controleer de richting van een MCP-verbinding. Stel configuratiegegevens op aan de hand van een openbaar endpoint en een gekozen doel. Dit accepteert geen inloggegevens, maakt geen verbinding met een server en wijzigt je account niet.

Verbinding maken vanuit de catalogus

Het MCP-scherm opent een doorzoekbare catalogus met bekende diensten, ingedeeld in categorieën (Populair, Klantenservice, CRM en verkoop, Planning, E-commerce, Betalingen en facturatie, Marketing en e-mail, Communicatie, Productiviteit, Data en analyse, Zoeken en web, Reizen en boeken, Ontwerp, Ontwikkeling en infrastructuur).

1. Zoek de gewenste dienst door te bladeren of via het zoekvak.
2. Klik op de tegel. Quickchat controleert de server en ontdekt welke tools die aanbiedt.
3. Als de dienst vereist dat je je aanmeldt, verschijnt het paneel Autorisatie vereist. Klik op Verbinden met <dienst>, keur de toegang goed in het pop-upvenster en het paneel toont dat de verbinding is gemaakt.
4. De actie wordt aangemaakt en ingeschakeld, en de tools worden weergegeven. Je AI-agent kan ze vanaf het volgende bericht gebruiken.

Opmerking

Quickchat bewaart de actie en de autorisatie die nog in behandeling is als je na het starten van de autorisatie het actiepaneel of pop-upvenster sluit. Open de actie opnieuw en klik op Autorisatie opnieuw openen om door te gaan, of op Annuleren om te stoppen. Als de aanbieder de autorisatie voltooit nadat je het paneel hebt gesloten, rondt Quickchat de verbinding op de achtergrond af en schakelt de actie in wanneer je abonnement daar ruimte voor heeft.

Tip

Je browser moet pop-ups voor het Quickchat-dashboard toestaan, anders kan het autorisatievenster niet openen. Als het wordt geblokkeerd, verschijnt een bericht waarin je wordt gevraagd pop-ups toe te staan en het opnieuw te proberen.

Een server verbinden die niet in de catalogus staat

Klik onder de catalogus op Handmatig een URL invoeren en doe het volgende:

1. Plak de MCP-server-URL (moet beginnen met https://).
2. Als de server een statisch token voor authenticatie gebruikt in plaats van een aanmeldprocedure, open je Verbindingsheaders (optioneel) en voeg je de verwachte header toe, bijvoorbeeld Authorization: Bearer <your-token>.
3. Klik op Verbinden.

Gebruik Catalogus bekijken om terug te gaan naar de tegelweergave. Als je een dienst mist, opent Mis je een integratie? Stel er een voor een vooraf ingevulde e-mail aan ons team.

Kiezen welke tools de AI mag gebruiken

Na het verbinden toont de actie alle tools die de server aanbiedt, elk met een eigen schakelaar. Schakel alles uit wat de AI niet mag aanroepen. Zo kun je de alleen-lezen zoekfuncties van een boekingsserver aan laten staan en de annuleringstool uitschakelen.

Standaardactivatie van tools bepaalt wat er gebeurt wanneer de server later een nieuwe tool toevoegt: aan betekent dat nieuwe tools direct beschikbaar zijn; uit betekent dat je elke nieuwe tool bewust zelf inschakelt.

Sommige catalogusvermeldingen hebben het label Afgestemd door Quickchat. Quickchat heeft deze servers volledig getest en levert een gerichte selectie tools, de benodigde geheugenregels en een Denkbericht voor elke tool. Kies Aanbevolen gebruiken om te zien wat de geteste configuratie zou wijzigen: het venster Aanbevolen instellingen toepassen? toont welke tools worden in- en uitgeschakeld en welke geheugenregels worden ingesteld. Het waarschuwt ook als zelf bewerkte regels worden overschreven. Er wordt pas iets opgeslagen wanneer je de actie opslaat. Je kunt daarna elke tool nog aanpassen.

Tip

Naam van MCP-actie en Beschrijving van MCP-actie zijn labels voor jou en je team. Ze identificeren de actie in de actielijst; de AI leest ze nooit. De AI wordt gestuurd door de toolbeschrijvingen die de MCP-server zelf publiceert, samen met de hoofdprompt van je agent. Benoem daarin de situaties waarin de agent de tools van deze server moet gebruiken (“beantwoord elke projectvraag met de Linear-tools”) en leg waarden vast die het model anders zou moeten raden (“zoek altijd in de workspace acme-eng”). Als je dezelfde server twee keer verbindt, geef je elke verbinding een naam op basis van de taak (“Notion-helpcentrum”, “Notion-supportverzoeken”) in plaats van de leverancier.

Afspraaktijden boeken met Calendly

Wanneer één actie verbinding maakt met de Calendly-server https://mcp.calendly.com en beide onderstaande tools inschakelt, geeft Quickchat ze invoervelden voor lokale tijden. De namen blijven hetzelfde en er worden geen extra conversietools toegevoegd. Als slechts één van de twee tools is ingeschakeld, behoudt die de oorspronkelijke invoervelden van Calendly.

• Beschikbaarheid: event_types-list_event_type_available_times accepteert local_start_time, local_end_time en een IANA-timezone, zoals Europe/London. Geef lokale datums en tijden op in de vorm YYYY-MM-DDTHH:MM:SS. Quickchat zet het bereik om naar UTC volgens de regels van die tijdzone voor die datums, inclusief dagen van 23 en 25 uur bij het verzetten van de klok.
• Boeking: meetings-create_invitee accepteert de local_start_time en booking_timezone van de gekozen optie binnen post_invitee_request. De bestaande invitee.timezone blijft de tijdzone van de klant, die kan afwijken van de tijdzone van de afspraak. Een genodigde in America/New_York kan bijvoorbeeld een tijdslot boeken dat wordt weergegeven in Europe/London.

Neem de lokale tijd en tijdzone over die bij een beschikbare optie worden teruggegeven. Als de teruggegeven tijd een UTC-offset bevat, behoud die dan: deze maakt onderscheid tussen lokale tijden die twee keer voorkomen wanneer de klok wordt teruggezet. Ongeldige of niet-bestaande lokale tijden, dubbelzinnige tijden zonder offset en offsets die niet overeenkomen met de opgegeven tijdzone worden geweigerd.

Een tijdslot aanbieden reserveert het niet. Voordat Quickchat de afspraak aanmaakt, controleert het de huidige beschikbaarheid opnieuw en geeft het de bijbehorende tijdstempel van de aanbieder ongewijzigd door aan Calendly. Als het tijdslot niet meer beschikbaar is, wordt geen boeking geprobeerd. Het boekingsresultaat bevat een lokale weergavetijd voor de bevestiging door de agent; de velden van de aanbieder die Opslaan in geheugen gebruikt, zoals $.resource.event, blijven beschikbaar.

Neem de vereiste goedkeuring van de klant op in je hoofdprompt en bevestig een boeking pas nadat de aanbieder een succesvol resultaat heeft teruggegeven. Stel de tijdzone van de afspraak expliciet vast in het gesprek, ongeacht de browser of het berichtkanaal. Vraag het de klant als dit onduidelijk is, voordat je de beschikbaarheid controleert of een afspraak boekt.

Het resultaat van een MCP-tool in het geheugen opslaan

Klap een tool open en gebruik Opslaan in geheugen als een waarde uit het resultaat later in het gesprek nodig is. Voeg een JSONPath-expressie voor de waarde toe en een Geheugensleutel om deze te identificeren. Je kunt maximaal 10 waarden uit één tool opslaan.

Geheugensleutels worden gedeeld met de API-acties van de agent. Als een API-actie al naar dezelfde sleutel opslaat, meldt het veld Geheugensleutel dit conflict wanneer je opslaat. Kies dan een andere sleutel.

De opgeslagen waarde wordt onderdeel van de gespreksgegevens die de AI in latere beurten kan lezen. Een boekingstool kan bijvoorbeeld een evenement-URI opslaan, zodat een annuleringstool precies weet welke afspraak moet worden geannuleerd. MCP-tools gebruiken niet de placeholder {{metadata_<key>}} van API-acties, omdat de AI hun argumenten rechtstreeks aanlevert.

De bulkacties Alles inschakelen en Alles uitschakelen laten geheugenregels intact. Opnieuw verbinden behoudt ook je toolkeuzes en geheugenregels terwijl de toollijst van de server wordt vernieuwd.

Wat bezoekers zien

Terwijl een tool wordt uitgevoerd, toont de chatwidget een korte statusregel die beschrijft wat de AI doet. Elke tool heeft een veld Denkbericht in het toolpaneel. Als je het leeg laat, wordt de tekst afgeleid van de toolnaam (een tool met de naam search_flights toont “Vluchten zoeken…”). Je kunt ook zelf een tekst invoeren (“Het helpcentrum doorzoeken”). Bij afgestemde servers zijn deze berichten al ingevuld voor de aanbevolen tools. De regel geeft bezoekers nuttige informatie tijdens het wachten, in plaats van alleen een typindicator.

Opnieuw verbinden en de verbinding verbreken

• Opnieuw verbinden: voert de autorisatie opnieuw uit. Gebruik dit als de verbinding is verlopen, als je een ander account wilt autoriseren of als de toollijst van de server is gewijzigd en je de nieuwe tools wilt ophalen.
• Verbinding verbreken: trekt de opgeslagen autorisatie in en haalt de actie offline. De actie blijft in je lijst staan, zodat je later opnieuw kunt verbinden zonder alles opnieuw in te stellen.

Als je de MCP-server-URL van een verbonden actie wijzigt, wordt de autorisatie gewist en de actie uitgeschakeld. Inloggegevens van de ene server worden namelijk nooit voor een andere server gebruikt. Autoriseer opnieuw om de actie weer online te brengen.

Problemen oplossen

Wat je ziet	Wat het betekent
Autorisatie niet afgerond	Klik op Opnieuw proberen. Als je toegang hebt geweigerd, keur die dan bij de volgende poging goed. Neem bij een andere fout contact op met support en vermeld de foutcode uit het bericht.
Verbonden, maar tools laden is mislukt	De autorisatie is geslaagd, maar de toollijst is niet geladen. Klik op Opnieuw verbinden.
Geen tools gevonden op deze server. Probeer opnieuw te verbinden.	De server is geautoriseerd, maar publiceert geen tools. Controleer of het goedgekeurde account toegang heeft tot de verwachte gegevens.
Voer een geldige URL in die begint met https://	De URL kon niet worden gelezen. Gebruik het volledige https://-adres van de server. Quickchat maakt altijd verbinding via https, zodat inloggegevens nooit onversleuteld worden verstuurd.
De actie heeft zichzelf uitgeschakeld	De autorisatie is verlopen of door de aanbieder ingetrokken. Open de actie en klik op Opnieuw verbinden.

Opmerking

MCP-acties tellen mee voor het quotum voor aangepaste acties in je abonnement, net als API-acties.