Quick MCP integration with AI coding agents

Connect Bito's AI Architect to your AI coding tools (Cursor, Claude Code, Windsurf, etc.) in minutes 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

circle-info

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

    • Claude Desktop

    • Claude.ai (Web)

    • Cursor

    • Windsurf

    • GitHub Copilot (VS Code)

    • Junie

    • JetBrains AI Assistant

    • ChatGPT (Web & Desktop)

circle-info

Note: For web-based tools (Claude.ai and ChatGPT), 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:

Windows

Open PowerShell (not Command Prompt) and run:

circle-info

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

Test your connection

After the installer completes:

  1. Restart your AI tool (completely close and reopen)

  2. Open a chat or conversation

  3. Try a test query like:

    • "What repositories are available in my organization?"

    • "Show me all Python repositories"

Verify setup

Check that AI Architect is connected:

  • Claude Desktop: Click "+" β†’ Connectors β†’ look for BitoAIArchitect

  • Claude Code: Run claude mcp list to see BitoAIArchitect

  • Cursor: Settings β†’ MCP β†’ verify BitoAIArchitect appears

  • Windsurf: Settings β†’ Windsurf Settings β†’ Cascade β†’ MCP Servers β†’ Open MCP Marketplace β†’ look for BitoAIArchitect

  • VS Code: Copilot Chat β†’ gear icon β†’ MCP Servers β†’ look for BitoAIArchitect

Uninstalling

To remove Bito AI Architect from all tools:

macOS / Linux

Open your terminal and run:

Windows

Open PowerShell (not Command Prompt) and run:

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:

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:

circle-info

Note:

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

  • 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:

If you need to install or update Node.js, visit nodejs.orgarrow-up-right

Last updated