Busymate는 기기, 캡처된 트래픽, 설정, 규칙, 내보내기, 휴대폰 팜을 아우르는 454개의 도구, 즉 대시보드 전체를 하나의 호스트 이름에서 MCP 서버로 노출합니다. Claude Code는 HTTP 위의 MCP를 기본으로 지원하므로 연결은 명령 하나입니다. 인증은 표준 OAuth 2.1입니다. 클라이언트가 스스로 등록하고, 브라우저를 열고, 평소 쓰는 Busymate 계정으로 로그인해 한 번 승인하면, 그 결과로 나온 토큰을 모든 도구 호출이 지니고 갑니다. 만들거나 붙여 넣거나 교체할 API 키는 없습니다.
이 가이드는 연결을 처음부터 끝까지 안내한 뒤, 가장 먼저 효과를 보는 세 가지 프롬프트 유형을 보여 줍니다. 실시간 피드 읽기, 캡처된 API 흐름 설명하기, 기기에서 작업하기. 그리고 브라우저 왕복 한 번을 아껴 주는 유일한 유지 관리 습관, 즉 서버 업데이트 후에는 다시 연결만 하고 절대 다시 인가하지 않는 법도 다룹니다.
필요한
내 컴퓨터의 Claude Code, Busymate 계정, 그리고 물어볼 거리가 있도록 트래픽을 캡처한 기기 하나.
설치된 Claude Code와 그 명령을 실행할 터미널.
브라우저에서 로그인할 수 있는 Busymate 계정. 대시보드가 쓰는 계정과 같습니다.
최근 트래픽이 있는 페어링된 기기 최소 한 대. iPhone, Android, 프록시 클라이언트, 캡처 중인 Chrome 중 하나. iPhone 가이드가 가장 빠른 길입니다.
사용하려는 권한을 가진 역할. 읽기에는 보기 권한이, 요청 재전송이나 기기 설정 변경 같은 작업에는 소유한 기기에 대한 편집 권한이 필요합니다.
순서대로
연결에 두 단계, 확인에 한 단계, 가치를 얻는 데 세 단계, 건강하게 유지하는 데 한 단계.
- 01
터미널에서 서버 추가하기
아래 명령을 실행하세요. HTTP 전송과 정식 엔드포인트를 사용해 Busymate를 Claude Code의 원격 MCP 서버로 등록합니다. 명령에 다른 것은 필요 없습니다. 토큰도, 헤더도, 클라이언트 ID도 없습니다. 도구 검색은 인증 전에 제공되므로 Claude Code는 서버가 제공하는 것을 바로 나열할 수 있습니다.
단 하나의 명령 bash# Claude Code — add the server, then authorize in your browser on the first tool call claude mcp add --transport http busymate-devtools https://mcp.busymate.dev - 02
첫 도구 호출 때 브라우저에서 인가하기
도구가 필요한 무엇이든 Claude Code에 요청하면 OAuth 흐름이 시작됩니다. 클라이언트가 서버에 등록하고, PKCE 챌린지와 함께 Busymate 자체 로그인 페이지를 브라우저에서 열고, 당신이 로그인해 승인하면, 브라우저가 일회용 코드를 클라이언트에 돌려주고 클라이언트는 이를 액세스 토큰으로 교환합니다. Claude Code가 연결을 확인합니다. 이 중 어느 것도 직접 하지 않으며, 로그인 페이지는 한 번만 보게 됩니다.
이 토큰은 대시보드 내장 콘솔이 쓰는 것과 같은 종류이며, MCP뿐 아니라 모든 Busymate 서비스를 인증합니다. 연결하는 각 클라이언트는 당신의 계정에 대해 고유한 허가를 받습니다. 개별로 철회할 수 있고, 모두 당신의 단일 역할 아래 동작하며, 모두 감사 로그에 보입니다.
- 03
읽기 전용 질문으로 확인하기
읽기만 하는 것으로 시작하세요. 어떤 기기가 온라인인지, 그중 하나가 최근 무엇을 캡처했는지, 또는 지난 한 시간 동안 어떤 호스트가 특정 상태를 반환했는지 물어보세요. Claude Code가 맞는 도구를 고르고, 답은 추측이 아니라 기기 이름, 호스트, 경로, 상태 같은 실제 데이터에서 나옵니다.
연결을 증명하는 첫 두 프롬프트 textWhich of my devices are online right now, and what did the iPhone capture in the last 10 minutes? Across all my devices, which hosts returned 401 in the last hour? - 04
캡처된 API 흐름을 설명하게 하기
이 연결이 존재하는 이유가 바로 이 프롬프트입니다. 휴대폰에서 캡처한 호스트를 지정하고(브랜드 이름만이 아니라 점이 있는 전체 호스트 이름을 쓰세요) 앱이 어떻게 인증하는지 물어보세요. Claude Code는 실제 요청과 응답의 헤더와 본문을 읽고, 흐름을 재구성하고, 실행 가능한 재현 코드를 써 줄 수 있습니다. 캡처된 트래픽의 토큰, 쿠키, 자격 증명은 비밀로 취급되어 돌려주는 모든 내용에서 자리표시자로 대체됩니다.
휴대폰이 방금 수행한 로그인 흐름 설명하기 textLook at the captured traffic for identity.example.com and tell me exactly how the app authenticates — the endpoint, the headers it needs, and the request body shape. Then write a curl command that reproduces the login call. - 05
작업하게 두기, 단 확인 게이트 뒤에서
무언가를 바꾸는 도구, 즉 요청 재전송, 기기의 VPN 전환, 다른 나라의 상위 프록시를 통한 트래픽 라우팅, 차단 규칙 편집 등은 서버에서 확인 게이트가 걸립니다. Claude Code는 하려는 작업을 보여 주고 당신의 승인을 기다립니다. 모든 것은 당신으로서, 역할의 권한과 소유한 기기로 제한되어 실행되므로, 클라이언트는 대시보드에서 당신이 할 수 있는 것 이상을 절대 할 수 없습니다.
작업 프롬프트. 모든 쓰기는 실행 전에 묻습니다 textResend the last failed checkout request from my iPhone, then route that phone through a proxy in Germany and confirm its public IP changed. - 06
시리즈의 나머지와 결합하기
다른 가이드가 손으로 하는 모든 일이 여기서는 한 문장입니다. 오늘 어느 호스트의 HAR 내보내기, 로그인 엔드포인트의 일회성 401 모킹, 현재 브레이크포인트 패턴, 팜의 모든 휴대폰 스크린샷을 요청하세요. Claude Code가 말을 도구에 대응시키며, 같은 역할과 확인 규칙이 적용됩니다.
- 07
서버 업데이트 후에는 다시 연결만, 절대 다시 인가하지 않기
서버는 자주 재배포되고 새 도구가 들어옵니다. 배포 전에 연결한 클라이언트는 오래된 도구 목록을 갖고 있을 수 있습니다. 도구가 없어 보이거나 설명이 낡은 경우입니다. 서버가 변경을 알리므로 대부분의 클라이언트는 스스로 반영하지만, 그렇지 않다면 Claude Code 세션을 재시작하세요. 로그아웃하거나 서버를 삭제하지 마세요. 토큰은 배포를 거쳐도 유효하고, 다시 동의하는 데는 브라우저 왕복 한 번만 더 듭니다. 언젠가 깨끗하게 다시 추가하고 싶다면 항목을 먼저 제거하고 다시 추가하세요. 허가는 남아 있으므로 두 번째 로그인을 요구받지 않습니다.
깨끗한 재추가도 기존 허가를 유지합니다 bashclaude mcp remove busymate-devtools claude mcp add --transport http busymate-devtools https://mcp.busymate.dev
잘못될 수
이 모든 것은 장애처럼 보이지만 프로토콜이 명세대로 동작하는 것입니다.
브라우저에서 엔드포인트를 열면 401이 나옴
명세가 그렇습니다. 맨 요청은 로그인 흐름의 위치를 클라이언트에 알려 주는 OAuth 챌린지와 함께 401을 반환합니다. MCP 클라이언트는 그 챌린지에서 자동으로 이어 갑니다. 아무것도 죽지 않았습니다.
브라우저 창이 열리지 않았음
Claude Code는 인가 URL도 출력합니다. 아무 브라우저에나 복사하세요. 흐름은 일반 웹 로그인이며 끝나면 클라이언트에 제어를 돌려줍니다.
도구는 나열되지만 모든 호출이 거부됨
검색은 인증 전에 제공되지만 무엇이든 호출하려면 OAuth 허가가 필요합니다. 클라이언트가 시작한 브라우저 인가를 완료하거나, 토큰이 철회되었다면 다시 트리거한 뒤 재시도하세요.
문서에 있는 도구가 보이지 않음
배포 후 오래된 도구 목록입니다. 세션을 재시작해 클라이언트가 표면을 다시 검색하게 하세요. 그래도 없다면 역할에 그 도구를 보호하는 권한이 없는 것일 수 있습니다.
보이는 기기에 대한 작업이 거부됨
작업은 소유한 기기와 역할의 편집 권한으로 제한됩니다. 워크스페이스 관리자에게 권한 부여를 요청하거나, 자신의 기기에서 작업을 실행하세요.
자주 묻는
어딘가에 보관해야 할 API 키가 있나요?
없습니다. 접근은 계정과 해당 클라이언트에 묶인 OAuth 허가입니다. 컴퓨터를 잃어버리면 대시보드에서 철회하세요. 교체할 것은 없습니다.
Cursor, VS Code, Claude Desktop에서도 똑같이 동작하나요?
네. HTTP 전송과 동적 클라이언트 등록이 있는 OAuth 2.1을 지원하는 모든 클라이언트가 같은 엔드포인트에 연결됩니다. 설치 페이지에 각각의 복사-붙여넣기 설정과 원클릭 링크가 있습니다.
내 트래픽에서 본 토큰을 유출할 수 있나요?
캡처된 자격 증명은 설명과 재현 스니펫에서 가려지고, 읽기는 역할과 기기로 제한되며, 쓰기는 확인 게이트가 걸립니다. 원본 HAR 내보내기는 민감하게 다루세요. 에이전트의 답변은 그렇지 않습니다.