Je eigen MCP-server toevoegen

Verbind een externe MCP-server via een URL en kies wat de Runner Agent met elke tool mag doen.

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

Open je project en selecteer Agent → Tools.
Selecteer in de rij Je eigen MCP-server toevoegen de optie Server toevoegen.
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.
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.
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.
Welke agents het mogen gebruiken toont Alle agents. Je kunt dit later per agent wijzigen.
Selecteer Ik vertrouw deze server.
Selecteer Verbinden en tools zoeken. Runner maakt verbinding met de server en toont de tools.
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.