---
title: Een MCP-server toevoegen
description: Maak een server, kies wie mag verbinden en welke operaties hij aanbiedt, en deel zijn endpoint met de mensen die hem vanuit een AI-client gaan gebruiken.
sidebar:
  order: 2
area: ai
feature: mcp-servers
appPath: /ai/agents/mcp-servers
lastVerified: 2026-11-03
version: "2026-11-02"
audience: admin
related:
  - ai/mcp-servers
  - ai/mcp-servers/connect-an-ai-client
  - settings/users
  - ai
translation:
  source: ai/mcp-servers/add-an-mcp-server.mdx
  sourceSha: 399cbaac900fa77894625d79f0ba31875b615007
---

Je wilt dat het People-team zijn AI-assistent kan vragen wie volgende week begint, zonder die de hele workspace te geven. Een MCP-server is een benoemde bundel operaties met een minimale rol; je maakt hem in twee stappen, eerst de gegevens en dan de operaties, of je begint vanuit een preset, en deelt zijn endpoint uit.

## Voordat je begint

- Je bent admin of owner. Alleen die rollen zien **AI** in de navigatie.
- Kies een naam die niet verandert: kleine letters, cijfers en koppeltekens, beginnend met een letter, tot 63 tekens.
- Zorg dat je weet welke operaties je wilt aanbieden, of welke preset het dichtst in de buurt komt. De kiezer toont alleen operaties die je zelf kunt aanroepen.

![Add MCP server: the details step, before choosing operations.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-add.png)

## Stappen

1. Open in Pyn **AI** in de linkernavigatie, dan **MCP Servers** onder **Agents**.

2. Selecteer **Add**. De pagina **Add MCP server** opent. Wil je in plaats daarvan beginnen vanuit een kant-en-klare bundel, open dan de pijl naast **Add** en selecteer **Add from Preset**. De kiezer heeft twee categorieën, **Read only** (**People Directory**, **Workspace Explorer**) en **Read and write** (**Flow Author**, **Flow Operator**, **Forms and Polls**, **Journey Mapper**, **Onboarding Coordinator**); elke preset toont een beschrijving, hoeveel operaties hij bevat en de rol die hij nodig heeft. Een preset kiezen vult de naam, titel, beschrijving, minimale rol en operaties in, die je allemaal nog kunt wijzigen, en niets bindt de server daarna aan de preset. Een preset toont alleen de operaties die je workspace aanbiedt, en een preset waar dan niets anders dan `core_getTemplate` overblijft wordt niet getoond.

3. Voer de **Name** in (bijvoorbeeld `people-directory`). Het veld legt uit "Lowercase letters, numbers and hyphens. It cannot be changed later."

4. Voer een **Title** en een **Description** in: "Tells people, and their AI client, what this server is for."

5. Kies de **Minimum role**: **Owner**, **Admin**, **Power User** of **User**. "Only people with this role, or one above it, can connect." Selecteer **Next**.

6. Onder **Operations** staat `core_getTemplate` al in de lijst: het laat een client de eigenschappen van een template opzoeken zodat hij de items die hij leest kan duiden, en je kunt het verwijderen zoals elke andere operatie. Zoek om elke verdere operatie toe te voegen. Elke operatie draagt een chip **Read** of **Write**, en de regel onder het zoekvak telt "n / 100 selected", gevolgd door de grootte van de toollijst die de gekozen operaties vormen, in kilobytes en een geschat aantal tokens (bijvoorbeeld "108 KB · ≈31,000 tokens"): die lijst laadt een AI-client telkens wanneer hij verbindt. Boven 256 KB meldt een notitie "A tool list this large takes a noticeable slice of the AI client's context on every connect. Consider offering fewer operations." Verwijder er een door zijn rij te selecteren; het prullenbakicoon aan het einde ervan geeft aan wat het selecteren van de rij doet.

7. Selecteer **Add**. Het paneel van de server opent rechts.

> **Note:** Mislukt het opslaan, dan toont de pagina "The server could not be saved. If you are adding a server, its name may already be in use." Een gearchiveerde server geeft zijn naam vrij.

## Wat je zou moeten zien

![Select a server to open its panel: edit the description, copy the address AI clients connect to, and see its operations; Advanced holds the minimum role and schema size.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-panel.png)

Het paneel opent met een callout, "AI clients connect to this address.", boven het adres, een link **How to connect an AI client** die die handleiding opent in het Help-paneel over de pagina, en een knop **Copy URL**. De knop leest even **Copied** nadat je hem hebt geselecteerd. Onder de callout staan twee tabbladen. **Operations**, met het aantal in zijn label, bevat de beschrijving, die je ter plekke bewerkt (een lege beschrijving leest **(No Description)**), en daarna de operaties, elk met hun chip **Read** of **Write**. **Advanced**, helemaal aan het einde van de tabbladenbalk, bevat **Minimum Role** en **Schema size**, de kilobytes en het geschatte aantal tokens dat de toollijst weegt, met dezelfde notitie eronder zodra de lijst boven 256 KB komt.

Plak het adres in de MCP-instellingen van de AI-client; [Een AI-client verbinden](https://support.pyn.ai/nl/ai/mcp-servers/connect-an-ai-client/) zegt waar je het in Claude, Claude Code en ChatGPT invoert. De client stuurt de persoon naar Pyn, waar die op de gebruikelijke manier inlogt (een magic link of SSO-login die vanaf dat scherm wordt gestart keert ernaar terug) en dan **Connect *client*?** ziet: "*Client* is asking to use *server title* in *workspace* as you. It can only do what that server offers and you are allowed to do." Daaronder telt een regel de tools die de client krijgt, gesplitst in **read** en **write**; **Show** klapt die uit tot de lijsten **Can read** en **Can change data**, die elke tool bij zijn titel (**Get item**) noemen na de app waar hij vandaan komt, zodat de persoon precies ziet wat de client zal kunnen doen. **Who am I** hoort bij elke verbinding en wordt daar niet meegeteld. Iemand wiens rol geen enkele daarvan bereikt leest "Your role does not allow any of the tools this server offers." **Allow** stuurt de persoon terug naar de client, verbonden; **Deny** weigert het. Iemand onder de **Minimum role** van de server ziet **Connection Failed** met "Your account is not allowed to connect to this server.", en een verzoek dat te lang open blijft staan leest "This request has expired. Start again from your AI client." Eenmaal verbonden toont de toollijst van de client **Who am I** (`who_am_i`), dat antwoordt met de persoon, de workspace en de server waarvoor de verbinding handelt, zodat je kunt bevestigen als wie de client werkt, en één tool voor elke operatie op de server die de eigen rol van de persoon toestaat, genoemd naar de operatie (bijvoorbeeld `core_getItem`) en met een titel in woorden waar de client titels toont (**Get item**). Elke tool draait als die persoon, en een operatie die zijn rol niet bereikt wordt niet getoond en is niet aan te roepen. **Write**-tools wijzigen gegevens en zijn zo gemarkeerd, dus een client die zulke wijzigingen bevestigt vraagt het de persoon eerst. Operaties die MCP-servers beheren worden nooit aangeboden, en een aanroep die een MCP-server of verbinding noemt wordt geweigerd. Clients die in een browser draaien verbinden op dezelfde manier als desktopclients. De rij van de server toont **Active**; gebruik **Disable** in zijn menu **...** om hem te pauzeren, wat ook elke bestaande verbinding verbreekt.

## Gerelateerd

- [MCP Servers](https://support.pyn.ai/nl/ai/mcp-servers/) voor hoe toegang wordt bepaald.
- [Een AI-client verbinden](https://support.pyn.ai/nl/ai/mcp-servers/connect-an-ai-client/) om het adres toe te voegen aan Claude, Claude Code of ChatGPT.
- [Users](https://support.pyn.ai/nl/settings/users/) voor wat elke rol kan doen.
- [AI](https://support.pyn.ai/nl/ai/) voor de ingebouwde agents van Pyn.
