Appcircle MCP — Claude Code MCP server: setup guide
Connects Appcircle mobile CI/CD pipelines to AI assistants to inspect build profiles, signing certificates, and release health.
claude mcp add --transport http appcircle-mcp https://mcp.appcircle.ioWhat Appcircle MCP does
This server connects your development assistant to Appcircle mobile CI/CD workflows. It supplies tools for inspecting build profiles, signing configurations, test distribution, and pipeline run analytics.
You can connect directly to the hosted endpoint at https://mcp.appcircle.io or run it locally using Python or Docker. Setting APPCIRCLE_ACCESS_TOKEN is mandatory when running as a local subprocess over stdio.
To keep operations strictly read-only, set AC_MCP_ENABLE_WRITE_TOOLS=false in your environment. This prevents tools like trigger_build from registering. Specific modules can also be filtered out using APPCIRCLE_EXCLUDED_TOOLSETS.
What it helps with
- inspect mobile build profiles and pipeline run statuses
- audit signing identities and bundle configuration issues
- retrieve summaries of CI stability and failure rates
- review test build distribution across deployment channels
Example prompts for the agent
- Check the status of the latest iOS build on Appcircle
- Summarize recent pipeline failures and signing identity issues
- List test distribution profiles for our Android application
How to install Appcircle MCP
Platform CLI: remote server
claude mcp add --transport http appcircle-mcp https://mcp.appcircle.ioPlatform CLI: remote server
codex mcp add appcircle-mcp --url https://mcp.appcircle.ioConfig file
{
"mcpServers": {
"appcircle-mcp": {
"url": "https://mcp.appcircle.io"
}
}
}Config file
{
"servers": {
"appcircle-mcp": {
"type": "http",
"url": "https://mcp.appcircle.io"
}
}
}Platform CLI: remote server
gemini mcp add -t http appcircle-mcp https://mcp.appcircle.ioStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Appcircle MCP
How to install Appcircle MCP in Claude Code?
Run claude mcp add --transport http appcircle-mcp https://mcp.appcircle.io in your terminal. The client passes your Appcircle access token with each request.
What does Appcircle MCP do?
It allows AI clients to query Appcircle CI/CD data directly. Agents can track builds, review code signing setup, and inspect release reports without leaving the editor.
Can write operations like triggering builds be disabled?
Yes. Setting AC_MCP_ENABLE_WRITE_TOOLS=false prevents mutable actions like starting or canceling builds from being registered.
