Agentomy MCP Gateway

Agentomy의 오픈 구성 요소 — 규제 기업의 AI 에이전트를 위한 거버넌스 레이어입니다. 다른 구성 요소는 github.com/getagentomy에서 확인하세요.

에이전트와 서버 사이에 위치하여 모든 stdio MCP 서버를 관리합니다. 모든 tools/call은 서버에 도달하기 전에 정책에 따라 검사됩니다. 거부된 요청은 게이트웨이가 응답하며 전달되지 않으므로 부작용이 발생하지 않습니다.

업스트림 서버는 변경되지 않습니다. 패치되지도, 포크되지도 않으며, 관리되고 있다는 사실을 알지 못합니다.

관찰 대신 개입하는 이유

MCP 트래픽을 관찰하고 보고하는 사이드카는 막지 못한 것들의 기록을 생성합니다. 와이어에 개입하는 것이 보고서를 거부로 바꾸는 방법입니다.

Related MCP server: jamjet-policy

설치 및 실행

# 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

에이전트의 MCP 구성에서 서버의 command와 args를 교체하세요:

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

이것이 통합의 전부입니다. 운영자가 에이전트별로 구성 하나만 변경하면 됩니다.

프로토콜에 미치는 영향

요청은 도착 순서대로 판정됩니다. 동시에 판정하면 이전 호출이 해결되기 전에 이후 호출이 서버에 도달할 수 있으며, 이는 부하가 걸릴 때만 나타나는 재정렬 버그입니다.

실패 시 폐쇄, 그리고 그 비용

모든 실패 경로는 거부합니다:

정직한 트레이드오프: 플랫폼이 다운되면 관리되는 도구가 작동을 멈춥니다. 이는 거버넌스 구성 요소로서 올바른 동작이며 실제 가용성 결합입니다. 플랫폼을 그에 맞게 운영하세요.

사유는 의도적으로 구분됩니다. governance_unreachable을 보는 운영자는 장애가 있는 것이고, policy_denied를 보는 운영자는 정책 문제가 있는 것입니다. 이들을 "거부"로 합치면 차이가 중요한 바로 그 순간에 두 경우를 구분할 수 없게 됩니다.

authorized 필드가 없으면 truthiness로 읽히는 대신 거부됩니다. truthiness 검사는 오류 객체를 포함한 예상치 못한 페이로드를 허용으로 바꾸기 때문입니다.

하지 않는 일

행동을 관리하지, 발견을 관리하지 않습니다. tools/list는 통과합니다. 에이전트가 볼 수 있는 것을 좁히면서 할 수 있는 것을 관리하지 않는 것은 잘못된 곳에서의 연극일 뿐입니다.

결과를 재작성하지 않습니다. 게이트웨이는 요청을 판정합니다. 응답을 편집하게 하면 대화의 게이트가 아니라 대화의 참여자가 됩니다.

인수를 의미적으로 검사하지 않습니다. 정책은 도구 이름과 인수 키를 받지, 값을 받지 않습니다. 인수 수준 정책은 플랫폼의 문제이며, 전체 인수 값을 결정 엔드포인트로 보내면 파일 내용과 셸 명령이 두 번째 시스템에 들어가게 됩니다.

라이선스

Apache-2.0.