문서
시스템 연결하기(MCP)
이 페이지의 목차
말만 할 수 있는 어시스턴트도 유용하지만, 작업할 수 있는 어시스턴트는 하나의 제품입니다. Busymate AI는 bro가 당신의 MCP 서버를 통해 당신의 도구를 호출하게 하므로, 설정한 규칙 아래에서 사용자를 대신해 시스템의 정보를 조회하고 변경할 수 있습니다.
MCP(Model Context Protocol)는 AI에 도구를 공개하기 위한 개방형 표준입니다. 시스템이 이미 MCP를 지원한다면 bro는 다른 MCP와 같은 방식으로 연결하므로 플랫폼 전용 연결 코드는 필요 없습니다.
bro가 사용자 데이터를 다루는 방법
어시스턴트가 무언가를 해야 할 때 MCP 서버의 도구를 호출합니다. 두 가지가 이를 안전하게 만듭니다:
- bro가 서버에 사용자가 누구인지 알려줍니다 — 서버가 검증하는, 수명이 짧고 암호학적으로 서명된 토큰을 사용합니다. 위조하거나 재사용할 수 없으므로 서버는 요청이 정확히 어느 사용자를 위한 것인지 항상 알 수 있습니다.
- 당신의 서버가 범위를 강제합니다. MCP가 사용자를 알고 있으므로 그 사용자의 데이터만 반환하고 변경합니다. bro는 서버가 제공한 것 이상을 볼 수 없습니다.
권한 단계
공개하는 모든 도구에 단계를 지정해, 어시스턴트가 요청자에게 적합한 범위에만 접근하게 합니다:
| 단계 | 대상 | 허용하는 것 |
|---|---|---|
| Public | 게스트를 포함한 누구나 | 제품 정보, 일반 도움말처럼 안전하고 개인 정보가 아닌 읽기. |
| Identified | 로그인한 사용자 | 자신의 데이터만 읽고 작업. |
| Delegated | 승인이 필요한 작업을 수행하는 로그인한 사용자 | 명시적으로 사용자 승인을 받고 싶은 작업에 대해 같은 범위. |
| Confirm | 당신이 표시한 모든 쓰기 작업 | 실행 전 사용자가 확인해야 하며, 먼저 전체 작업을 표시. |
파괴적이거나 민감한 작업은 Confirm 뒤에 보류됩니다. bro는 무엇을 하려는지 정확히 보여주고 사람의 “예”를 기다립니다. 어떤 쓰기도 조용히 실행되지 않습니다.
설정하기
Busymate AI Console의 Integration 섹션이 이 설정의 단일 정보원입니다. 선택한 테넌트의 실시간 설정에서 생성되므로 URL, 신원 값, 코드 조각, 출시 체크리스트가 항상 최신이며, 별도의 인계 문서를 동기화할 필요가 없습니다.
- Console → Integration을 열고 설정할 테넌트를 선택합니다.
- MCP 단계에 따라 Connections로 이동해 서버 URL과 자격 증명 바인딩을 추가한 다음 프로브를 실행합니다.
- 발견된 모든 도구를 검토하고 Public, Identified, Delegated, Confirm 정책을 신중하게 배정합니다.
- preflight를 실행하고 테넌트 리비전을 게시합니다. 실패한 프로브나 불완전한 신원 계약은 일부만 연결된 어시스턴트를 만드는 대신 게시를 차단합니다.
Integration 섹션에는 에이전트로 동일한 테넌트 범위 워크플로를 수행하려는 팀을 위해 복사 가능한 자동화 안내와 Busymate AI 관리 MCP 엔드포인트도 있습니다. 시작하기를 참고하세요.
Claude Code를 관리용 MCP에 연결하기
명령 하나면 됩니다. 브라우저가 평소 계정으로 로그인을 처리합니다(OAuth 2.1 — 붙여넣을 것이 없습니다):
claude mcp add --transport http busymate-ai https://busymate.ai/mcp그런 다음 Claude Code에서 /mcp 를 실행하고 busymate-ai → 인증 을 선택하세요. 다른 HTTP-MCP 클라이언트(Claude Desktop, Cursor, …)는 URL https://busymate.ai/mcp 만으로 연결됩니다 — OAuth 디스커버리가 엔드포인트와 오리진 모두에서 제공되므로 URL 외에 클라이언트 측 설정이 필요하지 않습니다.
사용자가 자신의 계정을 연결하기
화이트라벨 커넥터에는 사용자별 OAuth 위임을 사용할 수 있습니다. 당신이 운영하지 않는 서비스에서 각 사용자가 자신의 계정을 승인해야 할 때 사용하세요. Connections에서 커넥터의 OAuth 승인, 토큰, 취소 메타데이터를 설정하고 위임 도구를 게시합니다.
위임 계정 도구는 명확한 두 가지 모드를 지원합니다:
- 서명된 고객 actor 토큰 — 제품에서 이미 방문자를 검증했다면 권장합니다. Busymate AI가 MCP 서버에 수명이 짧고 테넌트와 커넥터에 바인딩된 actor 토큰을 발급하므로, 계정 접근은 자동이며 고객에게 두 번째 로그인이나 동의 화면이 나타나지 않습니다.
- 로그인한 고객별 OAuth — 별도 승인 grant가 의도적으로 필요할 때 사용합니다. 어시스턴트가 계정 도구 승인을 한 번 표시하고, PKCE를 포함한 OAuth 2.1 승인 코드 흐름을 사용하며, 서버 쪽 grant를 테넌트, 커넥터, 검증된 최종 사용자에 바인딩합니다.
두 모드 모두 실패하면 닫힙니다. MCP 서버는 검증된 bearer에서만 고객을 알아내며 도구 인수로 전달된 계정 식별자를 절대 신뢰하지 않습니다. OAuth grant는 계정 메뉴에서 취소할 수 있고, 서명된 actor 토큰은 최대 5분 안에 만료되며 하나의 커넥터에 고정됩니다.
다음
- 시작하기 — MCP를 연결하는 위치 확인하기.
- 거버넌스와 모델 정책 — 도구를 켜고 확인 규칙 설정하기.
- 어시스턴트 경험 — 작업이 사용자에게 어떻게 보이는지 확인하기.