MCP server for AI agents

The Bitrise Dev Environments MCP server lets any AI assistant that supports the Model Context Protocol — such as Claude Code, Claude Desktop, Cursor, or VS Code — create and drive Remote Dev Environment sessions for you. The server is open source.

Connection options

There are two ways to connect to the MCP server:

• Hosted: connect your assistant to https://mcp-rde.bitrise.io and sign in with your browser the first time. There's nothing to install, and it's the recommended option.
• Local: run the server as a binary on your machine using a personal access token. This exposes the full tool set, including uploading and downloading files between the session and your computer.

Adding the server to your AI assistant

Set up the hosted server in the client you use:

Claude Code

claude mcp add --transport http bitrise-dev-environments https://mcp-rde.bitrise.io

Run /mcp and authenticate in your browser.

Cursor

Add the server to your mcp.json:

{
  "mcpServers": {
    "bitrise-dev-environments": {
      "url": "https://mcp-rde.bitrise.io"
    }
  }
}

VS Code

Add the server to your MCP configuration:

{
  "servers": {
    "bitrise-dev-environments": {
      "type": "http",
      "url": "https://mcp-rde.bitrise.io"
    }
  }
}

Assistant capabilities

Once connected, you can ask your assistant in plain language to:

• Create, list, restore, terminate, and delete sessions.
• Run shell commands in a session over SSH.
• Take screenshots of, and control, the macOS desktop.
• Open SSH or VNC remote access.
• Upload and download files (local server only).

For example: "Spin up a macOS Xcode session, clone my repo, and run the unit tests."

Authentication

• The hosted server uses browser-based sign-in, so there's no token to manage.
• The local server authenticates with a Bitrise personal access token set as the BITRISE_TOKEN environment variable. If you belong to more than one workspace, set BITRISE_WORKSPACE_ID.

Learn more

For the local setup, the full list of tools, and per-client install guides, see the open-source repository: bitrise-io/bitrise-mcp-dev-environments.