sbx mcp load — 등록된 MCP 서버를 샌드박스에 로드

sandbox mcp의 하위 명령인 sbx mcp load는 이미 등록된 MCP 서버를 실행 중인 샌드박스의 게이트웨이에 붙여요. 에이전트 재시작 없이 표준 MCP tools/list_changed 알림을 통해 연결된 에이전트가 새 서버의 도구를 즉시 볼 수 있어요.

출처: 문서

본문

설명 (Description)

이전에 등록한 MCP 서버를 실행 중인 샌드박스의 게이트웨이에 붙여요. 연결된 에이전트는 표준 MCP tools/list_changed 알림을 통해 새 서버의 도구를 즉시 보게 되고 에이전트 재시작이 필요 없어요.

서버는 로컬 MCP 저장소에 이미 존재해야 해요 (먼저 sbx mcp add로 등록하세요). 원격/호스팅 및 로컬 stdio 서버 모두 지원돼요.

--cloud 사용 시: 실행 중인 클라우드 샌드박스의 게이트웨이에 MCP 서버를 로드해요.

로컬 등록은 없어요: 클라우드 게이트웨이가 서버 이름을 스스로 해석하고, 샌드박스는 이름이나 sbx_ ID로 줄 수 있어요. 연결된 에이전트는 새 서버의 도구를 즉시 보게 돼요.

옵션 (Options)

| 옵션 | 기본값 | 설명 | | --sandbox | | 대상 샌드박스 이름 (필수) |

전역 옵션 (Global options)

| 옵션 | 기본값 | 설명 | | --cloud | | 로컬 sandboxd 대신 Docker Cloud Sandboxes API로 디스패치 (점점 더 많은 동사 지원 — 현재 목록은 'sbx --cloud --help' 실행) | | -D, --debug | | 디버그 로깅 활성화 |

예시 (Examples)

# 등록한 뒤 실행 중인 샌드박스 'my-sbx'에 로드
sbx mcp add notion --url https://mcp.notion.com/mcp
sbx mcp load notion --sandbox my-sbx

# 로컬 stdio 서버
sbx mcp add github --command npx --args @modelcontextprotocol/server-github
sbx mcp load github --sandbox my-sbx

# 클라우드: 게이트웨이가 아는 서버를 이름/ID로 클라우드 샌드박스에 로드
sbx --cloud mcp load notion --sandbox my-sbx

더 알아보기 (Learn more)

서버 등록은 sbx mcp add, 목록은 sbx mcp ls를 참고해요.