AURON MCP
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에 기록됩니다.
속도 제한: 모든 호출에서 정책 확인 전에 사용자 및 도구별 슬라이딩 윈도우 제한기가 확인됩니다.
Related MCP server: DataGate
도구
도구 | 엔드포인트 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 복합: 매출 + 약속 + 재고 + 직원 성과 |
| 복합: 제품 + 재고 부족 알림 |
| 복합: 대시보드 통계 + 오늘의 매출 |
| 복합: 성과 + 직원 명단 |
|
|
추가로 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/mcpHTTP 배포는 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보안 원칙
LLM이 제공한 테넌트 ID를 권한 부여 경계로 절대 신뢰하지 마십시오.
인증된 ID와 서버 측 정책에서 테넌트/범위를 확인하십시오.
도구는 읽기 전용입니다. v1에서는 의도적으로 부수 효과를 범위에서 제외합니다.
모든 민감한 작업(거부된 시도 포함)은 감사 가능해야 합니다.
MCP는 안정적인 AURON 애플리케이션 API를 호출하며, 원시 SQL을 호출하지 않습니다.
비밀, JWT, 업스트림 응답 본문 또는 스택 트레이스를 모델에 절대 노출하지 마십시오.
도구 호출에는 비용이 발생합니다. 속도를 제한하십시오.
docs/mcp-integration-audit.md(실제 AURON 백엔드 감사), docs/ARCHITECTURE.md, docs/CONNECTING.md, docs/ROADMAP.md를 참조하세요.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A paid remote MCP for AI SDK data query MCP, built to return verdicts, receipts, usage logs, and aud
One governed MCP endpoint for 40+ business systems. Read-only, source-cited answers.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Related MCP Servers
- FlicenseBqualityDmaintenanceA secure, read-only MCP server that enables AI assistants to inspect transactions, vendor performance, wallet balances, and analytics through validated REST API calls.19-
- AlicenseNot gradedqualityBmaintenanceProvides a secure, policy-driven read-only gateway that exposes multiple databases to AI tools via MCP, with governed select, search, and aggregate operations and no free-form SQL.Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI clients to securely read data from customers' ERPNext/Frappe sites through a multi-tenant OAuth-protected gateway, with tools for listing, searching, counting, retrieving, and reporting on documents.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and LLM agents to query operational databases through a read-only MCP gateway with table whitelisting, automatic row limits, sensitive-data masking, and audit logging.1MIT