# How to connect the Bitrise MCP server

To connect the official Bitrise MCP server, add https://mcp.bitrise.io/ to your MCP client as a Streamable HTTP server, then sign in with OAuth when your client prompts you. If your client can't use OAuth, use a personal access token. Bitrise documents setup for Claude Code, Claude, Cursor, VS Code and Windsurf.

- Endpoint: https://mcp.bitrise.io/
- Transport: Streamable HTTP
- Registry: io.github.bitrise-io/bitrise-mcp 2.5.0
- Publisher documentation reviewed: 2026-11-05 (not a tested connection)
- Guide page: https://apitracker.io/mcp-guides/bitrise-mcp

## Before you start

- A Bitrise account. You can sign in or create one on the Bitrise sign-in page that opens during the OAuth flow; a Workspace is created for new accounts.

## Steps

1. **Open Bitrise's MCP setup instructions** <https://docs.bitrise.io/en/bitrise-platform/ai/onboarding-for-agents>
2. **Add the Bitrise MCP server to your client** Add https://mcp.bitrise.io as a remote MCP server that uses the Streamable HTTP transport (often labelled "http"), with no token. Reload the client so the change takes effect. Bitrise also ships a Cursor Marketplace plugin.
3. **Sign in to Bitrise and approve the consent screen**
4. **Optional: limit the enabled API groups**
5. **If your client can't use OAuth, use a personal access token** Create a personal access token under Account settings, Security, and send it in the Authorization header as a bearer token. Use this for CI, scripts, or clients without MCP OAuth support. Keep the token in a secret store, not in shared configuration.
6. **Only for the token alternative: Authorization**
7. **List the server's tools**

## Questions

### What is the Bitrise MCP server URL?

The official Bitrise MCP server is at https://mcp.bitrise.io/ and uses the Streamable HTTP transport.

### How do I authenticate with the Bitrise MCP server?

Sign in with OAuth when your client prompts you. If your client can't use OAuth, use a personal access token: Create a personal access token under Account settings, Security, and send it in the Authorization header as a bearer token. Use this for CI, scripts, or clients without MCP OAuth support. Keep the token in a secret store, not in shared configuration.

### Which AI clients can use the Bitrise MCP server?

Bitrise's documentation covers Claude Code, Claude, Cursor, VS Code and Windsurf. Other clients that support remote Streamable HTTP MCP servers may also work.

### What do I need before connecting Bitrise MCP?

A Bitrise account. You can sign in or create one on the Bitrise sign-in page that opens during the OAuth flow; a Workspace is created for new accounts.

### Has this Bitrise MCP guide been tested?

Bitrise's documentation was reviewed on 2026-11-05. It is not a tested connection; your account and permissions decide which tools work.

## Sources

- https://docs.bitrise.io/en/bitrise-platform/ai/bitrise-mcp (checked 2026-11-05)
- https://docs.bitrise.io/en/bitrise-platform/ai/onboarding-for-agents (checked 2026-11-05)
- https://docs.bitrise.io/en/bitrise-platform/ai/bitrise-mcp/installing-the-bitrise-mcp-server/install-claude (checked 2026-11-05)
- https://docs.bitrise.io/en/bitrise-platform/ai/bitrise-mcp/installing-the-bitrise-mcp-server/install-cursor (checked 2026-11-05)
- https://registry.modelcontextprotocol.io/v0.1/servers/io.github.bitrise-io%2Fbitrise-mcp/versions/2.5.0 (checked 2026-11-05)
- https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization (checked 2026-11-05)

Guide JSON: https://github.com/apideck-libraries/mcp-connect/blob/626f6a146170ded34891b30dca3af26f09e07466/proposals/connection-guide/0.1/reviewed/guides/bitrise-mcp.json