Pick
Cursor와 VS Code는 클릭 한 번. 나머지는 같은 URL을 붙여넣고 첫 사용 시 승인합니다.
Claude Code
터미널에서 서버를 추가하세요. 첫 도구 호출 시 브라우저가 열리며 승인할 수 있습니다.
- 01
아래 명령을 터미널에서 실행하세요 — 기본적으로 이 프로젝트에만 추가됩니다. 모든 프로젝트에서 쓸 수 있게 하려면
--scope user를 추가하세요. - 02
첫 도구 호출 시 브라우저가 열려 로그인 및 승인을 요청합니다 — 승인하면 Claude Code가 연결을 확인해 줍니다.
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev확인:claude mcp list를 실행하세요(또는 Claude Code 안에서 /mcp) — busymate-devtools가 연결됨으로 표시되고 454개 도구를 모두 호출할 수 있습니다.
Claude.ai & Claude Desktop
Settings → Connectors → Add custom connector에서 URL을 붙여넣고 Connect를 클릭한 뒤 브라우저에서 승인하세요. 편집할 파일은 없습니다.
- 01
설정 → 커넥터를 열고 +를 클릭한 다음 사용자 지정 커넥터 추가를 선택하세요.
- 02
아래 URL을 원격 서버 URL로 붙여넣고 Add를 클릭하세요 — OAuth Client ID/Secret 필드는 비워두면 됩니다. Busymate에는 필요하지 않습니다.
- 03
Claude가 브라우저를 열어 로그인을 요청합니다 — 승인하면 커넥터가 연결됨으로 표시됩니다.
https://mcp.busymate.dev확인:커넥터를 다시 열면 454개 도구가 모두 표시되며, Claude는 대화 중에도 이를 호출할 수 있습니다.
Cursor
클릭 한 번으로 추가하고 OAuth로 승인합니다. 직접 ~/.cursor/mcp.json(전역)이나 프로젝트의 .cursor/mcp.json에 추가할 수도 있습니다:
- 01
원클릭 설치는 Add to Cursor를 클릭하세요. 또는 아래 블록을
~/.cursor/mcp.json(전역) 또는 프로젝트의.cursor/mcp.json에 직접 추가하세요. - 02
Cursor Settings → MCP를 열고 아직 활성화되지 않았다면 서버를 켜세요.
- 03
첫 도구 호출 시 승인을 위해 브라우저가 열립니다 — Cursor가 OAuth 핸드셰이크를 직접 완료하므로 client ID나 secret을 붙여넣을 필요가 없습니다.
{
"mcpServers": {
"busymate-devtools": {
"url": "https://mcp.busymate.dev"
}
}
}확인:Cursor Settings → MCP에서 busymate-devtools가 활성화됨으로 표시되며, 옆에 도구 개수가 함께 나타납니다.
VS Code (Copilot)
클릭 한 번으로 VS Code에 설치됩니다. 직접 워크스페이스의 .vscode/mcp.json에 추가할 수도 있습니다(루트 키는 servers):
- 01
원클릭 설치는 Install in VS Code를 클릭하세요. 또는 아래 블록을 워크스페이스의
.vscode/mcp.json에 추가하거나, 모든 워크스페이스에 적용하려면 MCP: Open User Configuration을 실행하세요. - 02
처음에는 VS Code가 서버를 신뢰할지 묻습니다 — 승인한 다음 항목 위의 code lens에서 Start를 클릭하세요(또는 명령 팔레트에서 MCP: List Servers 실행).
- 03
VS Code가 OAuth 핸드셰이크를 위해 브라우저를 엽니다 — 로그인하고 승인하세요.
{
"servers": {
"busymate-devtools": {
"type": "http",
"url": "https://mcp.busymate.dev"
}
}
}확인:명령 팔레트에서 MCP: List Servers를 실행하세요 — busymate-devtools가 Running으로 표시되고 454개 도구가 모두 나열됩니다.
ChatGPT
개발자 모드 커넥터가 제공되는 경우: Settings → Connectors → Add에서 URL을 붙여넣고 승인하세요. 제공 여부는 요금제에 따라 다릅니다.
- 01
개발자 모드 커넥터를 켜세요 — ChatGPT 설정에서 Developer mode 또는 Connectors를 검색하세요(메뉴의 정확한 위치는 이전에 바뀐 적이 있습니다. Plus, Pro, Business 이상 요금제가 필요하며, 워크스페이스 관리자가 이를 제한할 수 있습니다).
- 02
사용자 지정 커넥터를 추가하고 아래 URL을 붙여넣으세요.
- 03
열리는 브라우저 탭에서 승인하세요.
https://mcp.busymate.dev확인:커넥터가 연결됨으로 표시됩니다. ChatGPT에게 Busymate DevTools 도구를 사용해 달라고 요청하면 오류 없이 호출되어야 합니다.
그 외 모든 MCP 클라이언트
Streamable-HTTP 트랜스포트는 표준입니다 — Continue, Cline, Zed, 직접 만든 봇도 같은 설정을 씁니다. 이 URL로 향하게 하세요:
- 01
클라이언트가 Streamable HTTP 전송(stdio 전용이 아님)을 지원하고 Dynamic Client Registration을 사용한 OAuth 2.1을 지원하는지 확인하세요 — 대부분의 최신 클라이언트가 이를 지원합니다.
- 02
클라이언트가 기대하는 설정 형식으로 아래 URL을 지정하세요 — 이 블록은 대부분의 클라이언트가 그대로 읽을 수 있는 일반적인
mcpServers형식입니다. - 03
처음 사용할 때 브라우저 프롬프트에서 승인하세요. 위의 모든 클라이언트와 동일합니다.
{
"mcpServers": {
"busymate-devtools": {
"url": "https://mcp.busymate.dev"
}
}
}확인:승인이 완료되면 tools/list 호출로 454개 도구가 모두 반환됩니다.
What happens on
The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.
- 01
Your client registers itself
Dynamic Client Registration (RFC 7591): the client POSTs its own metadata and receives a client id. There's nothing to create in a console first.
- 02
You authorize in the browser
A browser window opens on Busymate's own sign-in. You approve once; PKCE protects the code exchange end to end.
- 03
Tools appear
The client lists the tools and your agent starts calling them — as you, scoped to your role, with destructive tools confirm-gated.
- 04
The token keeps working
Refresh rotation keeps the grant alive, and the same token also authenticates REST, WebSockets and Edge Functions. Revoke it any time — every call it made is in your audit trail.
Your account,
접근은 Dynamic Client Registration과 PKCE를 갖춘 OAuth 2.1입니다 — 붙여넣는 키도, 공유 시크릿도 없습니다. 에이전트가 받는 단 하나의 토큰이 모든 Busymate 표면(MCP, REST, WebSockets, Edge Functions)을 인증하며 여러분의 역할로 범위가 제한됩니다: 에이전트는 여러분이 대시보드에서 할 수 있는 것만 할 수 있습니다.
- RBAC 범위 제한
- 확인 게이트
- 시크릿 마스킹
OAuth 2.1, 키 없이
Dynamic Client Registration(RFC 7591) + PKCE(S256) + 리프레시 로테이션. 사용자는 Busymate 로그인으로 브라우저에서 승인합니다 — 붙여넣거나 유출될 API 키 자체가 없습니다.
역할로 범위 제한
모든 호출은 데이터베이스 자체가 승인합니다(RBAC). 파괴적 도구는 명시적 확인을 요구하며, 시크릿 값은 절대 반환되지 않습니다 — 쓰기 전용이며 가려집니다.
완전한 감사 기록
모든 도구 호출 — 모든 에이전트, 모든 동작 — 이 계정의 감사 로그에 남아, 에이전트가 여러분 대신 무엇을 했는지 언제든 확인할 수 있습니다.
What your agent can
사람이 UI에서 할 수 있다면, 에이전트도 MCP로 할 수 있습니다.
트래픽 캐처와 검사
캐처된 요청과 응답을 검색·검사·태깅·내보내기(HAR)·요약·삭제 — 디바이스별로든 함대 전체로든.
디바이스 제어
목록 조회, 이름 변경, 페어링 해제, VPN 전환, 연결 유형 설정, 디바이스 송신을 업스트림 프록시로 라우팅.
원격 브라우저 구동
원시 Chrome DevTools Protocol 패스스루 — 연결된 디바이스의 Chrome을 열고, 평가하고, 스크린샷과 스냅샷을 찍으세요.
폰 팔 자동화
Android·iOS 디바이스 팔 자동화 — 탭, 입력, 스와이프, 설치, 앱 생명주기 관리를 라이브 미러링과 함께.
요청 스크립팅과 성형
샌드박스 요청/응답 스크립트, 자동 차단 규칙, 브레이크포인트, 일시중지 도메인 — 트래픽을 비행 중에 변형하거나 합성하세요.
플랫폼 운영
역할과 권한(RBAC), TestFlight 베타 관리, 과금, 조회 가능한 감사 로그, 알림, 할 일, 워크스페이스, BusyBro 팀 메모리.
If something
The answers below cover every first-connect snag we've actually seen — most are the protocol working as designed.
The endpoint answers 401 in my browser — is it down?
No — that's the spec working. A bare GET on mcp.busymate.dev returns 401 with the OAuth challenge, because the URL is the OAuth resource identifier your client reads to find the sign-in flow. MCP clients proceed from that challenge automatically.
My client lists the tools but every call fails.
Tool discovery is served before authentication; calling anything requires OAuth. Finish the browser authorization your client started (or trigger it again if the token was revoked), then retry the call.
The browser window never opened.
Most clients also print the authorization URL — copy it into any browser. The flow is a normal web sign-in and hands control back to the client when it finishes.
Should I use mcp.busymate.dev or mcp.busymate.net?
Use mcp.busymate.dev for new configs. The older mcp.busymate.net serves the same server permanently and OAuth issues host-matched metadata on whichever host you connected to — existing setups never break.
Claude Code says the server already exists.
Remove the old entry first — claude mcp remove busymate-devtools — then add it again. Your OAuth grant survives; you won't have to re-authorize.
Do I need separate credentials for a bot and my editor?
No. Each client registers itself and gets its own OAuth grant against your account — individually revocable, all acting under your one role, all visible in the audit trail.
Connect in under
mcp.busymate.dev를 추가하고 한 번만 승인하면 454개 도구를 모두 호출할 수 있습니다.