Zum Inhalt springen

MCP-Tools

Externe Tool-Server hinter derselben Compliance-Schleuse, mit Grants pro Schlüssel, standardmäßig verweigert. Agenten erreichen nur erlaubte Tools.

Registrieren Sie externe MCP-Tool-Server (HTTP, SSE oder stdio) in der Console mit Residency-Tags; Auth-Secrets werden im Credential-Vault versiegelt und niemals zurückgegeben. MCP-Dienste folgen der Residency-Richtlinie, nicht der Liste der Modellanbieter im unterzeichneten DPA.

Tools & MCP: Verwalten Sie Server und kontrollierten Tool-Zugriff.
Tools & MCP: Verwalten Sie Server und kontrollierten Tool-Zugriff.Englische Oberfläche · illustrative Demodaten. Öffnen Sie das Bild in voller Größe.

Jeder Tool-Aufruf durchläuft dieselbe Schleuse wie eine Chat Completion: Prüfen (Datenschutz auf den Argumenten), Routen (Residency auf dem Server), Versiegeln (Audit-Kette), Messen (Rate und Budget). Tool-Grants gelten pro Key und sind standardmäßig verboten. Sluis beantwortet außerdem POST /v1/mcp selbst als MCP-Server und stellt genau die Tools bereit, die dem aufrufenden Key gewährt sind.

Tools aus dem eigenen Code aufrufen

Mit POST /v1/mcp und einem API-Key sehen Sie die Tools, die dieser Key nutzen darf. Ein Tool auszuführen ist ein separater Aufruf.

  • Auflisten: tools/list liefert die Tools, die Ihr Key nutzen darf. Ein Server fehlt, wenn die Datenresidenz ihn nicht erlaubt, seine Anmeldung fehlt oder sich seine Tool-Liste nicht abrufen lässt.
  • Anfragen: tools/call führt nichts aus. Es liefert needs_confirmation mit dem Tool, den Argumenten und dem Ort, an dem es auszuführen ist.
  • Ausführen: Senden Sie die Argumente des Tools als Request-Body an POST /v1/mcp/servers/{id}/tools/{tool}/call. Dieser Aufruf durchläuft Inspect, Route, Seal und Meter.
  • Ein Tool, das Ihr Key nicht nutzen darf, scheitert mit Fehler -32000, ungültige Parameter mit -32602 und eine unbekannte Methode mit -32601. JSON-RPC-Fehler kommen mit HTTP 200 zurück; eine fehlerhafte Anfrage liefert HTTP 400.
  • Stdio-Server führen nur Programme aus, die der Betreiber in SLUIS_MCP_STDIO_ALLOW freigegeben hat, höchstens 16 gleichzeitig.
# 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-Authentifizierung: zwei Richtungen

Von einem MCP-Client bei Sluis anmelden

Eingehendes OAuth unter /agent/mcp meldet einen MCP-Client über den Browser bei Sluis an. Dabei wird kein Key eingefügt, und die Keys für Modellaufrufe bleiben unverändert.

  1. Fügen Sie Sluis in Ihrem Client hinzu, wie in den Beispielen unten. Der Client findet Sluis über die veröffentlichten Discovery-Dokumente und registriert sich selbst, wo er das unterstützt.
  2. Der Client öffnet Ihren Browser auf der Zustimmungsseite /console/mcp-authorize. Sie zeigt den Client, die Organisation und die erreichbaren Tools.
  3. Genehmigen oder verweigern Sie den Zugriff in der gewünschten Organisation.
  • Sluis erstellt oder verwendet automatisch persönliche Tool-Zugangsdaten für diesen Client.
  • Bestehende Plugin-Bindungen, Tool-Berechtigungen und Richtlinien gelten weiterhin. Die Zustimmung allein gibt keine Tools frei.
  • Für die Organisation muss Agent Harness aktiviert sein.
  • Access-Tokens gelten eine Stunde. Refresh-Tokens rotieren bei jeder Verwendung.
  • Widerrufen Sie einen Client unter Agent Harness › Verbundene Clients. Das trennt seine Tokens und seinen persönlichen Agent-Key.
  • Das ist getrennt von der Upstream-Anmeldung mit user_oauth.
claude mcp add --transport http sluis https://<gateway>/agent/mcp

Konfigurationsbeispiele, keine verifizierte Interoperabilitätsmatrix. Diese Beispiele belegen keine Interoperabilität mit externen Claude-, Codex- oder Upstream-Diensten.

Statische Server-Zugangsdaten

Verwenden Sie headers für feste Header. Der bisherige Wert oauth bezeichnet ein statisches Bearer-Token im Vault, keine Browser-Anmeldung.

Kontomodus

Bei interaktivem OAuth legt der Kontomodus fest, wessen Identität Sluis beim Tool-Server verwendet.

  • Organisation (account_mode=organization): eine gemeinsame Identität, die ein Admin ausdrücklich per OAuth verbindet. Persönliche Zugangsdaten werden nie wiederverwendet.
  • Jeder Benutzer (account_mode=user): nur die eigene Verbindung des handelnden Mitglieds.
  • Die Authentifizierung ist davon getrennt: Interaktives OAuth verwendet user_oauth, und der bisherige Wert oauth bleibt ein statisches Bearer-Token.

Persönliche Upstream-Verbindungen

Im Modus Jeder Benutzer meldet sich jedes Mitglied selbst beim Upstream-Dienst an.

  1. Ein Admin gibt den Server für Workspace frei. Von Admins hinzugefügte Server brauchen das zuerst.
  2. Jedes Mitglied meldet sich unter Einstellungen › Verbindungen an.
  • Eine Verbindung umgeht weder Tool-Berechtigungen noch Datenresidenz, Datenschutz oder Budgets.
  • Admins können den Status einsehen und Verbindungen widerrufen, aber nicht die Identität anderer Mitglieder nutzen.
  • Aufrufe ohne Benutzeridentität, einschließlich organisationsweiter Keys, werden im Modus Jeder Benutzer abgewiesen.
  • Haben Sie sich nicht verbunden oder akzeptiert der Dienst Ihre Anmeldung nicht mehr, liefert das Tool connect_required, und die Antwort zeigt für diesen Server die Aktion Verbinden. Nichts läuft unter einer anderen Identität.

MCP-Tools aus- oder einschalten

Eigentümer und Admins schalten MCP-Tools in Workspace-Gesprächen in der Workspace-Konfiguration der Console. Dieselbe Einstellung ist das Boolean mcp_enabled bei GET/PUT /chat/settings.

  • Es ist standardmäßig true: für neue Organisationen, ältere Einstellungen und ein fehlendes Feld. Wird es bei PUT weggelassen, bleibt der aktuelle Wert erhalten, auch false.
  • Bei false erkennt Workspace keine MCP-Tools und führt sie nicht aus, auch nicht früher gefundene Tools in bestehenden Gesprächen, Agenten und Subagenten.
  • Registrierungen, Genehmigungen, Freigaben und Zugangsdaten bleiben erhalten.
  • Das externe /agent/mcp, /v1/mcp und der Playground der Console sind nicht betroffen.
  • Die Richtlinie für persönliche Server-Registrierung bleibt davon unabhängig und gilt organisationsweit.

Persönliche MCP-Vorschläge

Persönliche MCP-Vorschläge sind standardmäßig Aus. Admins wählen eine von zwei Einstellungen.

  • Aus pausiert bestehende persönliche Server. Es blockiert keine Anmeldung bei Servern, die Admins hinzugefügt haben.
  • Admin-Freigabe erforderlich erlaubt Mitgliedern, private Server einzureichen, die nur sie selbst nutzen.

Jeder Antrag durchläuft eine Prüfung.

  • Ein Antrag nennt nur den Server und seinen Endpunkt. Solange er offen ist, kontaktiert er den Server nicht und gibt keine Tools frei.
  • Admins prüfen Tools, Datenresidenz und Authentifizierung ausdrücklich. Eine Genehmigung erteilt nie Wildcard-Zugriff und macht einen Server nie automatisch für die Organisation verfügbar.
  • Die Genehmigung legt die geprüfte Konfiguration und eine ausdrückliche Liste von Tool-Namen fest, die nur der Antragsteller nutzen kann. Danach meldet sich der Antragsteller unter Verbindungen an, wenn der Server OAuth nutzt.
  • Private Server unterstützen none (ohne Upstream-Anmeldung) oder interaktives OAuth, keine persönlichen statischen Geheimnisse.
  • Wird ein genehmigter Antrag entfernt, werden der Server und seine Verbindungen widerrufen.

Bestätigung bei Datenänderungen

Workspace trennt Tools, die lesen, von Tools, die Daten ändern.

  • Die eigene Schreibschutz-Angabe des Connectors (readOnlyHint) gilt, wenn er eine sendet.
  • Ein Tool ohne Angabe gilt als änderndes Tool, es sei denn, ein Admin markiert es in den Connector-Einstellungen als schreibgeschützt.

Bevor ein änderndes Tool läuft

Das Mitglied sieht in einer Karte den Connector, das Tool und die exakten Argumente und wählt Ausführen oder Nicht ausführen.

  • Keine Antwort innerhalb von fünf Minuten, das Schließen des Chats oder Stopp gelten als Ablehnung, und das Modell erfährt, dass der Nutzer abgelehnt hat.
  • Bei einem geplanten Agentenlauf kann niemand gefragt werden. Dort führt ein Connector, der nachfragt, nie ein änderndes Tool aus.

Admin-Einstellungen pro Connector

  • Nie fragen: wird im Audit-Log festgehalten und am Connector angezeigt. Lesende Tools fragen nie.
  • Nur lesende Tools: Dem KI-Modell wird kein Tool angeboten, das Daten ändert. Nutzen Sie das zum Beispiel für einen Connector mit gemeinsamem Konto.