Claude Code와 Cloud MCP

클라이언트 설정·Cloud 승인·저장 파일 읽기 성공을 구별합니다.

Cloud MCP의 원격 HTTP 주소는 https://mcp.altifigence.com/cloud-mcp입니다. 서버 설정·계정 승인·도구 읽기 성공은 각각 별도 확인입니다. 제공 여부는 클라이언트와 Cloud 조직의 도구 정책에 따라 달라집니다.

클라이언트와 주소 확인

설치된 Claude Code CLI가 원격 HTTP MCP 서버를 지원하는 경우 설정 명령은 아래 형태입니다. 사용하기 전에 설치된 CLI의 도움말과 설정 범위를 확인합니다.

claude mcp add --transport http altifigence https://mcp.altifigence.com/cloud-mcp

설정된 서버가 Claude Code의 /mcp에 제공되는 경우 클라이언트에서 계정 승인이 제공될 수 있습니다. 계정·조직·요청 권한은 그 승인에 속합니다. DDS 설정 화면만으로 이 클라이언트의 승인 완료를 확인할 수 없습니다. 콜백만으로 Cloud 도구 접근 성공을 확인할 수도 없습니다.

DDS에서 연결 제공 상태 확인

  1. QUOTA로 DDS 설정을 열고 Developer access를 선택합니다.

  2. Overview에서 선택된 프로젝트와 계정 로그인·조직 동의·권한 요건을 읽습니다.

  3. Open setup을 선택해 Developer tools를 엽니다. 제공되는 설정 안내와 Documentation 링크를 읽습니다.

  4. Details를 펼쳐 MCP endpoint·Transport·Authentication·권한 이름을 읽습니다. 표시된 전송 방식은 Streamable HTTP입니다.

Details 표는 도구 이름과 권한 분류의 참조입니다. 실제 접근은 연결에서 검색된 도구와 현재 승인의 범위에 따르며 참조 표만으로 도구가 활성화되지는 않습니다.

Context, search & connections는 컨텍스트·Web search·AI 연결을 위한 별도 설정 페이지입니다. 이 조작은 Cloud MCP 동의 화면이 아닙니다. 해당 호스트의 Developer tools는 외부 승인 세션 없이 설정 정보만 제공할 수도 있습니다.

연결에서 읽기 도구를 제공하는 경우

연결된 Cloud 계정은 cloud.read로 계정 식별 정보·접근 가능한 프로젝트·저장 파일 읽기를 제공할 수 있습니다. 해당 연결이 반환한 프로젝트의 민감하지 않은 작은 파일을 성공적으로 읽어야 서버 설정보다 더 많은 동작을 확인할 수 있습니다. 프로젝트·파일 식별 정보, 페이지·청크 완료와 버전이 읽은 범위를 정합니다. 거절된 도구는 현재 조직 정책과 동의가 충족되지 않으면 제공되지 않습니다.

직원용 DX 연결 구별

직원용 DX 주소는 /dx-mcp로 끝납니다. 조직 플러그인과 직원 기기 로그인은 고객 Cloud 접근을 설정하지 않습니다. DX 기기 코드를 Cloud 승인의 대체 절차로 쓰거나 직원 권한과 cloud.* 권한을 섞을 수 없습니다.

연결이 실패할 때

클라이언트가 명령 옵션을 거절하면 설치된 도움말을 확인합니다. 콜백 거절·도구 누락·읽기 거절은 DDS 작업 공간 미제공과 원인이 다릅니다. 민감 정보를 뺀 오류를 보존하고 MCP 문제 해결 안내를 확인합니다. 토큰·브라우저 쿠키·승인 코드를 공유 프로젝트 설정에 넣지 않습니다.

관련 문서

Connection guide · Authentication · Tool reference · Troubleshooting