# Integrating with coding agents ## 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 {% hint style="info" %} Note: For self-hosted instances, follow the [**AI Architect installation instructions**](https://docs.bito.ai/ai-architect/installation/install-ai-architect-self-hosted). Upon successful setup, you will receive a **Bito MCP URL** and **Bito MCP Access Token** that you need to enter. {% endhint %} 3. Your email ID (for tracking/identification) 4. At least one supported tool installed: * Claude Code * Cursor * Windsurf * VS Code (GitHub Copilot) * Junie * JetBrains AI Assistant {% hint style="info" %} **Note:** For [Claude.ai (Web)](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-claude.ai-web) , [Claude Desktop](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-claude-desktop), and [ChatGPT (Web & Desktop)](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-chatgpt-web-and-desktop) you'll need to follow the manual setup process as they require OAuth authentication through your browser. {% endhint %} ## 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: ```bash curl -fsSL https://mcp-setup.bito.ai/install.sh | bash ``` #### Windows Open **PowerShell** (not Command Prompt) and run: ```powershell irm https://mcp-setup.bito.ai/install.ps1 | iex ``` {% hint style="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. {% endhint %} #### 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 {% stepper %} {% step %} ### Restart your AI tool After the installer completes, **completely close and reopen your IDE(s)** to ensure the configuration takes effect. {% endstep %} {% step %} ### 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 {% endstep %} {% step %} ### Add guidelines (optional but highly recommended) The [**BitoAIArchitectGuidelines.md** file](https://github.com/gitbito/ai-architect/blob/main/BitoAIArchitectGuidelines.md) contains best practices, usage instructions, and prompting guidelines for the Bito's AI Architect MCP server. Adding it to your project helps your AI coding agent interact with Bito's AI Architect more effectively and get better results out of every query. **If you are on Claude Code or Windsurf**, the installer automatically adds the guidelines file globally, covering all your projects. If you'd also like to apply guidelines at the project level for a specific project, run the relevant command below inside that project directory. **If you are on Cursor, VS Code (GitHub Copilot), Junie, or JetBrains AI Assistant**, guidelines are not configured automatically by the installer. Run the relevant command below manually inside each project directory where you want the guidelines to apply. This is a per-project step, so repeat it whenever you start working in a new project. To add Bito's AI Architect guidelines to your project, run the following commands based on your coding agent: **Claude Code:** ```shellscript cd /path/to/your/project curl -sSL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o CLAUDE.md ``` **Cursor:** ```shellscript cd /path/to/your/project curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .cursorrules ``` **Windsurf:** ```shellscript 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):** ```shellscript cd /path/to/your/project mkdir -p .github curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .github/copilot-instructions.md ``` **Junie:** ```shellscript cd /path/to/your/project mkdir -p .junie curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .junie/guidelines.md ``` **JetBrains AI Assistant:** ```shellscript cd /path/to/your/project mkdir -p .aiassistant/rules curl -sfL "https://mcp-setup.bito.ai/BitoAIArchitectGuidelines.md" -o .aiassistant/rules/bitoai-architect.md ``` {% endstep %} {% step %} ### 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"` * `"What are the dependencies of [repo-name]?"` * `"Find all microservices using Redis"` * `"Show me repository clusters in our organization"` * `"Plan a new feature for [component]"` * *(uses **bito-feature-plan** skill)* * `"Write a PRD for [feature]"` * *(uses **bito-prd** skill)* * `"Help me triage this production issue"` * *(uses **bito-production-triage** skill)* If you receive accurate responses about your codebase, the setup is complete! {% hint style="info" %} Learn more about [available Agent skills](https://docs.bito.ai/ai-architect/agent-skills). {% endhint %} {% endstep %} {% endstepper %} ## Uninstalling To remove Bito AI Architect from all tools: #### macOS / Linux Open your terminal and run: ```bash curl -fsSL https://mcp-setup.bito.ai/uninstall.sh | bash ``` #### Windows Open **PowerShell** (not Command Prompt) and run: ```powershell 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](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-claude-code) * [Claude Desktop](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-claude-desktop) * [Claude.ai (Web)](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-claude.ai-web) * [Cursor](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-cursor) * [Windsurf](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-windsurf) * [GitHub Copilot (VS Code)](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-github-copilot-vs-code) * [Junie](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-junie-jetbrains) * [JetBrains AI Assistant](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/manual-mcp-integration-with-ai-coding-agents/guide-for-jetbrains-ai-assistant) * [ChatGPT (Web & Desktop)](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-chat-agents/guide-for-chatgpt-web-and-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: ```bash curl -s -X POST \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}' \ # Should return HTTP 200 with JSON response for valid credentials # HTTP 401: Invalid Bito MCP Access Token # HTTP 404: Invalid Bito MCP URL ``` {% hint style="info" %} **Note:** * Replace `` 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//mcp` Replace `` with your actual Bito workspace ID, which you can find after logging into your Bito account at [**alpha.bito.ai**](https://alpha.bito.ai/) * Replace `` with the **Bito MCP Access Token** you received after completing the AI Architect setup. {% endhint %} **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:** ```bash node --version ``` If you need to install or update Node.js, visit [nodejs.org](https://nodejs.org/) #### Skills not appearing If skills are not visible in your IDE after installation: 1. Verify files exist: `ls ~/.claude/skills/bito-*/SKILL.md` (Claude) or `ls ~/.cursor/rules/bito-*.mdc` (Cursor) 2. Restart your IDE completely 3. Check that `jq` is installed (required for manifest parsing): `jq --version` 4. Re-run the install script — skills installation is idempotent #### Hooks not working If hooks are not triggering: 1. Verify your IDE version supports hooks (Cursor hooks are in beta, VS Code hooks are preview) 2. Check that the hook configuration wasn't overwritten by another tool 3. Re-run the install script to restore hook configuration