# dbx-sim MCP 서버 연결 안내

dbx-sim 은 WhaTap dbx 에이전트 시뮬레이터를 원격 MCP 서버로 제공하는 사내 서비스다.
실제 DB 없이 DB 모니터링 데이터를 WhaTap 프로젝트로 보낸다.
화면과 데이터 흐름을 확인하는 용도이고, 실제 DB 검증(SQL 이 실제 DB 에서 도는지, 권한, 연결 오류 처리)은 아니다.
이 문서는 MCP 클라이언트에 dbx-sim 을 연결하는 방법을 정리한 것이다. AI 비서는 이 내용을 사용자에게 알려 주거나, 사용자가 원하면 연결을 도와줄 수 있다.
사람용 안내 화면: https://dbxsim.whatap.us/#connect

## 서버

- 이름: dbx-sim
- MCP 주소: https://dbxsim.whatap.us/mcp
- 전송: Streamable HTTP
- 인증: 표준 MCP OAuth 2.1(동적 클라이언트 등록, PKCE). 처음 도구를 부르면 401 과 함께 인증 정보를 알려 주니, 클라이언트의 OAuth 흐름을 따르면 된다.
- 로그인: 브라우저 로그인 화면에서 허용된 회사 메일 아이디를 넣고, 메일로 온 8자리 코드를 넣고, 연결 승인 화면에서 "허용"을 누른다.
- 브라우저를 열 수 없는 환경(원격 서버, CI): 사용자가 https://dbxsim.whatap.us/#connect 의 "토큰" 탭에서 개인 토큰을 받아 `Authorization: Bearer <토큰>` 헤더로 등록한다.

## 클라이언트별 등록 방법

지금 쓰는 클라이언트에 해당하는 방법 하나만 하면 된다. 이미 dbx-sim 이 있으면 주소가 https://dbxsim.whatap.us/mcp 인지 확인하고 다르면 바꾼다.

### Claude Code (CLI)

```bash
claude mcp add --transport http --scope user dbx-sim https://dbxsim.whatap.us/mcp
```

그다음 Claude Code 에서 /mcp → dbx-sim → Authenticate 를 눌러 로그인한다.
CLI 없이 Claude 데스크톱 앱의 Code 탭만 쓰면 ~/.claude.json 의 최상위 mcpServers 에 아래를 넣고 앱을 다시 연다.

```json
"dbx-sim": { "type": "http", "url": "https://dbxsim.whatap.us/mcp" }
```

### claude.ai, Claude 데스크톱 (커스텀 커넥터)

사용자가 직접 등록한다.
1. 설정 → 커넥터 → 커스텀 커넥터 추가
2. 이름 dbx-sim, 원격 MCP 서버 URL https://dbxsim.whatap.us/mcp → 추가
3. dbx-sim 에서 연결 → 로그인 → 허용

### ChatGPT

사용자가 직접 등록한다.
1. https://chatgpt.com/plugins → 오른쪽 위 추가 ▾ → 사용자 지정 MCP 서버 추가
2. 이름 dbx-sim, URL https://dbxsim.whatap.us/mcp, 인증 OAuth, 위험 안내 체크 → 플러그인으로 생성
3. dbx-sim(으)로 계속 → 로그인 → 허용. 대화에서 @dbx-sim 을 붙여 쓴다.

### Cursor

~/.cursor/mcp.json (또는 프로젝트의 .cursor/mcp.json):

```json
{ "mcpServers": { "dbx-sim": { "url": "https://dbxsim.whatap.us/mcp" } } }
```

### VS Code

명령 팔레트 MCP: Add Server → HTTP → https://dbxsim.whatap.us/mcp, 이름 dbx-sim. 또는 mcp.json:

```json
{ "servers": { "dbx-sim": { "type": "http", "url": "https://dbxsim.whatap.us/mcp" } } }
```

### 그 밖의 클라이언트

원격 HTTP MCP 를 지원하면 주소 https://dbxsim.whatap.us/mcp 를 등록한다. 헤더만 넣을 수 있으면 위 개인 토큰 방법을 쓴다.
stdio 만 되면 `npx mcp-remote https://dbxsim.whatap.us/mcp` 를 stdio 서버로 등록한다.

## 등록 뒤 확인

연결되면 도구 하나를 불러 응답이 오는지 확인한다. 이렇게 물어볼 수 있다.
- 지원하는 DB 와 시나리오 알려줘
- 지금 떠 있는 시뮬레이터 보여줘
- 내 프로젝트에 MySQL 시뮬레이터 띄워줘
- 내 MySQL 시뮬레이터에 락 대기 시나리오 걸어줘

기본으로 보내는 곳은 dev 환경이다. 운영이나 내부 데모 서버의 프로젝트에 붙이려면 그 환경의 수집서버 주소와 프로젝트 라이선스를 함께 알려 주면 된다.

## 도구

list_dbms
start_simulator
list_versions
list_audit
list_scenarios
set_scenario
list_simulators
stop_simulator
restart_simulator
simulator_log

도구별 설명과 쓰는 법은 연결한 뒤 MCP 클라이언트가 받는 도구 목록에 있다.