sbx mcp ls — MCP 서버 목록 표시

sandbox mcp의 하위 명령인 sbx mcp ls는 등록된 MCP 서버를 그 서버를 제공하는 게이트웨이 기준으로 나열해요. 각 서버가 어디서 실행되는지, 누가 제어하는지, 전송 방식과 현재 사용 가능 여부, 그리고 필요한 후속 단계(인가·시크릿 설정)를 보여줘요.

출처: 문서

본문

설명 (Description)

그 서버를 제공하는 게이트웨이 아래의 등록된 MCP 서버를 나열해요.

GATEWAY 열은 각 서버가 어디서 실행되는지, 누가 제어하는지, 서명된 신원을 보고해요. 각 행은 전송(transport) 방식과 지금 사용 가능한지도 보고해요. 인가가 필요한 서버는 sbx mcp auth라는 후속 단계를 갖게 돼요.

사용자 지정 헤더로 등록된 서버는 그렇게 표시되고, 헤더 플레이스홀더에 저장된 값이 없는 서버는 sbx secret set이라는 후속 단계를, 이 게이트웨이가 보낼 수 없는 헤더를 가진 서버는 지원되지 않음으로 표시돼요. 어느 쪽이든 지금 상태로는 서버를 연결할 수 없어요. 헤더 자체와 각 플레이스홀더 상태는 sbx mcp inspect로 확인해요.

인가 상태는 OAuth 흐름을 시작하지 않고 읽혀요 — 로컬 데이터 플레인 모드에서는 로컬 토큰 저장소에서, 그 외에는 호스팅 컨트롤 플레인에서.

--cloud 사용 시: 기존 클라우드 샌드박스 게이트웨이가 보고하는 MCP 서버를, 각 서버를 참조하는 샌드박스와 함께 나열해요. 게이트웨이가 건너뛴 서버는 제외돼요. 이는 구성된 서버의 완전한 인벤토리가 아니에요: 사용되지 않은 구성과 서버 이름을 보고하지 않는 게이트웨이는 없어요(--quiet에서도).

샌드박스를 지정하면 해당 게이트웨이 상태·호스트, 요청된 서버, 건너뛴 서버를 보여줘요.

옵션 (Options)

| 옵션 | 기본값 | 설명 | | --json | | JSON 형식으로 출력 | | -q, --quiet | | MCP 서버 이름만 표시 |

전역 옵션 (Global options)

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

예시 (Examples)

sbx mcp ls

# 스크립팅용 기계가독성 출력
sbx mcp ls --json

# 클라우드: 기존 샌드박스에 걸쳐 보고된 서버 나열
sbx --cloud mcp ls

# 클라우드: 이름 또는 sbx_ ID로 클라우드 샌드박스의 게이트웨이 표시
sbx --cloud mcp ls my-sbx

더 알아보기 (Learn more)

서버 등록은 sbx mcp add, 상세는 sbx mcp inspect를 참고해요.
인가가 필요한 서버는 sbx mcp auth를 참고해요.