Skip to main content
Glama
deenesjakoruzh
thatfactory

xcode-cloud-mcp

by thatfactory
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

xcode-cloud-mcp

App Store Connect API를 통해 Xcode Cloud 제품을 검색하고, 워크플로를 조회·수정하며, 빌드 이슈, 로그, 테스트 요약, UI 테스트 아티팩트를 모니터링하고 검색하는 최소한의 MCP 서버입니다.

기능

기능

도구

예시 사용

예시 반환

제품 검색

list_products

"Xcode Cloud 제품을 이 계정에서 보여줘."

productType: APP, createdDate: 2026-03-15T10:00:00Z

워크플로 검색

list_workflows

"제품 def456의 워크플로를 나열해 줘."

Feature Branch, containerFilePath: Chauffeur.xcodeproj

워크플로 구성 조회

get_workflow_details

"abc123 워크플로의 환경 및 액션을 포함한 전체 구성을 보여줘."

actions, startConditions, environment 등 전체 구성 정보

실행 중/최근 빌드 모니터링

list_build_runs

"실행 중인 빌드를 모니터링할 수 있게 abc123 워크플로의 빌드를 보여줘."

number: 93, completionStatus: null, startedDate: ...

워크플로 활성화/비활성화

set_workflow_enabled

"새 설정을 테스트하는 동안 abc123 워크플로를 비활성화해."

workflow.general.isEnabled: false

이름, 설명, clean 모드 업데이트

update_workflow_general

"abc123 워크플로의 이름을 Feature Branch v2로 바꾸고 설명도 수정해."

changedFields: [name, description], 업데이트된 workflow.general

시작 조건 명시적 업데이트

update_workflow_start_conditions

"abc123 워크플로의 풀 리퀘스트 빌드가 더 이상 자동 취소되지 않게 변경해."

workflow.startConditions.pullRequest.autoCancel: false

워크플로 액션 목록 교체

update_workflow_actions

"abc123 워크플로에서 archive 액션을 제거하고, 테스트 후 다시 추가해."

액션 제거 후 actionCount: 4, 복원 후 actionCount: 5

빌드 상태 빠르게 확인

get_build_issues

"abc123 워크플로의 최신 실패 빌드에서 무엇이 잘못됐는지 알려줘."

issueCounts: { errors: 1, testFailures: 3, warnings: 2 }

컴팩트한 빌드 로그 조회

get_build_logs

"빌드 81의 로그를 가져와서 실패 원인을 요약해 줘."

failedTests, failureSummary, logSnippet

로컬 grep을 위한 로그 저장

materialize_build_logs

"빌드 81의 로그를 로컬에 저장해서 직접 grep할 수 있게 해줘."

logDirectory: /var/folders/.../build-81, logFiles: [...]

테스트 결과 요약

get_test_results

"abc123 워크플로의 최신 빌드 테스트 결과를 요약해 줘."

totalTests, passedTests, failedTests, failureSummary

실패한 테스트 조회

get_failed_tests

"빌드 81에서 실패한 테스트는 무엇인가요?"

failedTests: [...], failureMessages: [...]

UI 테스트 아티팩트 검색

get_test_artifacts

"최신 UI 테스트 런의 스크린샷과 비디오를 보여줘."

screenshots: [...], videos: [...], resultBundles: [...]

임시 파일 정리

cleanup_saved_logs

"저장된 로그를 모두 정리해."

removedLogs: [...], freedSpaceBytes: 1048576

빌드 조회는 buildRunId 또는 워크플로 ID와 빌드 번호 조합으로 지정할 수 있습니다.

Related MCP server: appstore-release-mcp

요구 사항

  • Node.js 18 이상

  • Xcode Cloud에 접근할 수 있는 App Store Connect API 키

  • 유효한 issuer ID와 key ID

Claude 설정

claude mcp add xcode-cloud \
  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
  -- npx -y @thatfactory/xcode-cloud-mcp

Codex 설정

codex mcp add xcode-cloud \
  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
  -- npx -y @thatfactory/xcode-cloud-mcp

사용 가능한 도구

  • list_products()

  • list_workflows(productId)

  • get_workflow_details(workflowId)

  • list_build_runs(workflowId, limit?, status?)

  • set_workflow_enabled(workflowId, enabled)

  • update_workflow_general(workflowId, name?, description?, clean?)

  • update_workflow_start_conditions(workflowId, branchStartCondition?, manualBranchStartCondition?, pullRequestStartCondition?, manualPullRequestStartCondition?, scheduledStartCondition?, tagStartCondition?, manualTagStartCondition?)

  • update_workflow_actions(workflowId, actions)

  • get_build_issues(buildRunId?)

  • get_build_logs(buildRunId, maxCharacters?)

  • materialize_build_logs(buildRunId)

  • get_test_summaries(buildRunId)

  • get_failed_tests(buildRunId)

  • get_ui_test_artifacts(buildRunId)

  • cleanup_saved_logs(buildRunId?, retentionHours?)

요구 사항

  • Node.js 18 이상

  • App Store Connect API 키 (issuer ID, key ID, .p8 파일)

  • 유효한 Xcode Cloud 워크플로

claude mcp add xcode-cloud \
  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
  -- npx -y @thatfactory/xcode-cloud-mcp

Claude 설정

codex mcp add xcode-cloud \
  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
  -- npx -y @thatfactory/xcode-cloud-mcp

사용 가능한 도구

  • list_products

  • list_workflows(productId)

  • get_workflow_details(workflowId)

  • list_build_runs(workflowId, limit?, status?)

  • get_build_issues(buildRunId)

  • get_build_logs(buildRunId, maxCharacters?)

  • get_test_summaries(buildRunId)

  • get_failed_tests(buildRunId)

  • get_ui_test_artifacts(buildRunId)

  • set_workflow_enabled(workflowId, enabled)

  • update_workflow_general(workflowId, name?, description?, clean?)

  • update_workflow_start_conditions(workflowId, startConditions)

  • update_workflow_actions(workflowId, actions)

/tmp/xcode-cloud-mcp/build-logs/<buildRunId>
Retrieve logs of the latest failing build for workflow abc123.
Retrieve logs of build 81, then inspect the returned savedLogsDirectory and grep for Expectation failed.
Get the failed tests for build 81, then open the saved logs directory and inspect the failing test in context.
Retrieve logs of build number 42 for workflow abc123.
Show me the latest failing UI test artifacts for workflow abc123.
List the workflows for product def456 and then summarize the latest build.
Show me the full workflow details for workflow abc123, including environment, start conditions, actions, and whether it is enabled.

GXP11GXP1

codex mcp add xcode-cloud \
  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
  -- npx -y @thatfactory/xcode-cloud-mcp
/tmp/xcode-cloud-mcp/build-logs/<buildRunId>
Retrieve logs of the latest failing build for workflow abc123.
Retrieve logs of build 81, then inspect the returned savedLogsDirectory and grep for Expectation failed.
Get the failed tests for build 81, then open the saved logs directory and inspect the failing test in context.
Retrieve logs of build number 42 for workflow abc123.
Show me the latest failing UI test artifacts for workflow abc123.
List the workflows for product def456 and then summarize the latest build.
Show me the full workflow details for workflow abc123, including environment, start conditions, actions, and whether it is enabled.
Disable workflow abc123, remove the archive action, then restore the original action list after the experiment.
npm install
npm test
npm run build
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
B
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1wRelease cycle
10Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Appcircle MCP

    MCP server for Appcircle mobile CI/CD platform.

  • Supabase

    MCP server for interacting with the Supabase platform

  • server

    An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thatfactory/xcode-cloud-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server