Remote MCP Guide

팀원이 바로 붙여 쓸 수 있는 BIS MCP 설정 화면

장식용 메인 화면을 제거하고, 실제 사용에 필요한 연결 주소, 토큰 위치, 클라이언트 설정, BIS 전용 스킬 목록을 한 화면에서 확인하게 구성했습니다.

Server mcp-bis.keystonehub.io
Transport HTTP MCP / Bearer token
Primary scope BIS-Docs + BisFramework

설정 순서

토큰은 페이지에 노출하지 않습니다. 팀원은 별도로 전달받은 토큰을 로컬 환경변수에 넣고 MCP 클라이언트 설정만 추가합니다.

1

토큰을 환경변수로 등록

권장 방식: 저장소에서 scripts\setup-bis-mcp.bat를 실행합니다. 스크립트가 토큰을 숨김 입력으로 받아 BIS_MCP_TOKEN 사용자 환경변수와 Codex 설정을 자동으로 저장합니다.

2

MCP 클라이언트에 원격 서버 추가

Claude Code, Codex, Cursor처럼 HTTP MCP를 지원하는 클라이언트에 아래 설정을 추가합니다. 클라이언트가 stdio만 지원하면 별도 프록시가 필요합니다.

3

클라이언트 재시작 후 자연어로 호출

예: “BIS MCP로 이 기획 문서 QA 해줘”, “BisFramework 구현과 PRD 차이를 비교해줘”. 스킬 이름을 직접 말해도 됩니다.

자동 설정 스크립트

토큰값을 파일이나 채팅에 남기지 않고, 로컬 사용자 환경변수와 MCP 클라이언트 설정만 갱신합니다.

Windows quick setup 
scripts\setup-bis-mcp.bat
Options 
scripts\setup-bis-mcp.bat -WriteClaudeProjectConfig
scripts\setup-bis-mcp.bat -SkipVerify
scripts\setup-bis-mcp.bat -SkipCodex

클라이언트 설정

아래 설정은 토큰 값을 직접 저장하지 않고 BIS_MCP_TOKEN 환경변수를 참조하는 형태입니다.

Claude Code / .mcp.json 
{
  "mcpServers": {
    "bis": {
      "type": "http",
      "url": "https://mcp-bis.keystonehub.io/mcp",
      "headers": {
        "Authorization": "Bearer ${BIS_MCP_TOKEN}"
      }
    }
  }
}
Codex / config.toml 
[mcp_servers.bis]
url = "https://mcp-bis.keystonehub.io/mcp"
headers = { Authorization = "Bearer ${BIS_MCP_TOKEN}" }
startup_timeout_sec = 120

사용 가능한 스킬

BIS MCP는 기획 문서, 구현 비교, HTML 프로토타입, 디자인 표준, BisFramework 구현 컨벤션을 함께 다룹니다.

planning bis-docs-scaffold

BIS-Docs 패키지 생성

업무영역/기능 폴더, planning 디렉토리, index.yaml, path_safety 기준을 맞춰 새 기획 패키지를 만든다.

호출 예시
새 패키지, 기획 폴더, index.yaml, 업무영역 추가
Claude / Codex
bis-docs-scaffold / bis-docs-scaffold
MCP
bis://skills/bis-docs-scaffold · bis_docs_scaffold
quality bis-docs-doc-qa

BIS-Docs 문서 QA

문서 구조, 경로 보안, 진입점, 기획 품질 체크리스트를 검증하고 PASS/CONDITIONAL/BLOCKED로 판정한다.

호출 예시
문서 QA, 정합성 검사, doc qa, PR 전 점검
Claude / Codex
bis-docs-doc-qa / bis-docs-doc-qa
MCP
bis://skills/bis-docs-doc-qa · bis_docs_doc_qa
planning bis-manual-planning

BIS 수동 기획 3단계

Odyssey 자동 생성 없이 docs/기획 운영 계약.md와 3단계 템플릿으로 기획초안, 기획상세안, 개발하네스 전달문을 만든다.

호출 예시
수동 기획, 3단계 기획 문서, MVP/FULL/FEATURE/IMPROVEMENT별 수동 기획
Claude / Codex
bis-manual-planning / bis-manual-planning
MCP
bis://skills/bis-manual-planning · bis_manual_planning
analysis bis-plan-compare

기획-구현 갭 비교

PRD, FunctionalSpec, IA, 화면설계와 BisFramework 코드/메뉴/API/DB 매핑을 비교해 한국어 갭 리포트를 만든다.

호출 예시
기획과 구현 비교, PRD 검토, 구현 전 갭 분석
Claude / Codex
bis-plan-compare / bis-plan-compare
MCP
bis://skills/bis-plan-compare · bis_plan_compare
handoff bis-ui-prototype-react-contract

HTML 프로토타입 계약

HTML 프로토타입을 정적 목업이 아니라 React 구현 의도를 보존한 화면 계약으로 만든다.

호출 예시
HTML 프로토타입, TSX 전환, BisFramework 화면, 기획 의도대로 화면
Claude / Codex
bis-ui-prototype-react-contract / bis-ui-prototype-react-contract
MCP
bis://skills/bis-ui-prototype-react-contract · bis_ui_prototype_react_contract
design bis-design-review

BIS 디자인 리뷰

BisFramework 구현 화면, prototype HTML, 신규 시안/기획을 디자인 표준과 기획 의도 양쪽에서 검토한다.

호출 예시
디자인 검토, UI/UX 개선안, 디자인 QA, 레이아웃 표준
Claude / Codex
bis-design-review / bis-design-review
MCP
bis://skills/bis-design-review · bis_design_review
design bis-design-build

디자인 시스템 반영

토큰, 블록, 패턴, 위젯 추출, FINDINGS 승격, 신규 프로젝트 이식 등 디자인 시스템 변경을 실행한다.

호출 예시
디자인 시스템 구축, 토큰 추가, 위젯 추출, FINDINGS 반영
Claude / Codex
bis-design-build / bis-design-build
MCP
bis://skills/bis-design-build · bis_design_build
planning bisframework-plan

BISFramework 기획 라우터

BisFramework 코드 repo, BIS-Docs 기획 repo, Odyssey Harness 자동화 repo를 구분하고 올바른 경로/브랜치로 기획 자동화 명령을 실행하게 한다.

호출 예시
BISFramework plan, Odyssey plan/validate/reflect/propose, repo 경로 확인, 기획 자동화 라우팅
Claude / Codex
bisframework-plan / bisframework-plan
MCP
bis://skills/bisframework-plan · bisframework_plan
implementation bisframework-scaffold

BisFramework 구현 컨벤션

BisFramework 페이지/컴포넌트 작업에서 경로, 토큰, 레이아웃, 네이밍, 반복 실수 방지 규칙을 적용한다.

호출 예시
BisFramework 페이지, 컴포넌트 생성, 구현 컨벤션
Claude / Codex
bisframework-scaffold / bisframework-scaffold
MCP
bis://skills/bisframework-scaffold · bisframework_scaffold
migration organize-bis-docs

BIS-Docs 폴더 정리

흩어진 기획 자료를 Odyssey Harness가 읽을 수 있는 canonical 구조로 정리한다.

호출 예시
문서 폴더 정리, 기존 자료 구조화, harness layout
Claude / Codex
organize-bis-docs / organize-bis-docs
MCP
bis://skills/organize-bis-docs · organize_bis_docs

호출 예시

팀원은 tool 이름을 외우지 않아도 됩니다. 아래처럼 업무 요청을 말하면 MCP 스킬이 필요한 컨텍스트를 제공합니다.

01

기획 패키지 시작

BIS MCP로 BisFramework 견적서 화면 기획 패키지 만들어줘. index.yaml까지 포함해.

bis-docs-scaffold -> bis-docs-doc-qa
02

수동 기획 3단계 작성

Odyssey 자동 생성 없이 기획 운영 계약 기준으로 MVP 수동 기획 3단계 문서 만들어줘.

bis-manual-planning -> bis-docs-doc-qa
03

구현 전 갭 분석

이 PRD와 현재 BisFramework 구현 차이를 BIS MCP로 비교해서 BLOCKER 중심으로 정리해줘.

bis-plan-compare
04

프로토타입 핸드오프

이 HTML 프로토타입이 React 구현 계약으로 충분한지 BIS MCP 스킬 기준으로 점검해줘.

bis-ui-prototype-react-contract -> bis-design-review
05

디자인 표준 반영

반복된 디자인 FINDINGS를 BisFramework 디자인 시스템에 승격할 수 있는지 검토하고 반영 계획을 만들어줘.

bis-design-review -> bis-design-build
06

QA TC 엑셀 내보내기

이 워크스페이스에서 생성된 QA TC를 BIS 표준 엑셀 결과본으로 내보내줘.

odyssey-harness CLI: scripts/qa-tc-excel.mjs --auto

QA TC 엑셀 결과본

Odyssey가 생성한 QA TC를 BIS 표준 TC 양식(요약 시트 + 진행 차트 + 화면별 11컬럼 시트)으로 내보냅니다. odyssey-harness 저장소에서 실행합니다.

워크스페이스 자동 구성 (권장) 
node scripts/qa-tc-excel.mjs \
  --title "투자심의평가" --tc-date 2026-07-19 \
  --out "투자심의평가_TC_v1.0.xlsx" \
  --auto "$BIS_DOCS_REPO_PATH/BisFramework/_odyssey/bis-framework"
시트 개별 지정 
node scripts/qa-tc-excel.mjs --out 결과.xlsx \
  --sheet "평가 목록=<task>/canonical/qa-test-contract.json" \
  --sheet "P002 중요 확인함=<path>/qa-matrix.md"
--auto는 워크스페이스 루트의 tasks/*/canonical에서 qa-test-contract.json(우선)·qa-matrix.md를 task당 시트 1개로 자동 구성합니다. 시트 이름은 task-matrix.json의 label을 따르고, 결과본은 전 항목 Not Test 마스터입니다. TC 정의의 단일 출처는 qa-test-contract.json입니다 — 엑셀에서 TC를 추가·수정하지 말고 요구사항 보완 후 재생성하세요. QA 실행 증거는 qa/runs/<run-id>/qa-run.json에 기록합니다.

운영 메모

원격 서버 화면에는 토큰, 사내 경로, 고객 데이터, 비공개 문서 내용을 표시하지 않습니다.

/mcp 엔드포인트는 기존 MCP transport를 그대로 유지해야 합니다. 이 화면은 root, setup, skills 같은 안내 라우트에만 연결하고, 인증/도구 실행 라우트는 기존 Worker 구현을 보존하세요.