Skip to main content
Glama
deenesjakoruzh
kkday-it

be2-mcp

Official
by kkday-it
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

be2 MCP (Model Context Protocol)

be2 MCP는 Claude agent와 be2 상품 백엔드 사이에 위치한 '거버넌스 계층' 서버로, 직원들이 자연어를 통해 안전하게 배치 작업을 완료할 수 있게 합니다. 단순한 API 프록시가 아니라, 완전한 권한 제어, 변경 상태 머신, 감사 메커니즘을 갖춘 보안 게이트웨이로서, 프로덕션 환경에 대한 모든 쓰기가 기업 표준을 준수하도록 보장합니다: 맹목적 쓰기 금지, 자기 승인 금지, 전 구간 감사 기록 보존.

🟢 현황: Phase 1a–5 완료 | 473 tests passed / 0 skipped | SIT be2-220 Live 전 구간 검수 통과

핵심 특성

  • draft-only 수동 승인: agent는 change-set 초안만 생성할 수 있으며, 쓰기는 반드시 독립 채널(패널 또는 확인 페이지)을 통한 수동 승인을 거쳐야 합니다.

  • 신원 관통 (Identity Pass-through): auth-service 로그인으로 발급된 be2 token을 사용하며, 자체 RBAC를 구축하지 않고 인가 판단은 백엔드 gateway에 위임합니다.

  • 모듈형 domain: 각 비즈니스 영역(예: 상품 등록/해제, 재고)은 독립적인 module로 캡슐화되며, action type을 추가해도 core를 건드리지 않습니다.

  • 배치 마법사 패널 (Batch Wizard): Claude Desktop MCP Apps가 대화형 승인 패널과 운영 마법사를 렌더링하도록 지원합니다.

  • 전 구간 감사 (Append-only Audit): tool call부터 실행까지 각 단계의 trace를 기록하며, 절대 평문 token을 저장하지 않습니다.

Related MCP server: @vaibot/mcp-server

시스템 아키텍처

Claude Client (Code/Desktop)
       │
       │ (MCP over Streamable HTTP + OAuth 2.1 不透明參考 token)
       ▼
┌─────────────────────────── be2-mcp server (治理層) ───────────────────────────┐
│                                                                             │
│  [OAuth 2.1 外殼] 負責 Discovery / DCR / PKCE                                │
│        │                                                                    │
│  [Core 治理層]   change-set 狀態機、CAS 防重複、scope-binding、稽核留存      │
│        │                                                                    │
│  [Domain Modules] (src/modules/product/*)                                   │
│    ├─ shelfToggle (上下架)                                                  │
│    ├─ inventorySetting (數量)                                               │
│    ├─ inventoryPlatform (平台切換)                                          │
│    └─ shelfSchedule (排程)                                                  │
│                                                                             │
└─┬───────────────────────────────┬─────────────────────────────────────────┬─┘
  │ (帶 be2 JWT 查改)             │ (帶 service key 換碼/refresh)            │ (互動批准)
  ▼                               ▼                                         ▼
be2 gateway /product/api/v1      auth-service /api/v1/          UI 面板 (mcp-ui) / 確認頁 SSO

보안 모델 요약

보안 메커니즘

방어 대상과 효과

OAuth 2.1 셸

agent의 계정/비밀번호 탈취 방지. 계정/비밀번호는 POPUP에서만 be2-auth로 전송되며, agent는 단기 code를 받아 token으로 교환할 뿐입니다.

token 이탈 방지

자격 증명 유출 방지. 실제 token은 server에 저장되며, agent에 전달되는 것은 인가 효력이 없는 불투명한 무작위 문자열입니다.

draft-only + SSO/Nonce 승인

agent의 환각/악성 쓰기 방지. agent는 be2mcp_sid (SSO) 또는 nonce (패널)를 얻을 수 없으므로 구조적으로 자기 승인이 불가능합니다.

scope-binding

프롬프트 인젝션 방지. change-set은 같은 대화 session 내에서 L0 도구가 '읽은' 객체만 조작할 수 있습니다.

businessList fail-fast

권한 초과 시도 방지. auth-service가 발급한 businessList가 MCP 계층에서 권한이 없는 동작을 조기에 차단합니다.

빠른 시작

  1. 의존성 설치

    npm install

  2. 환경 변수 준비 .env.example을 복사하여 .env로 만드세요. 절대 실제 프로덕션 환경의 token이나 비밀번호를 작성하거나 commit하지 마세요. SIT SIT_AUTHSVC_SERVICE_KEY 한 세트가 필요합니다.

  3. 서버 시작 & UI 구축

    npm run build:ui
npm run dev

  4. Claude 연동 (Claude Code 기준)

    claude mcp add be2-mcp --transport http http://127.0.0.1:8787/mcp

    실행 후 브라우저에서 be2-auth SSO 로그인 페이지가 열립니다.

  5. 테스트

    npm run ci

프로젝트 구조 트리

src/
 ├─ core/       # 治理層基礎設施 (change-set、CAS、audit、store)
 ├─ oauth/      # OAuth 2.1 外殼 (Discovery, DCR, authorize, token routes)
 ├─ auth/       # 認證內核 (TokenManager、auth-service 介接)
 ├─ server/     # Streamable HTTP server, confirm routes, 路由組裝
 ├─ tools/      # MCP tools 註冊與介面
 ├─ ui/         # 面板與精靈的 isomorphic 前端 (esbuild 打包入口)
 └─ modules/    # Domain modules 實作 (純業務邏輯)
     └─ product/
         ├─ shelfToggle/       # 商品/方案上下架模組
         ├─ inventorySetting/  # 庫存數量修改模組
         ├─ inventoryPlatform/ # 庫存平台切換模組
         └─ shelfSchedule/     # 上下架排程模組

문서 지도

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • ToolBridge

    AlexlaGuardia
    F
    license
    Not graded
    quality
    D
    maintenance
    A governed MCP server for integrating AI agents with customer data, featuring role-based access control, field redaction, and human-in-the-loop approval for secure support operations.
    1
    -
  • @vaibot/mcp-server by vaibot-io

    @vaibot/mcp-serverofficial

    vaibot-io
    F
    license
    A
    quality
    D
    maintenance
    Governance circuit-breaker MCP server that enables AI agents to request risk-based decisions, approve or deny actions, and finalize outcomes with full audit receipts.
    4
    -

  • ops-mcp

    Yuvraj-ai
    F
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that enables non-technical operations users to resolve common commerce-ops tickets, such as orders charged but failed, through an investigate, recommend, approve, and execute workflow with read-only and write tools.
    -