Guide for Claude Code

Integrate Claude Code with AI Architect for more accurate, codebase-aware AI assistance.

Use Bito's AI Architect with Claude Code to enhance your AI-powered coding experience.

Once connected via MCP (Model Context Protocol), Claude Code can leverage AI Architect’s deep contextual understanding of your project, enabling more accurate code suggestions, explanations, and code insights.

Prerequisites

1. Contact Bito support team at [email protected] to have your repositories indexed. You will get an MCP server URL and Auth token from Bito.

2. Download BitoAIArchitectGuidelines.md file. You will need to copy/paste the content from this file later when configuring AI Architect.

Set up AI Architect

Follow the setup instructions for your operating system:

• Windows

• macOS

• Linux

Windows

1

Create configuration directory

1. Press Win + R

2. Type: %USERPROFILE%

3. Press Enter to open your home directory

2

Create .claude folder

1. In File Explorer, create new folder

2. Name it: .claude

3. You should now see the folder in %USERPROFILE%\.claude

3

Create MCP configuration file

1. Navigate into the .claude folder

2. Right-click in empty space → New > Text Document

3. Name it: mcp.json

4. Open with Notepad or VS Code

5. Paste the following:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save the file (Ctrl + S)

4

Create guidelines file

1. In the .claude folder, create new text document

2. Name it: mcp-usage.md

3. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

4. Save (Ctrl + S)

5

Restart Claude Code

Close and reopen Claude Code completely.

File locations:

• MCP config: C:\Users\[YourUsername]\.claude\mcp.json

• Guidelines: C:\Users\[YourUsername]\.claude\mcp-usage.md

macOS

1

Create configuration directory

1. Open Terminal (Cmd + Space, type Terminal)

2. Run:

mkdir -p ~/.claude

2

Create MCP configuration file

1. In Terminal, run:

nano ~/.claude/mcp.json

1. Paste the following:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save: Press Ctrl + O, then press Enter, then Ctrl + X

3

Create guidelines file

1. In Terminal, run:

nano ~/.claude/mcp-usage.md

1. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

2. Save: Ctrl + O, Enter, Ctrl + X

4

Verify files

ls -la ~/.claude/

You should see both mcp.json and mcp-usage.md

5

Restart Claude Code

Close and reopen Claude Code.

File locations:

• MCP Config: ~/.claude/mcp.json

• Guidelines: ~/.claude/mcp-usage.md

Linux

1

Create configuration directory

1. Open Terminal

2. Run:

mkdir -p ~/.claude

2

Create MCP configuration file

1. In Terminal, run:

nano ~/.claude/mcp.json

1. Paste:

{
  "mcpServers": {
    "Bito": {
      "transport": "http",
      "url": "Enter_MCP_Server_URL_Here", // e.g. "https://mcp.bito.ai/123456/mcp"
      "headers": {
        "Authorization": "Enter_Auth_Token_Here" // e.g. "Bearer xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      },
      "timeout": 60000,
      "disabled": false
    }
  }
}

Note:

• Replace the text Enter_MCP_Server_URL_Here with the actual MCP server URL.

• Replace the text Enter_Auth_Token_Here with the actual auth token.

1. Save: Ctrl + O, Enter, Ctrl + X

3

Create guidelines file

1. In Terminal, run:

nano ~/.claude/mcp-usage.md

1. Copy and paste ALL contents of BitoAIArchitectGuidelines.md into this file

2. Save: Ctrl + O, Enter, Ctrl + X

4

Verify files

ls -la ~/.claude/

You should see both mcp.json and mcp-usage.md

5

Restart Claude Code

Close and reopen Claude Code.

File locations:

• MCP Config: ~/.claude/mcp.json

• Guidelines: ~/.claude/mcp-usage.md