Agentomy MCP Gateway

Ein offener Bestandteil von Agentomy, der Governance-Ebene für KI-Agenten in regulierten Unternehmen. Siehe die anderen auf github.com/getagentomy.

Verwaltet jeden stdio-MCP-Server, indem es sich zwischen Agent und Server schaltet. Jeder tools/call wird vor Erreichen des Servers gegen Ihre Richtlinie geprüft. Eine Ablehnung wird vom Gateway beantwortet und nie weitergeleitet, sodass der Nebeneffekt nicht eintritt.

Am Upstream-Server ändert sich nichts. Er wird nicht gepatcht, nicht geforkt und erfährt nie, dass er verwaltet wird.

Warum dazwischenschalten statt beobachten

Ein Sidecar, das den MCP-Verkehr beobachtet und darüber berichtet, erzeugt eine Aufzeichnung der Dinge, die es nicht stoppen konnte. Auf der Leitung zu sitzen ist das, was aus einem Bericht eine Ablehnung macht.

Related MCP server: jamjet-policy

Installation und Ausführung

# Instead of launching the MCP server directly:
#   my-mcp-server --flag
# launch it through the gateway:
AGENTOMY_ENDPOINT=https://your-agentomy \
AGENTOMY_API_KEY=... \
  agentomy-mcp-gateway, my-mcp-server --flag

Ersetzen Sie in der MCP-Konfiguration eines Agents die command- und args-Werte des Servers:

{
  "mcpServers": {
    "dev-tools": {
      "command": "agentomy-mcp-gateway",
      "args": ["--", "the-original-command", "--its", "--flags"],
      "env": { "AGENTOMY_ENDPOINT": "https://your-agentomy", "AGENTOMY_API_KEY": "..." }
    }
  }
}

Das ist die gesamte Integration. Eine Konfigurationsänderung pro Agent, durch den Operator.

Was es mit dem Protokoll macht

Anfragen werden in der Reihenfolge ihres Eintreffens entschieden. Eine gleichzeitige Entscheidung würde es einem späteren Aufruf ermöglichen, den Server zu erreichen, bevor ein früherer aufgelöst wurde – ein Reihenfolgefehler, der sich nur unter Last zeigt.

Fail-closed und was das kostet

Jeder Fehlerpfad verweigert:

Der ehrliche Kompromiss: Wenn die Plattform ausfällt, funktionieren verwaltete Tools nicht mehr. Das ist das korrekte Verhalten für eine Governance-Komponente und eine echte Verfügbarkeitskopplung. Betreiben Sie die Plattform entsprechend.

Die Gründe sind bewusst unterschiedlich. Ein Operator, der governance_unreachable sieht, hat einen Ausfall; einer, der policy_denied sieht, hat eine Richtlinienfrage. Sie zu „abgelehnt“ zusammenzufassen, würde die beiden genau in dem Moment ununterscheidbar machen, in dem der Unterschied zählt.

Ein fehlendes Feld authorized verweigert, anstatt auf Wahrheitsgehalt geprüft zu werden, denn eine Wahrheitsprüfung macht aus jeder unerwarteten Nutzlast, einschließlich eines Fehlerobjekts, eine Erlaubnis.

Was es nicht tut

Es verwaltet Aktionen, nicht die Erkennung. tools/list wird durchgereicht. Einzuschränken, was ein Agent sehen darf, während das, was er tun darf, unverwaltet bleibt, wäre Theater am falschen Ort.

Es schreibt Ergebnisse nicht um. Das Gateway entscheidet über Anfragen; wenn es Antworten bearbeiten würde, würde es zu einem Teilnehmer am Gespräch statt zu einem Tor davor.

Es prüft Argumente nicht semantisch. Die Richtlinie erhält den Toolnamen und die Argument-Schlüssel, nicht die Werte. Richtlinien auf Argumentebene sind eine Plattformangelegenheit, und das Senden vollständiger Argumentwerte an einen Entscheidungsendpunkt würde Dateiinhalte und Shell-Befehle in ein zweites System bringen.

Lizenz

Apache-2.0.