AURON MCP — v1 (읽기 전용, 멀티 테넌트, 프로덕션-린)

AI 호스트/에이전트와 AURON Suite 백엔드 (api_peluqueria) 간의 MCP 게이트웨이입니다. 신원, 테넌시, RBAC는 실제 AURON REST API를 통해 확인되며, 모델이 이를 변경할 수 없습니다.

개요

• 읽기 전용: 모든 도구는 확인된 AURON 엔드포인트에 대한 GET 요청입니다. 생성/수정/삭제는 노출되지 않습니다.

• 실제 신원 확인: GET /api/auth/verify/ + GET /api/tenants/current/ (Bearer 토큰 또는 /api/auth/login/이 발급한 httpOnly 인증 쿠키)를 통해 인증된 AURON 주체를 확인합니다.

• 실패 시 차단 RBAC: AURON의 표준 역할에서 파생된 역할 → 권한 매핑 (policy/roles.py). 알 수 없는 역할은 권한이 0개로 설정되며, AURON 자체 권한 부여(403)가 여전히 테이블을 재정의합니다.

• 테넌시를 AURON에 위임: 어댑터는 절대 tenant_id 또는 X-Auron-Tenant 헤더를 보내지 않습니다. 업스트림은 자체 클라이언트와 마찬가지로 TenantMiddleware를 통해 세션에서 테넌트를 파생시킵니다.

• 오류 경계: 내부 정보(메시지, 토큰, 업스트림 본문, 스택 트레이스)가 모델에 도달하지 않습니다. errors/normalize_error를 참조하세요.

• 호출별 감사: 모든 도구 호출(성공 또는 거부)은 추가 전용 JSONL 감사 로그와 stdout에 기록됩니다.

• 속도 제한: 모든 호출에서 정책 확인 전에 사용자 및 도구별 슬라이딩 윈도우 제한기가 확인됩니다.

도구

추가로 auron://context/current 리소스와 daily_business_review 프롬프트가 있습니다.

빠른 시작

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

.env.example을 .env로 복사하고 실제 값을 설정하세요:

AURON_ADAPTER=http
AURON_API_BASE_URL=http://localhost:8000

한 번 인증합니다(게이트웨이에 AURON의 httpOnly 인증 쿠키가 저장됨):

auron-manage login --email caja@salon.test --subdomain salon-uno
auron-manage status        # verify the resolved identity/role

서버를 실행합니다:

auron-mcp          # stdio (default; what local MCP hosts expect)

대신 Streamable HTTP(사양 2026-07-28)로 실행합니다:

AURON_MCP_TRANSPORT=streamable-http \
AURON_MCP_HTTP_HOST=127.0.0.1 \
AURON_MCP_HTTP_PORT=8765 \
auron-mcp          # serves the MCP endpoint at http://127.0.0.1:8765/mcp

HTTP 배포는 MCP-Protocol-Version / Mcp-Method / Mcp-Name 요청 헤더를 JSON-RPC 본문(400 + -32020 HeaderMismatch)과 비교하여 검증하고, POST가 아닌 요청은 405로 거부하며, DNS 리바인딩 보호를 활성화합니다. 전체 엔드포인트 계약은 docs/CONNECTING.md를, SDK 전송 위의 사양 레이어는 src/auron_mcp/http_app.py를 참조하세요.

AURON_ADAPTER=mock(기본값)으로 설정하면 서버가 고정된 개발 신원(u-mock-1 / t-mock-1 / CLIENT_ADMIN)으로 오프라인에서 작동하며, 개발 및 테스트 전용입니다.

테스트

pytest -q          # 78 tests: policy, rbac, audit, ratelimit, adapters,
                   # identity provider, tools, MCP stdio handshake, and the
                   # 2026-07-28 Streamable HTTP header rules
ruff check src tests

레이아웃

src/auron_mcp/
  auth/          identity.py (AuronIdentity) + provider.py (resolve via AURON)
  policy/        roles.py (RBAC mirror) + engine.py (PolicyEngine, fail-closed)
  audit/         AuditLogger (JSONL + stdout)
  adapters/      base.py (interface) / http.py (httpx2 + cookies) / mock.py
  tools/         AuronTools (policy + rate-limit + audit around every read)
  errors/        normalize_error (model-safe error boundary)
  server.py      MCPServer wiring (stdio / streamable-http / sse)
  http_app.py    Streamable HTTP deployment: 2026-07-28 header validation,
                 DNS-rebinding settings, optional bearer token
  manage.py      operator CLI: login / status / clean

보안 원칙

1. LLM이 제공한 테넌트 ID를 권한 부여 경계로 절대 신뢰하지 마십시오.

2. 인증된 ID와 서버 측 정책에서 테넌트/범위를 확인하십시오.

3. 도구는 읽기 전용입니다. v1에서는 의도적으로 부수 효과를 범위에서 제외합니다.

4. 모든 민감한 작업(거부된 시도 포함)은 감사 가능해야 합니다.

5. MCP는 안정적인 AURON 애플리케이션 API를 호출하며, 원시 SQL을 호출하지 않습니다.

6. 비밀, JWT, 업스트림 응답 본문 또는 스택 트레이스를 모델에 절대 노출하지 마십시오.

7. 도구 호출에는 비용이 발생합니다. 속도를 제한하십시오.

docs/mcp-integration-audit.md(실제 AURON 백엔드 감사), docs/ARCHITECTURE.md, docs/CONNECTING.md, docs/ROADMAP.md를 참조하세요.