로그인 · 팀
로그인 뒤 팀이 하나도 안 보여요 초대 메일을 받았다면 같은 이메일의 구글 계정으로 로그인했는지 확인하세요. 「어디서 작업할까요?」 화면의 「받은 초대」 에서 수락 해야 팀에 들어가요. 초대 링크가 만료됐으면 팀 관리자에게 다시 보내 달라고 하세요.
「권한이 없습니다 (팀 소유자/관리자만)」 이 떠요 멤버 초대 · 역할 변경 · 채팅 앱 설치 · 채널 연결은 팀 소유자 · 관리자만 할 수 있어요. 내 역할은 콘솔 왼쪽 위 팀 이름 아래에 보여요.
리소스
「리소스 생성에 실패했습니다」 가 떠요 리소스를 만들 권한(에디터 이상)이 있는지, 같은 팀의 프로젝트인지 확인하세요. 뷰어는 보기만 할 수 있어요.
저장한 시크릿이 안 보여요 정상이에요. 시크릿은 저장한 뒤 다시 보여 주지 않고 「설정됨 · 변경하려면 입력」 으로만 표시해요. 바꿀 때만 새 값을 넣으세요.
API · SDK
401 이 나와요 리소스 토큰이 없거나 틀렸거나 회수됐어요. 토큰과 리소스 ID 가 같은 리소스의 짝인지 확인하세요. 토큰 값은 다시 조회할 수 없어서, 잃어버렸으면 새로 발급하고 옛 토큰은 회수하세요 → 내 서비스에서 리소스 쓰기
403 이 나와요
- 메일이면 발신 주소가 리소스의 허용 목록에 없을 가능성이 커요. 표시 이름까지 글자 그대로 같아야 해요 → 메일 보내기
- 리소스의 필수 자격증명이 비어 있어도 403 이에요. 리소스 상세 › 설정 · 자격증명을 채우세요
메일 요청은 성공했는데 메일이 안 와요 성공 응답은 접수만 뜻해요. 발송 서비스(SES 등) 쪽에서 발신 도메인 인증 · 발송 한도(샌드박스 여부)를 확인하고, 받는 쪽 스팸함도 보세요.
MCP
허용 화면에 「이 계정에는 MCP 연결 권한이 없습니다」 가 떠요 MCP 연결은 지금 권한이 열린 계정에서만 돼요. 문의해 주세요.
허용했는데 Claude 가 툴을 못 써요
Claude Code 는 /mcp 에서 zerocloud 가 연결됨으로 보이는지 확인하세요. 콘솔 마이페이지 › MCP 토큰 에서 그 연결을 폐기했다면 다시 연결해야 해요 → MCP 연결하기
디스코드 · 슬랙
팀 › 연동에 「서버 연결」 버튼이 없어요 팀 소유자 · 관리자에게만 보여요. 멤버는 관리자에게 설치 요청 을 누르면 관리자에게 메일이 가요.
「서버 연결」 을 누르면 「앱이 아직 설정되지 않았어요」 가 떠요 그 채팅 앱이 아직 열리지 않은 상태예요. 문의해 주세요.
「연결 링크가 올바르지 않아요」 가 떠요
/connect 가 준 링크는 10분 동안만 써요. 채팅에서 /connect 를 다시 실행해 새 링크를 받으세요.
「이 채널에 연결」 버튼이 안 나와요
채널 연결은 그 팀의 소유자 · 관리자만, 서버 채널에서만 할 수 있어요. 멤버이거나 DM 이면 /connect 는 계정 연결만 해요. 팀은 커맨드를 칠 때 물어봐요.
/status 가 「팀 소유자 · 관리자에게 초대를 요청해 주세요」 라고 해요 이 채널이 연결된 팀의 멤버가 아니라서예요. 팀에 초대받거나, 커맨드의 팀 옵션으로 내가 속한 팀을 고르세요.
/status 가 엉뚱한 팀을 보여 줘요
볼 팀은 채널 → 카테고리 → 서버(설치한 팀) 순서로 정하고, 다 없으면 칠 때 물어봐요. /whoami 로 이 채널의 연결이 어디서 왔는지 보고, 필요하면 /connect 로 바꾸세요 → 디스코드 · 슬랙에서 ZeroCloud 쓰기
DM 에서 칠 때마다 팀을 물어봐요
DM 에는 연결된 채널이 없어서 그래요. 내가 속한 팀이 둘 이상이면 매번 고르고, 지난번에 고른 팀이 맨 위에 있어요. 묻지 않게 하려면 커맨드에 팀 옵션(슬랙은 team:<팀 이름>)을 붙이거나, 팀 채널에서 쓰세요.
「고르기 메뉴가 닫혔어요」 가 떠요 메뉴는 15분 동안만 받아요. 커맨드를 다시 쳐 주세요.