MCP: AI 어시스턴트 연결
MCP를 통해 AI는 Fox Store에 설정된 연결로 앱을 조회하고 스토어 콘텐츠를 관리하며 구현된 업로드 및 출시 작업을 실행합니다. MCP는 Engine의 업무 기능을 호출하고 CLI는 CI/CD 출시 자동화에 사용합니다. 엔진은 공유하지만 도구 범위는 다릅니다.
활성화 및 준비
- 최신 버전을 설치하고 라이선스를 활성화한 뒤 Provider 연결을 추가합니다.
- 설정 → MCP에서 MCP를 켭니다. 스위치는 즉시 저장되어 재시작 후에도 유지됩니다. 권한과 시간 제한 변경은 저장 버튼을 눌러야 합니다.
- 권한 관리에서 연결 범위, 실행 권한, 도구를 확인합니다.
- 연결 방식에서 클라이언트 설정을 복사해 AI 클라이언트에 추가하고 MCP를 다시 연결합니다.
설치 파일에 네이티브 실행 파일이 포함되어 Node.js나 별도 MCP 플러그인이 필요 없습니다. 클라이언트가 로컬 stdio로 독립 프로세스를 시작합니다. 초기화 후 데스크톱을 계속 열어 둘 필요는 없습니다. 라이선스 임대가 만료되면 데스크톱에서 갱신합니다.
AI 클라이언트 설정
Codex에는 생성된 TOML을 사용합니다. Claude Code 같은 로컬 클라이언트는 생성된 JSON을 참고하되 해당 클라이언트 형식을 따릅니다. 다른 컴퓨터 경로 대신 설정에 표시된 실행 파일 절대 경로, 인수, 데이터 디렉터리를 사용하세요.
입력 폼에서는 명령을 따로 입력하고 --data-dir와 디렉터리 경로를 각각 별도 인수로 추가합니다. 따옴표, 쉼표, 전체 배열을 한 인수에 넣지 마세요. Linux AppImage에는 --mcp도 포함될 수 있으므로 생성된 설정을 모두 유지합니다. 클라이언트 설정에 Provider 비밀 정보를 입력할 필요는 없습니다.
호환성은 클라이언트의 로컬 stdio MCP 지원 여부에 달려 있습니다. GLM, DeepSeek, Gemini 모델은 호환 클라이언트가 필요합니다. 원격 URL만 받는 웹·클라우드 제품은 로컬 프로그램을 직접 실행할 수 없습니다. 현재 HTTP 서비스 주소는 제공하지 않습니다.
권한 및 도구 범위
| 권한 | 허용 작업 |
|---|---|
| 읽기 전용(기본값) | 연결, 앱, 버전, 상태 조회. 플랫폼 데이터를 변경하지 않습니다. |
| 콘텐츠 관리 | 읽기 및 문구·자료 수정. 심사 제출, 출시, 삭제, 계정 권한 변경은 제외합니다. |
| 출시 관리 | 콘텐츠 관리 및 지원 도구의 심사 제출, 출시, 삭제, 가격, 배포, 계정 권한 변경을 포함합니다. |
기본적으로 향후 추가될 연결까지 모두 허용합니다. 특정 연결로 제한하거나 연결별 기본 권한을 재정의할 수 있습니다. 도구는 기본 선택되며 수동 해제는 유지됩니다. 그룹 숫자는 활성 도구 / 전체 도구 수이며 플랫폼 메뉴 수가 아닙니다. 그룹을 펼치면 도구와 필요 권한을 볼 수 있습니다.
연결 범위, 도구 스위치, 실행 권한, 플랫폼 계정 권한이 함께 적용됩니다. 도구 선택만으로 쓰기 권한을 얻지는 않습니다. 높은 권한도 미구현 기능을 추가하지 않습니다. 호출별 데스크톱 승인은 없으며 AI 클라이언트가 별도 확인을 요청할 수 있습니다. 결과가 클라이언트의 모델 서비스로 전송될 수 있습니다.
요청 예시
- “이 App Store 연결의 앱, 최신 버전, 중국어 소개를 나열하고 누락 정보는 표시해 줘.”
- “이 Google Play 앱의 테스트 Track과 출시 상태를 확인해 줘.”
- “지정 앱의 중국어 스토어 소개를 이 문구로 바꿔 줘.”
- “이 로컬 패키지를 사전 검사한 후 지정 연결의 테스트 채널에 업로드해 줘.”
연결, 앱, 언어, 채널을 지정합니다. 계정에 보이는 데이터만 조회하며 미지원 기능이나 권한 부족은 오류로 반환합니다. 업로드 성공은 심사 통과나 출시 완료를 의미하지 않습니다. 파이프라인은 CLI / API를 참고하세요.
이미지와 로컬 파일
생성 이미지를 MCP 실행 컴퓨터에 저장하고 절대 경로와 대상 앱을 전달합니다. 클라우드 채팅 이미지나 샌드박스 경로는 로컬에서 읽지 못할 수 있습니다. 파일 없음, 접근 권한, 형식 오류는 안내에 따라 수정하세요.
작업은 플랫폼과 도구에 따라 다릅니다. 스토어 이미지와 패키지 내부 아이콘은 별개입니다. Apple 기본 앱 아이콘은 새 빌드와 함께 업로드해야 하며 이미지 하나로 출시된 앱 아이콘을 직접 교체할 수 없습니다.
연결 및 호출 오류 해결
- 도구가 없거나 이전 도구만 표시: 스위치, 선택, 저장 상태를 확인하고 다시 연결합니다. 업데이트 후 이전 MCP 프로세스를 종료하고 재연결합니다.
- 실행 불가: 실행 파일, 인수 분리, 이전 설치 경로를 확인하고 설정을 다시 복사합니다. ‘프로그램 준비 완료’는 파일 존재를 의미하며 클라이언트 연결 완료가 아닙니다.
- MCP_POLICY_INVALID: Fox Store를 업데이트하고 설정에서 정책을 다시 불러와 저장한 뒤 재연결합니다. 계속되면 오류를 보관하고 자격 증명 데이터베이스를 삭제하지 마세요.
- 연결 또는 자격 증명 사용 불가: 데이터 디렉터리와 연결을 확인하고 데스크톱에서 연결 및 시스템 자격 증명 저장소 접근을 확인합니다. 서로 다른 OS 사용자는 자격 증명을 직접 공유할 수 없습니다.
- 라이선스·권한·시간 제한 오류: 라이선스를 갱신하고 필요 권한과 플랫폼 권한을 확인합니다. 긴 작업은 클라이언트 시간 제한도 조정합니다. 쓰기 결과를 알 수 없으면 재시도 전에 플랫폼 상태를 확인하세요.
최근 호출에서 도구, 결과, 소요 시간을 확인할 수 있습니다. Provider 연결 및 문제 해결을 참고하세요.