Quick MCP integration with AI coding agents

Connect Bito's AI Architect to your AI coding tools (Cursor, Claude Code, Windsurf, etc.) in seconds with our automated installer

Prerequisites

Before running the installer, have these ready:

1. Your Bito Workspace ID (or full Bito MCP URL for self-hosted instances)

2. Your Bito MCP Access Token

Note: For self-hosted instances, follow the AI Architect installation instructions. Upon successful setup, you will receive a Bito MCP URL and Bito MCP Access Token that you need to enter.

1. Your email ID (for tracking/identification)

2. At least one supported tool installed:

   • Claude Code

   • Cursor

   • Windsurf

   • VS Code (GitHub Copilot)

   • Junie

   • JetBrains AI Assistant

Note: For Claude.ai (Web) , Claude Desktop, and ChatGPT (Web & Desktop) you'll need to follow the manual setup process as they require OAuth authentication through your browser.

Installation guide

Our automated installer will prompt you for credentials and automatically configure all supported AI tools available on your system.

macOS / Linux

Open your terminal and run:

curl -fsSL https://mcp-setup.bito.ai/install.sh | bash

Windows

Open PowerShell (not Command Prompt) and run:

irm https://mcp-setup.bito.ai/install.ps1 | iex

Note: When using a self-hosted AI Architect, ensure that the MCP server is up and running before proceeding with the setup. The setup will fail if MCP is not running.

What happens next

1. The installer starts and checks for compatible tools

2. You'll be prompted to enter your credentials.

3. Automatic configuration - All detected tools are configured

4. Confirmation - You'll see which tools were successfully set up

After installation

1

Restart your AI tool

After the installer completes, completely close and reopen your IDE(s) to ensure the configuration takes effect.

2

Verify AI architect connection

Check that AI Architect appears in your tool's MCP server list:

• Claude Code: Run claude mcp list

• Cursor: Settings → MCP → Check server list

• Windsurf: Settings → Cascade → MCP Servers

• VS Code: Copilot Chat → Tools icon

• Junie: Settings → Tools → Junie → MCP Settings

• JetBrains AI Assistant: Settings → Tools → AI Assistant → Model Context Protocol

3

Add guidelines (optional but highly recommended)

To add Bito AI Architect guidelines to your project, run the following commands based on your coding agent:

Cursor:

cd /path/to/your/project
curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .cursorules

Windsurf:

cd /path/to/your/project
mkdir -p .windsurf/rules
curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .windsurf/rules/bitoai-architect.md

VS Code (GitHub Copilot):

cd /path/to/your/project
mkdir -p .github
curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .github/copilot-instructions.md

Junie:

cd /path/to/your/project
mkdir -p .junie
curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .junie/guidelines.md

JetBrains AI Assistant:

cd /path/to/your/project
mkdir -p .aiassistant/rules
curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .aiassistant/rules/bitoai-architect.md

4

Run a test query

Open a chat or conversation in your AI tool and try a test query to confirm AI Architect is working:

• "What repositories are available in my organization?"

• "Show me all Python repositories"

• "List the available tools"

If you receive accurate responses about your codebase, the setup is complete!

Uninstalling

To remove Bito AI Architect from all tools:

macOS / Linux

Open your terminal and run:

curl -fsSL https://mcp-setup.bito.ai/uninstall.sh | bash

Windows

Open PowerShell (not Command Prompt) and run:

irm https://mcp-setup.bito.ai/uninstall.ps1 | iex

Need manual setup?

If you prefer to configure tools individually or need to set up web-based tools (Claude.ai, ChatGPT), refer to our detailed integration guides:

• Claude Code

• Claude Desktop

• Claude.ai (Web)

• Cursor

• Windsurf

• GitHub Copilot (VS Code)

• Junie

• JetBrains AI Assistant

• ChatGPT (Web & Desktop)

Troubleshooting

Installer issues

"Command not found" or similar errors:

• Verify you're using the correct shell (bash for macOS/Linux, PowerShell for Windows)

• Check your internet connection

• Try running the command again

No tools detected:

• Ensure your AI tools are installed before running the installer

• The installer only configures tools it can detect on your system

• You can run the installer again after installing new tools

Connection issues

• Verify Bito MCP URL and Bito MCP Access Token are correct.

• Test endpoint with MCP protocol:

curl -s -X POST \
  -H "Authorization: Bearer <Your-Bito-MCP-Access-Token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}' \
  <Your-Bito-MCP-URL>

# Should return HTTP 200 with JSON response for valid credentials
# HTTP 401: Invalid Bito MCP Access Token
# HTTP 404: Invalid Bito MCP URL

Note:

• Replace <Your-Bito-MCP-URL> with the Bito MCP URL you received after completing the AI Architect setup.

  • For the Bito-hosted AI Architect, use the following URL format: https://mcp.bito.ai/<Your-Bito-Workspace-ID>/mcp

    Replace <Your-Bito-Workspace-ID> with your actual Bito workspace ID, which you can find after logging into your Bito account at alpha.bito.ai

• Replace <Your-Bito-MCP-Access-Token> with the Bito MCP Access Token you received after completing the AI Architect setup.

Server not appearing after install:

• Completely restart your AI tool (don't just reload)

• Verify your credentials were entered correctly

• Check that you have the minimum required versions (see below)

Minimum requirements

Some tools require specific versions:

• Node.js 20.18.1+ for Claude Desktop, VS Code, and JetBrains

• VS Code 1.99+ with Agent Mode enabled

• JetBrains 2025.1+ with AI Assistant plugin 251.26094.80.5+

Check Node.js version:

node --version

If you need to install or update Node.js, visit nodejs.org