Ga naar de inhoud

MCP-tools

Externe toolservers achter dezelfde compliance-sluis, met rechten per sleutel die standaard geweigerd zijn, zodat agents alleen bij toegestane tools komen.

Registreer externe MCP-toolservers (HTTP, SSE of stdio) in de Console met residency-tags; auth-secrets worden verzegeld in de credential-kluis en nooit teruggegeven. MCP-diensten volgen het residency-beleid, niet de lijst met modelproviders in de ondertekende DPA.

Tools & MCP: beheer servers en gecontroleerde toegang tot tools.
Tools & MCP: beheer servers en gecontroleerde toegang tot tools.Engelstalige interface · illustratieve demogegevens. Open de afbeelding op volledig formaat.

Elke tool-call passeert dezelfde sluis als een chat completion: Inspect (gegevensbescherming op de argumenten), Route (residency op de server), Seal (auditketen), Meter (limieten en budget). Tool-grants zijn per key en standaard weigerend. Sluis beantwoordt zelf ook POST /v1/mcp als MCP-server, en toont precies de tools waarvoor de aanroepende key gemachtigd is.

Tools aanroepen vanuit je eigen code

Gebruik POST /v1/mcp met een API-sleutel om te zien welke tools die sleutel mag gebruiken. Een tool uitvoeren is een aparte aanroep.

  • Lijst: tools/list geeft de tools terug waartoe je sleutel toegang heeft. Een server blijft weg als residency die niet toestaat, de aanmelding ontbreekt of de toollijst niet kan worden opgehaald.
  • Vragen: tools/call voert niets uit. Het geeft needs_confirmation terug met de tool, de argumenten en waar je hem uitvoert.
  • Uitvoeren: stuur de argumenten van de tool als request body naar POST /v1/mcp/servers/{id}/tools/{tool}/call. Deze aanroep doorloopt Inspect, Route, Seal en Meter.
  • Een tool waartoe je sleutel geen toegang heeft, mislukt met fout -32000, ongeldige parameters met -32602 en een onbekende methode met -32601. JSON-RPC-fouten komen terug met HTTP 200; een onjuist opgebouwd verzoek geeft HTTP 400.
  • Stdio-servers draaien alleen uitvoerbare bestanden die de operator heeft toegestaan in SLUIS_MCP_STDIO_ALLOW, maximaal 16 tegelijk.
# list the tools this key is granted (deny-by-default)
curl https://api.sluis.ai/v1/mcp \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

MCP-authenticatie: twee richtingen

Aanmelden bij Sluis vanuit een MCP-client

Inkomende OAuth op /agent/mcp meldt een MCP-client via de browser aan bij Sluis. Je plakt geen sleutel in deze configuratie, en de sleutels voor modelaanroepen blijven ongewijzigd.

  1. Voeg Sluis toe in je client, zoals in de voorbeelden hieronder. De client vindt Sluis via de gepubliceerde discovery-documenten en registreert zichzelf waar dat wordt ondersteund.
  2. De client opent je browser op de toestemmingspagina /console/mcp-authorize. Die toont de client, de organisatie en de tools die de client kan bereiken.
  3. Keur de toegang goed of wijs hem af in de juiste organisatie.
  • Sluis maakt automatisch een persoonlijke toolcredential voor deze client aan of hergebruikt die.
  • Bestaande pluginbindingen, toolrechten en beleid blijven gelden. Toestemming alleen geeft geen tools vrij.
  • De organisatie moet Agent Harness aan hebben staan.
  • Toegangstokens gelden een uur. Refreshtokens roteren bij elk gebruik.
  • Trek een client in via Agent Harness › Verbonden clients. Dat verbreekt de tokens en de persoonlijke agentsleutel van die client.
  • Dit staat los van upstreamaanmelding met user_oauth.
claude mcp add --transport http sluis https://<gateway>/agent/mcp

Configuratievoorbeelden, geen geverifieerde interoperabiliteitsmatrix. Deze voorbeelden bewijzen geen interoperabiliteit met externe Claude-, Codex- of upstreamdiensten.

Statische servergegevens

Gebruik headers voor vaste headers. De historische waarde oauth betekent een statisch OAuth-bearertoken in de kluis, niet aanmelden via de browser.

Accountmodus

Bij interactieve OAuth bepaalt de accountmodus welke identiteit Sluis gebruikt bij de toolserver.

  • Organisatie (account_mode=organization): een gedeelde identiteit die een beheerder expliciet via OAuth verbindt. Persoonlijke credentials worden nooit hergebruikt.
  • Elke gebruiker (account_mode=user): uitsluitend de eigen verbinding van het handelende lid.
  • Authenticatie staat hier los van: interactieve OAuth gebruikt user_oauth, en de historische waarde oauth blijft een statisch bearertoken.

Persoonlijke upstreamverbindingen

In de modus Elke gebruiker meldt elk lid zich zelf aan bij de externe dienst.

  1. Een beheerder verleent de server toegang tot Workspace. Servers die een beheerder toevoegt, hebben dit eerst nodig.
  2. Elk lid meldt zich aan via Instellingen › Verbindingen.
  • Een verbinding omzeilt geen toolrechten, residency, gegevensbescherming of budgetten.
  • Beheerders kunnen de status bekijken en verbindingen intrekken, maar niet de identiteit van een ander lid gebruiken.
  • Aanroepen zonder gebruikersidentiteit, waaronder sleutels van de organisatie, worden in de modus Elke gebruiker geweigerd.
  • Ben je niet verbonden, of accepteert de dienst je aanmelding niet meer, dan geeft de tool connect_required terug en toont het antwoord een actie Verbinden voor die server. Er draait niets onder een andere identiteit.

MCP-tools uit- of aanzetten

Eigenaren en beheerders zetten MCP-tools in Workspace-gesprekken aan of uit in de Workspace-instellingen van de console. Dezelfde instelling is de boolean mcp_enabled op GET/PUT /chat/settings.

  • De standaardwaarde is true: voor nieuwe organisaties, oude instellingen en een ontbrekend veld. Weglaten bij een PUT behoudt de huidige waarde, ook false.
  • Bij false ontdekt Workspace geen MCP-tools en weigert het de uitvoering, ook van eerder ontdekte tools in bestaande gesprekken, Agents en subagents.
  • Registraties, goedkeuringen, rechten en credentials blijven bewaard.
  • Externe /agent/mcp, /v1/mcp en de Playground in de console blijven ongewijzigd.
  • Het registratiebeleid voor persoonlijke servers blijft onafhankelijk en organisatiebreed.

Persoonlijke MCP-voorstellen

Persoonlijke MCP-voorstellen staan standaard Uit. Beheerders kiezen een van twee instellingen.

  • Uit pauzeert bestaande persoonlijke servers. Het blokkeert niet het aanmelden bij servers die een beheerder heeft toegevoegd.
  • Goedkeuring door beheerder vereisen laat leden privéservers voorstellen, alleen voor de aanvrager.

Elke aanvraag wordt beoordeeld.

  • Een aanvraag noemt alleen de server en het endpoint. Zolang ze openstaat, maakt ze geen contact met de server en geeft ze geen tools vrij.
  • Beheerders beoordelen tools, residency en authenticatie expliciet. Goedkeuring geeft nooit wildcardtoegang en maakt een server niet automatisch organisatiebreed.
  • Goedkeuring legt de beoordeelde configuratie vast met een expliciete lijst toolnamen, alleen voor de aanvrager. Die meldt zich daarna aan bij Verbindingen als de server OAuth gebruikt.
  • Privéservers ondersteunen none (geen upstreamaanmelding) of interactieve OAuth, geen persoonlijke statische geheimen.
  • Een goedgekeurde aanvraag verwijderen trekt de server en de bijbehorende verbindingen in.

Bevestiging bij wijzigingen in gegevens

Workspace maakt onderscheid tussen tools die lezen en tools die gegevens wijzigen.

  • Het eigen alleen-lezen-label van een connector (readOnlyHint) wordt gebruikt als de connector er een meegeeft.
  • Een tool zonder label geldt als wijzigend, tenzij een beheerder de tool in de connectorinstellingen als alleen-lezen markeert.

Voordat een wijzigende tool draait

Het lid ziet in een kaart de connector, de tool en de exacte argumenten en kiest Uitvoeren of Niet uitvoeren.

  • Geen antwoord binnen vijf minuten, de chat sluiten of op Stop drukken telt als geweigerd, en het model hoort dat de gebruiker heeft geweigerd.
  • Een geplande agentrun heeft niemand om het aan te vragen, dus daar draait een connector die vraagt nooit een wijzigende tool.

Beheerinstellingen per connector

  • Nooit vragen: wordt in het auditlog vastgelegd en bij de connector getoond. Tools die alleen lezen vragen nooit.
  • Alleen leestools: het AI-model krijgt geen tool die gegevens wijzigt. Gebruik dit bijvoorbeeld voor een connector met een gedeeld account.