MCP 연결 안내

클라이언트를 연결하기 전에 제공 상태를 확인하세요.

호스팅형 연결

Cloud MCP는 https://mcp.altifigence.com/cloud-mcp에서 Streamable HTTP와 OAuth를 사용합니다. 클라이언트를 설정하기 전에 제공 상태와 클라이언트 검증 범위를 확인하세요.

  1. 클라이언트의 원격 MCP 연결 설정에 정확한 엔드포인트를 추가합니다.

  2. Account 로그인을 완료하고 동의 화면에서 조직과 요청된 Cloud 권한을 확인합니다. OAuth 자격 증명은 클라이언트가 관리합니다.

  3. 연결을 초기화하고 클라이언트의 도구 목록을 새로 고칩니다. 현재 허용된 Cloud 도구만 표시됩니다.

  4. 읽기 권한으로 먼저 계정 정보와 프로젝트 목록을 조회합니다. 반환된 프로젝트 ID를 프로젝트·파일 조회에 사용하세요. 파일 조회에는 준비된 작업공간이 필요합니다.

  5. 프로젝트·파일·설정·Git을 변경하려면 https://mcp.altifigence.com/cloud.write를 요청하고 새 동의를 완료합니다. 조직은 각 도구를 명시적으로 허용해야 합니다. 저장된 파일을 변경하기 전에 현재 프로젝트와 파일 revision을 읽고, 변경 응답이 불확실하면 상태를 확인한 뒤 재시도 여부를 판단하세요.

  6. 런타임 수명 주기, 터미널 작업이나 작업 실행에는 https://mcp.altifigence.com/cloud.execute 권한을 요청하고 새 동의를 완료합니다. 작업 실행이라면 먼저 저장된 프로젝트 RTL의 견적을 조회하세요. 반환된 offer와 사용 정책을 검토한 뒤 제출을 허용하고 도구 사용 절차를 따릅니다. 사용 가능 여부는 서비스 배포와 조직의 런타임·도구 정책에 따라 달라집니다.

  7. 개인 AI 연결에는 계정 보안의 AI 권한 중 필요한 것만 요청하고, 조직의 도구 허용과 새 동의를 완료하세요. 반환된 보안 설정 URL에서 사용자 본인이 Cloud에 공급자 키를 직접 입력하게 하세요. AI 응답을 요청하기 전에 공급자, 모델, 문맥과 발생 가능한 비용을 검토하세요.

이미 가진 권한 안의 새 도구라도 새 동의가 필요합니다. 이전 토큰을 갱신해도 새 도구가 추가되지 않습니다. 콘솔에서 프로젝트를 선택한 것만으로 권한이 부여되지는 않습니다. 허용한 조직을 바꾸려면 새 동의가 필요합니다. 조회 요청은 중지된 프로젝트를 시작하지 않습니다. 연결 설정에 계정 토큰, 브라우저 쿠키, AI 공급자 키를 넣지 마세요.

초기화나 권한 부여에 실패하면 문제 해결을 참고하세요. 사이트 루트나 다른 프로필에 프로토콜 요청을 보내는 방식으로 우회하지 마세요.

설치한 소프트웨어

로컬 MCP를 사용한다면 설치한 CLI 버전의 안내를 따라 주세요. 로컬 연결과 호스팅형 연결의 차이는 MCP 개요에서 확인할 수 있습니다.

첫 조회 확인

  1. 연결된 Altifigence 계정·조직을 읽도록 요청합니다.

  2. 접근 가능한 프로젝트를 나열하고 반환된 프로젝트 ID를 선택합니다.

  3. 선택한 프로젝트 상태를 읽습니다. 파일 조회가 불가능하면 Cloud에서 선택한 프로젝트·권한·저장 서비스 상태를 확인합니다. 일반 저장 파일 조회를 위해 개인 실행 환경을 시작하지는 않습니다.

  4. 파일 목록에 반환된 경로 하나를 선택합니다. 필요하면 다음 오프셋을 따라 전체 내용을 읽습니다.

  5. 프로젝트·경로·저장 버전을 포함한 요약을 요청하고 Cloud와 대조한 뒤 더 큰 작업에 사용합니다.

예시 요청: “내 Altifigence Cloud 프로젝트를 보여줘. 내가 고른 프로젝트의 README를 읽고 설정 절차를 요약한 뒤 사용한 저장 파일을 알려줘.” 게시된 읽기 범위 안에서 대상을 명확히 지정하는 요청입니다.