# Verbind MCP-servers met je bot Met MCP-servers kan je AI-bot tijdens live gesprekken tools van een ander systeem gebruiken — zonder dat je elke tool handmatig hoeft te bouwen. Je koppelt de bot één keer aan een MCP-server en elke tool die die server aanbiedt, wordt automatisch beschikbaar voor de bot. Als je al eens met Custom Functions hebt gewerkt, is dit hetzelfde idee, maar dan een stap verder: een custom function is één enkele tool die je zelf instelt, terwijl een MCP-server een kant-en-klaar pakket aan tools is die de bot zelf kan ontdekken en aanroepen. --- ## Wat is een MCP-server? MCP (Model Context Protocol) is een open standaard om AI-assistenten toegang te geven tot externe tools. Veel moderne apps en diensten publiceren tegenwoordig een "MCP-server" — een enkel webadres dat een set tools blootstelt die de AI kan aanroepen: iets opzoeken, een record ophalen, een query uitvoeren, een item aanmaken. In plaats van elk hulpmiddel aan de bot te beschrijven, geef je Your AI Connector het adres van de server en een toegangssleutel. Your AI Connector vraagt de server "wat kun je doen?", krijgt de lijst met hulpmiddelen terug en stelt deze beschikbaar aan je bot. Wanneer de server een nieuw hulpmiddel toevoegt, kan je bot dit gebruiken zonder extra configuratie aan jouw kant. **Custom Functions vs. MCP-servers — welke moet je gebruiken:** | | Aangepaste functies | MCP-servers | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Wat je instelt** | Eén tool tegelijk, volledig handmatig (URL, invoer, responskoppeling). | Eén serveradres — de bot ontdekt alle tools voor je. | | **Best voor** | Een enkele, specifieke aanroep naar je eigen systeem. | Verbinden met een service die al MCP spreekt en veel tools aanbiedt. | | **Onderhoud** | Je werkt de functie bij wanneer de tool verandert. | Nieuwe tools van de server verschijnen automatisch. | Je kunt beide tegelijkertijd op dezelfde Agent gebruiken. --- ## Hoe het werkt (de eenvoudige versie) 1. Je **registreert een MCP-server** op de pagina **MCP-servers** — met het webadres en een autorisatie-header (meestal een API-sleutel). 2. Your AI Connector **maakt verbinding en ontdekt** de hulpmiddelen van de server en onthoudt de lijst. 3. Je **schakelt de server in op een Agent**. 4. Tijdens een gesprek, wanneer de klant om iets vraagt waar een hulpmiddel antwoord op kan geven, **roept de bot het hulpmiddel aan**, leest het resultaat en antwoordt op natuurlijke wijze. De klant ziet nooit de techniek erachter — ze krijgen gewoon een antwoord dat gebaseerd is op actuele, betrouwbare informatie. ### Wat een MCP-toolaanroep kost Een toolaanroep van een MCP-server wordt precies hetzelfde gefactureerd als een aangepaste functieaanroep, tegen het AI-kwaliteitsniveau van uw Agent: | AI-kwaliteitsniveau | Credits per MCP-toolaanroep | Met uw eigen Anthropic-sleutel (BYOK) verbonden | |---|---|---| | Pro | 1 credit | 0 credits — draait op uw eigen sleutel | | Economy (verouderd) | 0,5 credits | 0 credits — draait op uw eigen sleutel | | Max | 0,25 credits | nog steeds 0,25 credits, gefactureerd zelfs met uw eigen sleutel verbonden, omdat Max op ons eigen model draait | | Mini | 0,15 credits | nog steeds 0,15 credits, gefactureerd zelfs met uw eigen sleutel verbonden, omdat Mini op ons eigen model draait | --- ## Een MCP-server toevoegen (stap voor stap) Klik in de hoofd-zijbalk onder **AI Studio** op **MCP-servers**. Klik vervolgens op **+ Server toevoegen**. Vul het formulier in: | Veld | Wat in te vullen | Voorbeeld | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Naam** | Een kort label voor de server (ook gebruikt om de tools voor de bot te benoemen). | `Order System` | | **Server-URL** | Het MCP-adres van de server (soms een "endpoint" genoemd), beginnend met `https://`. | `https://tools.mystore.com/mcp` | | **Auth-headernaam** | De header die de server verwacht voor authenticatie. Laat staan als `Authorization` tenzij de documentatie van de server anders aangeeft. | `Authorization` | | **Auth-headerwaarde**| De inloggegevens zelf, in het formaat dat de server verwacht. | `Bearer sk_live_abc123` | ### Kiezen hoe u zich aanmeldt: API-sleutel of OAuth Your AI Connector ondersteunt twee manieren om te verifiëren bij een server. Kies de methode die in de documentatie van de server wordt aangegeven, met behulp van de optie **Authenticatie** bovenaan het formulier: - **API-sleutel / header:** de oorspronkelijke methode die hierboven is beschreven. Je plakt een vaste inloggegeven (een API-sleutel of token) in het veld **Auth Header Value** en Your AI Connector stuurt deze mee bij elk verzoek. Het meest geschikt voor servers die je een langdurig geldige sleutel geven. - **OAuth (inloggen):** voor servers die je vragen om in te loggen in plaats van een sleutel te plakken. Bij OAuth hoef je geen sleutel te kopiëren — je keurt de toegang goed door in te loggen, op dezelfde manier als "Inloggen met Google" op andere sites werkt. **Verbinden met OAuth:** 1. Kies **OAuth** als de authenticatiemethode. De Auth Header-velden verdwijnen en worden vervangen door een **Connect**-kaart — je hebt geen sleutel nodig. 2. Vul de **Naam** en **Server-URL** in en klik op **Opslaan**. De server wordt toegevoegd aan je lijst, maar wordt voorlopig weergegeven als **niet verbonden**. 3. Klik op **Verbinden** bij de server. Er opent een beveiligd inlogvenster waarin je de toegang goedkeurt. 4. Keur het goed en het venster sluit vanzelf. De server wordt nu weergegeven als verbonden en Your AI Connector laadt de bijbehorende hulpmiddelen. Dat is alles. Your AI Connector houdt de verbinding automatisch op de achtergrond actief, dus normaal gesproken hoef je er nooit meer naar om te kijken. Als een server de verbinding ooit verbreekt (bijvoorbeeld als de inlogsessie verloopt of iemand deze aan de kant van de server intrekt), wordt deze als niet verbonden weergegeven — klik simpelweg op **Opnieuw verbinden** en log opnieuw in. Als de server niet automatisch kan worden ingesteld wanneer u op Verbinden klikt, wordt u gevraagd om een paar details te plakken (een aanmeldadres en een client-ID) die in de documentatie van de server zelf staan, waarna het Verbinden de aanmelding voltooit. ### Test de verbinding Klik voordat je opslaat op **Verbinding testen**. Your AI Connector neemt contact op met de server en toont je de lijst met hulpmiddelen die deze aanbiedt. Dit is de snelste manier om te bevestigen dat je URL en sleutel correct zijn — als de verbinding mislukt, zie je de foutmelding direct in plaats van dat je er midden in een gesprek achter komt. Wanneer de test slaagt, klik je op **Opslaan**. Je server verschijnt in de lijst met een groen statusbolletje en het aantal tools dat deze aanbiedt. ### De serverlijst lezen Elke server in de lijst toont: - Een **statusbolletje** — groen wanneer de laatste verbinding werkte, rood wanneer de laatste poging mislukte (beweeg de muis erover voor de foutmelding), grijs vóór de eerste succesvolle verbinding. - Het **adres van de server** en hoeveel tools deze momenteel aanbiedt. - Een **aan/uit-schakelaar** om de hele server snel in of uit te schakelen zonder deze te verwijderen. Your AI Connector ververst de lijst met hulpmiddelen van elke server ongeveer één keer per dag op de achtergrond, zodat nieuwe hulpmiddelen automatisch verschijnen. Een trage of tijdelijk onbereikbare server vertraagt nooit een gesprek — de bot gebruikt simpelweg de laatst bekende lijst met hulpmiddelen en schakelt soepel terug als een aanroep niet kan worden voltooid. ### Kiezen welke tools de bot mag gebruiken Een server biedt vaak meer tools aan dan je wilt dat de bot gebruikt. Je kunt individuele tools in- of uitschakelen zonder de hele server te ontkoppelen. 1. Klik op het **potlood (bewerken)** icoon bij de server in de lijst. 2. Scroll naar de sectie **Tools** — elke tool die de server aanbiedt staat hier vermeld, elk met een eigen aan/uit-schakelaar. 3. Schakel elke tool uit die de bot niet mag aanroepen, of gebruik **Alles inschakelen** / **Alles uitschakelen** om ze in één keer in te stellen. 4. Klik op **Wijzigingen opslaan**. Alleen de tools die je ingeschakeld laat, worden aan de bot aangeboden. Een uitgeschakelde tool is volledig onzichtbaar voor de bot — deze kan de tool niet aanroepen en de tool telt niet mee voor de limiet van 40 tools. Twee dingen die handig zijn om te weten: - **Nieuwe tools blijven uitgeschakeld totdat je ze inschakelt.** Zodra je de tools van een server hebt beheerd, komen alle tools die de server later toevoegt uitgeschakeld binnen, zodat er niets nieuws beschikbaar komt voor de bot totdat je besluit het in te schakelen. (Servers die je nooit hebt beheerd, houden al hun tools ingeschakeld, precies zoals voorheen.) - **Dit staat los van de Agent-keuze hieronder.** Hier bepaal je welke tools van een server überhaupt bestaan, op accountniveau; op de Agent bepaal je welke servers die Agent kan bereiken — en, indien gewenst, beperk je de tools verder voor alleen die Agent. ### Uitvoeringslimieten per tool instellen Naast de aan/uit-schakelaar van elke tool vind je een **Limieten**-knop. Deze opent dezelfde uitvoeringslimieten die je kunt instellen voor een [aangepaste functie](custom-functions.md#execution-limits), maar dan toegepast op slechts die ene tool — handig wanneer een tool van een server een betaalde externe dienst aanroept, of wanneer een tool slechts één keer per gesprek mag worden uitgevoerd. Alles hier is optioneel; laat het leeg en de tool gedraagt zich precies zoals voorheen. - **Alleen-lezen.** Sommige servers geven voor elke tool aan of deze alleen gegevens leest. **Automatisch (serverinstelling)** vertrouwt op die verklaring; je kunt dit echter in beide richtingen overschrijven — markeer een tool als **Alleen-lezen** wanneer je weet dat deze nooit iets aanmaakt of wijzigt (hierdoor kan de AI veilig een onderbroken antwoord opnieuw proberen in plaats van de klant zonder antwoord achter te laten), of als **Niet alleen-lezen** wanneer je de bewering van de server niet vertrouwt. - **Opgeslagen resultaat gebruiken bij herhaalde aanroepen.** Wanneer de AI de tool opnieuw aanroept met dezelfde invoer, wordt het vorige resultaat hergebruikt (tot 24 uur lang) in plaats van de server opnieuw aan te roepen. - **Max. aantal uitvoeringen per gesprek** en **max. aantal uitvoeringen per tijdsvenster** werken precies zoals bij aangepaste functies: alleen succesvolle uitvoeringen tellen mee, en wanneer een limiet wordt bereikt, krijgt de AI te horen waarom en antwoordt deze met de informatie die al beschikbaar is — de klant blijft nooit in het ongewisse. Testgesprekken zijn hiervan vrijgesteld. Eén eerlijke opmerking over vertrouwen: limieten bepalen of en hoe vaak *wij* de server aanroepen — ze kunnen niet veranderen wat de server intern doet zodra deze is aangeroepen. En een externe tool overschrijven naar Alleen-lezen is een sterkere bewering dan bij je eigen aangepaste functie, omdat het de code van iemand anders is; doe dit alleen voor tools die je begrijpt. --- ## Een server inschakelen op een Agent Het registreren van een server maakt deze beschikbaar; je kiest nog steeds welke Agents deze kunnen gebruiken. 1. Open de [Agent](../ai-agents/ai-agents.md) en ga naar het tabblad **AI Abilities**. (Voor een campagne die nog eigen AI-instellingen direct bevat in plaats van via een aparte Agent, verschijnt dezelfde lijst in de stap **AI Abilities** van die campagne zelf.) 2. Zoek de sectie **MCP servers**. 3. Schakel elke server in die de bot van deze Agent moet kunnen gebruiken. 4. Klik op **Save changes** — selecties worden pas toegepast nadat ze zijn opgeslagen. Je kunt maximaal **5 servers per Agent** inschakelen. Alleen de servers die je inschakelt, zijn beschikbaar voor de bot van die Agent, waardoor de bot gefocust blijft op de relevante tools. ### Kiezen welke tools een Agent mag gebruiken Zodra een server is ingeschakeld op een Agent, kun je ook beperken **welke van de tools** die specifieke Agent mag aanroepen — handig wanneer de ene Agent alleen gegevens mag lezen terwijl een andere ook records mag aanmaken. 1. Klik op het tabblad **AI-vaardigheden**, onder de ingeschakelde server, op de rij **"… tools ingeschakeld voor deze agent"** om de toollijst uit te vouwen. 2. Schakel elke tool uit die deze Agent niet mag gebruiken en klik vervolgens op **Wijzigingen opslaan**. Twee regels houden dit voorspelbaar: - **Een Agent kan alleen beperken, nooit uitbreiden.** Tools die je op accountniveau hebt uitgeschakeld (op de pagina MCP-servers) verschijnen hier niet en kunnen niet opnieuw worden ingeschakeld voor een enkele Agent. - **Agents erven standaard over.** Een Agent waarbij je de toollijst niet hebt aangeraakt, volgt simpelweg de selectie op accountniveau — inclusief tools die je daar later inschakelt. Zodra je de lijst van een Agent beperkt, blijven nieuwe tools voor die Agent uitgeschakeld totdat je ze inschakelt. --- ## Kant-en-klaar voorbeeld: Een Shopify-winkel verbinden Elke Shopify-winkel wordt geleverd met een ingebouwde MCP-server — er hoeft geen app te worden geïnstalleerd en er hoeft geen sleutel te worden aangemaakt. Shopify host deze op het eigen webadres van de winkel met `/api/mcp` aan het einde toegevoegd. Wat de bot hiervan krijgt: - **Product zoeken** — vind producten door te beschrijven wat de klant wil ("een warm hardloopjack onder de $100"), met actuele prijzen, varianten en voorraad. - **Productdetails** — volledige informatie over een specifiek product, inclusief opties en beschikbaarheid. - **Winkelbeleid en veelgestelde vragen** — vragen over verzending, retourneren, terugbetalingen en privacy, beantwoord op basis van de eigen pagina's van de winkel. - **Winkelwagen** — stel een winkelwagen samen voor de klant en geef ze een afrekenlink. Om er een te verbinden, voegt u een server toe met: | Veld | Wat in te vullen | |---|---| | **Naam** | `Shopify Store` (of de naam van de winkel) | | **Server-URL** | Het webadres van de winkel plus `/api/mcp` — bijvoorbeeld `https://mystore.com/api/mcp`. Het technische adres van de winkel werkt ook: `https://mystore.myshopify.com/api/mcp`. | | **Authenticatie** | Laat **API-sleutel / header** geselecteerd en laat de **Auth Header-waarde** leeg — deze server heeft geen sleutel nodig. | Sla op, klik op **Verbinding testen** en schakel de server in op uw agent — dat is de volledige configuratie. Twee dingen om te weten: - **Bestellingen staan niet op deze server.** Shopify houdt bestelgegevens bewust weg van dit openbare eindpunt. Voor "waar is mijn bestelling?"-vragen koppelt u deze server aan één aangepaste functie — zie het [Shopify-bestelstatusvoorbeeld](custom-functions.md#complete-example-shopify-order-status). - **Het werkt voor elke Shopify-winkel** — inclusief de winkel van een klant als u accounts voor anderen beheert. Het enige wat u nodig heeft is het webadres van de winkel. --- ## Beveiliging — Verbind alleen servers die je vertrouwt Een MCP-server die je verbindt, kan worden aangeroepen door je bot en kan tekst retourneren die de bot leest en waarop hij actie onderneemt. Behandel dit als elke andere integratie die toegang heeft tot je systemen: - **Registreer alleen servers die je beheert of volledig vertrouwt.** De beschrijving van een tool wordt geschreven door degene die de server beheert, en de bot leest die beschrijvingen om te bepalen wanneer een tool moet worden gebruikt. - **Gebruik een specifieke, beperkte API-sleutel**, geen beheerdersreferentie. Je sleutel wordt veilig opgeslagen en nooit getoond in gegevensexporten. Hetzelfde geldt voor OAuth-aanmeldingen — de toegangstokens worden veilig opgeslagen en uit elke export verwijderd. - **De URL moet een openbaar `https://`-adres zijn.** Interne adressen, localhost-adressen en adressen in privénetwerken worden om veiligheidsredenen geweigerd. - **Schakel een server uit zodra je deze niet meer vertrouwt** — zet de schakelaar uit of verwijder de server, en deze is direct uit elke Agent verdwenen. --- ## Probleemoplossing - **Rode statusstip / verbinding mislukt:** Open de server opnieuw en klik op **Test verbinding** om de exacte foutmelding te zien. De meest voorkomende oorzaken zijn een onjuiste of verlopen sleutel, een typefout in de URL, of dat de server een andere headernaam vereist dan `Authorization`. - **Een OAuth-server werkt niet meer / vraagt om opnieuw verbinding te maken:** OAuth-aanmeldingen kunnen aan de kant van de server worden ingetrokken of verlopen. Open de server en klik opnieuw op **Verbinden** om weer in te loggen. Let op: OAuth-aanmeldingen worden nooit gekopieerd tussen accounts, dus de servers van een gekopieerde Agent of campagne moeten opnieuw worden verbonden in het account waarnaar je deze hebt gekopieerd. - **De bot gebruikt een tool niet:** Controleer eerst of de tool is ingeschakeld in het gedeelte **Tools** van de server (bewerk de server om de lijst te zien) — een uitgeschakelde tool is onzichtbaar voor de bot. Zorg er vervolgens voor dat de server is ingeschakeld voor die specifieke Agent en dat het verzoek van de klant duidelijk overeenkomt met wat de tool doet. Net als bij aangepaste functies helpen duidelijke toolnamen en beschrijvingen aan de kant van de server de bot om de juiste keuze te maken. - **Een tool die de server aanbiedt, verschijnt niet voor de bot:** Als je de tools van deze server hebt beheerd, onthoud dan dat elke tool die wordt toegevoegd nadat je deze hebt beheerd, uitgeschakeld binnenkomt. Bewerk de server, open het gedeelte **Tools** en schakel de tool in. - **Verwerkt de connector MCP HTTP-sessies?** Ja. Als je server een `mcp-session-id`-header uitgeeft wanneer de verbinding tot stand is gebracht, slaan we deze op en sturen we deze bij elk volgend verzoek terug, samen met de `MCP-Protocol-Version`-header. Stateful servers werken zonder extra configuratie aan jouw kant. - **Een tool werd overgeslagen:** Een Agent kan maximaal 5 servers en 40 MCP-tools tegelijk gebruiken. Als een server een zeer groot aantal tools aanbiedt, worden sommige mogelijk niet geladen — schakel de tools die je niet nodig hebt uit in het gedeelte **Tools** van de server, of zorg dat elke server zich richt op de tools die je daadwerkelijk gebruikt. --- ## Planvereisten MCP-servers maken deel uit van de ontwikkelaarstoolset, naast aangepaste functies. Als je **MCP-servers** niet ziet in het gedeelte AI Studio van de zijbalk, bevat je huidige abonnement dit niet — upgrade naar een abonnement met ontwikkelaarstools om dit in te schakelen. --- ## Volgende stappen - [Aangepaste functies](custom-functions.md) — koppel handmatig een enkele tool in plaats van een volledige server te verbinden. - [AI-agents](../ai-agents/ai-agents.md) — waar MCP-servers worden ingeschakeld voor een bot. - [AI-agents](../ai-agents/ai-agents.md) — de hoofdpagina van de AI Studio-groep waar MCP-servers zich bevinden.