Skip to main content

Install Bitrise MCP Server in Cursor

PrerequisitesClick to copy link​

  1. Cursor IDE installed (latest version, with MCP OAuth support — Cursor v0.48.0+ for Streamable HTTP, recent builds for OAuth)
  2. A Bitrise account
  3. For local setup: Go (>=1.25) installed and a Bitrise PAT

Recent Cursor versions support MCP OAuth — on first tool use Cursor opens your browser to sign in to Bitrise; no token to paste.

Install stepsClick to copy link​

  1. Open your global MCP configuration file at ~/.cursor/mcp.json (or use a project-local .cursor/mcp.json) and add the configuration below
  2. Save the file
  3. Restart Cursor
  4. On first tool invocation, complete the browser-based sign-in flow

Streamable HTTP ConfigurationClick to copy link​

{
  "mcpServers": {
    "bitrise": {
      "url": "https://mcp.bitrise.io"
    }
  }
}

Fallback: PAT-based authenticationClick to copy link​

If your Cursor version doesn't yet support MCP OAuth, you can use a Personal Access Token. Create one under Account Settings → Security, then:

{
  "mcpServers": {
    "bitrise": {
      "url": "https://mcp.bitrise.io",
      "headers": {
        "Authorization": "Bearer YOUR_BITRISE_PAT"
      }
    }
  }
}

Local Server SetupClick to copy link​

The local Bitrise MCP server runs via Go and uses a Personal Access Token (stdio mode, no OAuth).

Install MCP Server

Install stepsClick to copy link​

  1. Click the install button above and follow the flow, or open ~/.cursor/mcp.json and add the configuration below
  2. In Tools & Integrations > MCP tools, click the pencil icon next to "bitrise"
  3. Replace YOUR_BITRISE_PAT with your actual Personal Access Token
  4. Save the file
  5. Restart Cursor

Local ConfigurationClick to copy link​

{
  "mcpServers": {
    "bitrise": {
      "command": "go",
      "args": [
        "run",
        "github.com/bitrise-io/bitrise-mcp/v2@v2"
      ],
      "env": {
        "BITRISE_TOKEN": "YOUR_BITRISE_PAT"
      }
    }
  }
}

Configuration FilesClick to copy link​

  • Global (all projects): ~/.cursor/mcp.json
  • Project-specific: .cursor/mcp.json in project root

Verify InstallationClick to copy link​

  1. Restart Cursor completely
  2. Check for green dot in Settings → Tools & Integrations → MCP Tools
  3. In chat/composer, check "Available Tools"
  4. Test with: "List my Bitrise apps" (the first tool call will trigger the OAuth flow if you're not already signed in)

Advanced configurationClick to copy link​

See Tools for enabling/disabling specific API groups.

TroubleshootingClick to copy link​

Remote Server IssuesClick to copy link​

  • OAuth flow doesn't open browser: Update Cursor to a recent build. Older builds with Streamable HTTP but without OAuth support can use the PAT-based fallback above.
  • Streamable HTTP not working: Ensure you're using Cursor v0.48.0 or later
  • Connection errors: Check firewall/proxy settings

General IssuesClick to copy link​

  • MCP not loading: Restart Cursor completely after configuration
  • Invalid JSON: Validate that json format is correct
  • Tools not appearing: Check server shows green dot in MCP settings
  • Check logs: Look for MCP-related errors in Cursor logs

Important NotesClick to copy link​

  • Cursor specifics: Supports both project and global configurations, uses mcpServers key