Claude 에 ZeroCloud MCP 연결하기

MCP 로 연결하면 Claude 같은 AI 에이전트가 내 ZeroCloud 팀 · 프로젝트 · 리소스를 조회하고, 리소스를 만들거나 토큰을 발급할 수 있어요. AI 는 연결한 사람의 권한으로만 움직여요.

MCP 연결은 지금 연결 권한이 열린 계정에서만 돼요. 권한이 없으면 허용 화면에 「이 계정에는 MCP 연결 권한이 없습니다」 가 떠요. 필요하면 문의해 주세요.

1. 주소 하나로 연결하기 (권장)

토큰을 복사할 필요가 없어요. 주소는 다음 하나예요.

https://api.zerocloud.im/mcp

claude.ai · Claude 데스크톱

설정 › 커넥터 › 커스텀 커넥터 추가 를 눌러요
위 주소를 붙여 넣고 연결해요
브라우저에 ZeroCloud 허용 화면이 열려요. 로그인돼 있지 않으면 로그인한 뒤 돌아와요
허용 을 누르면 끝이에요

Claude Code

claude mcp add --transport http zerocloud https://api.zerocloud.im/mcp

그다음 Claude Code 에서 /mcp 를 열고 zerocloud 를 골라 로그인 · 허용해요.

연결된 앱은 콘솔 마이페이지 › MCP 토큰 목록에 「<앱 이름> (OAuth)」 로 보여요. 여기서 폐기 하면 그 연결이 바로 끊겨요.

2. 봇 · CI 용 — 토큰으로 연결하기

브라우저가 없는 곳(서버 · CI · 봇)은 토큰을 헤더에 넣어요.

콘솔 마이페이지 › MCP 토큰 에서 토큰 이름(예: 맥북 Claude Code)을 넣고 토큰 발급 을 눌러요
「토큰 (지금 복사하세요)」 에 뜬 값을 복사해 둬요. zc_mcp_ 로 시작해요
클라이언트에 넣어요

claude mcp add --transport http zerocloud \
  https://api.zerocloud.im/mcp \
  --header "Authorization: Bearer <토큰>"

다른 MCP 클라이언트(JSON 설정)는 이렇게 넣어요.

{
  "mcpServers": {
    "zerocloud": {
      "type": "http",
      "url": "https://api.zerocloud.im/mcp",
      "headers": { "Authorization": "Bearer <토큰>" }
    }
  }
}

콘솔 개발자 센터 에도 같은 설정(Codex 포함)이 복사 가능한 형태로 있어요.

무엇을 할 수 있나

내 팀 · 프로젝트 · 리소스 조회
리소스 만들기 · 자격증명 바꾸기
리소스 토큰 발급 · 회수 — 발급한 토큰 값은 그 응답에만 나와요. 바로 안전한 곳에 보관하세요

팀 플랜이나 역할 때문에 막힌 작업은 AI 가 거절 사유를 그대로 알려 줘요.

끝났는지 확인

Claude 에게 「내 ZeroCloud 팀 목록 보여 줘」 라고 해 보세요. 팀 이름이 나오면 끝이에요.

막히면 → 자주 막히는 곳