---
lastModified: 2026-11-13
title: Je eigen MCP-server toevoegen
description: Verbind een externe MCP-server via een URL en kies wat de Runner Agent met elke tool mag doen.
seo:
  description: "Verbind je eigen externe MCP-server met Runner via een URL, met of zonder API-sleutel, en zet elke tool op Toestaan, Eerst vragen of Uit voordat de Agent hem kan gebruiken."
---

Als een dienst die je gebruikt een MCP-server heeft, kun je de tools ervan aan de Runner Agent geven. Plak
de server-URL. Runner vindt de tools van de server. Daarna kies je wat de Agent met elke tool mag doen.

Gebruik dit voor een dienst die niet in **Koppel je tools** staat, zoals je eigen ERP, een
voorraadsysteem of een tool die je team beheert.

## Voordat je begint

**Toegangspad:** **Project → Agent → Tools → Je eigen MCP-server toevoegen**

Je hebt nodig:

- de rol van winkeleigenaar of beheerder. Andere leden kunnen geen server toevoegen, wijzigen of verwijderen;
- de URL van een externe MCP-server, zoals `https://example.com/mcp`; en
- de API-sleutel en de headernaam ervan, als de server een sleutel nodig heeft.

De server moet aan deze voorwaarden voldoen:

- Hij moet op het openbare internet staan. Runner maakt geen verbinding met `localhost` of met een
  adres in een privénetwerk.
- Hij moet het HTTP-transport van MCP gebruiken (Streamable HTTP). Runner voert geen lokale
  opdrachtregelserver (stdio) voor je uit.
- Hij moet werken zonder inloggen of met een API-sleutel in een request-header. **OAuth** is nog niet
  beschikbaar.

Een winkel kan maximaal 10 MCP-servers hebben. Runner bewaart maximaal 100 tools per server.

**Belangrijk:** Runner kan niet controleren wat een eigen server met je gegevens doet. Voeg alleen
servers toe die je zelf beheert of goed kent.

## Een server toevoegen

1. Open je project en selecteer **Agent → Tools**.
2. Selecteer in de rij **Je eigen MCP-server toevoegen** de optie **Server toevoegen**.
3. Vul de **Server-URL** in. Of plak de JSON-configuratie uit de documentatie van de server in
   **JSON-configuratie plakken**. Runner vult de URL en de sleutelheader in op basis van de configuratie.
4. Optioneel: vul een **Naam** in. Als je dit leeg laat, gebruikt Runner de naam van de server zelf.
   Runner toont deze naam in de chat als het een tool gebruikt.
5. Selecteer onder **Hoe Runner inlogt** de optie **Niet inloggen** of **API-sleutel**. Vul bij
   **API-sleutel** de **Headernaam** en de **Sleutel** in, zoals `Authorization` en `Bearer sk-…`.
   Runner slaat de sleutel versleuteld op. Niemand, ook jij niet, kan hem teruglezen.
6. **Welke agents het mogen gebruiken** toont **Alle agents**. Je kunt dit later per agent wijzigen.
7. Selecteer **Ik vertrouw deze server**.
8. Selecteer **Verbinden en tools zoeken**. Runner maakt verbinding met de server en toont de tools.
9. Kies een regel voor elke tool. Selecteer daarna de knop met de servernaam, zoals **Shop ERP toevoegen**.

Als de server is toegevoegd, staat hij onder **Gekoppeld** met de tag **Eigen MCP**.

## Kiezen wat elke tool mag doen

Elke tool krijgt een van drie regels:

- **Toestaan:** de Agent gebruikt de tool zonder het je te vragen.
- **Eerst vragen:** de Agent toont je de aanroep in de chat. De tool draait pas nadat je hem goedkeurt.
- **Uit:** de Agent kan de tool niet gebruiken.

Runner raadt een beginregel op basis van de naam van elke tool, en groepeert de tools op die regel:

| Groep | Beginregel | Toolnamen die Runner hier plaatst |
| --- | --- | --- |
| **Leest gegevens** | **Toestaan** | Namen die beginnen met een leeswoord, zoals `list`, `get` of `search`. Ook elke naam die Runner niet herkent. |
| **Wijzigt gegevens** | **Eerst vragen** | Namen met `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` of `price` erin. |
| **Verwijdert gegevens** | **Uit** | Namen met `delete` of `trash` erin. |

**Controleer de regel van elke tool voordat je de server toevoegt.** Runner leest alleen de
naam van de tool, niet wat de tool doet. Een tool zoals `update_inventory` of `create_customer`
begint op **Toestaan** in **Leest gegevens**, dus de Agent kan gegevens wijzigen zonder het je te vragen.
Zet zulke tools op **Eerst vragen** of **Uit**.

Je kunt de regel van elke tool wijzigen voordat je de server toevoegt. Wijzig hem later onder
**Wat elke agent mag doen** op de pagina van de server. Een tool die de server later toevoegt, begint
op **Eerst vragen**, of op **Uit** als de naam `delete` of `trash` bevat.

De regels gelden voor elke chat in dit project. Runner controleert ze bij elke toolaanroep.

## Een server beheren

Open de server vanuit **Gekoppeld** op **Agent → Tools**. De pagina van de server heeft deze besturingselementen:

| Besturingselement of gegeven | Wat het doet |
| --- | --- |
| Server-URL en kopieerknop | Onder **Verbinding**. **Server-URL kopiëren** kopieert de URL. |
| **Status** | Toont wanneer de server voor het laatst antwoordde, of **Nog niet gecontroleerd**. |
| **Inloggen** | Toont **Niet inloggen** of de laatste vier tekens van de sleutel. **Sleutel toevoegen** of **Vervangen** wijzigt de sleutel. |
| **Verbinding testen** of **Tools vernieuwen** | Maakt opnieuw verbinding met de server en haalt de huidige toollijst op. Nieuwe tools beginnen op **Eerst vragen**, of op **Uit** voor tools die verwijderen. |
| **Server verwijderen** | Verwijdert de server. Agents verliezen de tools ervan en de toolregels worden verwijderd. Je kunt hem later opnieuw toevoegen. |

## Als er iets misgaat

| Melding | Wat je doet |
| --- | --- |
| **Vul een volledige server-URL in, zoals https://example.com/mcp.** | Vul de volledige URL in, inclusief het pad. |
| **Runner kan alleen openbare servers bereiken. Deze URL wijst naar een privénetwerk.** | Gebruik een URL die via internet bereikbaar is. |
| **Deze URL antwoordde, maar niet als MCP-server. Controleer het pad.** | Zoek het MCP-pad op in de documentatie van de server. Het eindigt vaak op `/mcp`. |
| **Runner kan deze server niet bereiken. Controleer de URL en of hij online is.** | Controleer of de server draait en of de URL klopt. |
| **De server heeft de sleutel geweigerd. Controleer de headernaam en de sleutel.** | Controleer beide waarden. Sommige servers hebben `Bearer ` vóór de sleutel nodig. |
| **De server antwoordde, maar heeft geen tools.** | De server heeft geen tools voor deze sleutel. Controleer de instellingen van de server. |
| **Deze winkel heeft al het maximale aantal MCP-servers. Verwijder er eerst een.** | Verwijder een server die je niet gebruikt. |

Onder **Gekoppeld** toont een server die niet meer werkt **Niet bereikbaar** of **Sleutel geweigerd**.
Selecteer **Herstellen** om de server te openen. Vervang daarna de sleutel of controleer de server.

## Gerelateerde handleidingen

- [Agent Apps verbinden en beheren](./agent-apps)
- [Overzicht van apps en integraties](../apps-and-integrations)
- [Problemen met een app-verbinding oplossen](./troubleshooting)