Guide for Claude.ai (Web)

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

Use Bito's AI Architect with Claude.ai (Web) to enhance your AI-powered coding experience.

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

Prerequisites

1. 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 in your coding agent.

   • Note: The Bito MCP URL must be publicly accessible. Localhost or private network URLs (for example, http://localhost or internal IP addresses) are not supported and will not work.

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

   • Note: This file contains best practices, usage instructions, and prompting guidelines for the Bito AI Architect MCP server. The setup will work without this file, but including it helps AI tools interact more effectively with the Bito AI Architect MCP server.

3. A paid Claude.ai subscription - MCP integrations require one of the following:

   • Claude Pro

   • Claude Max

   • Claude Team

   • Claude Enterprise

Note: Free tier accounts do not have access to MCP Integrations.

OAuth authentication

Claude.ai uses OAuth 2.1 with PKCE for secure authentication, so you don't need to manually manage access tokens. Your email will be collected during the OAuth consent flow for tracking purposes.

How OAuth authentication works:

1. You add the MCP server URL in Claude.ai Integrations settings

2. Claude.ai initiates an OAuth flow

3. Your browser opens a consent page hosted by Bito

4. You enter your email and approve the connection

5. Claude.ai receives secure tokens automatically

6. Your email is tracked for usage analytics (collected during OAuth consent)

Benefits:

• No manual token management

• Secure browser-based authentication

• Automatic token refresh

• Email collected during consent (no separate header needed)

OAuth Callback URL: https://claude.ai/api/mcp/auth_callback

Set up AI Architect

1

Open Claude.ai integrations

1. Go to claude.ai and sign in with your paid account

2. Click on your profile icon (bottom-left corner)

3. Select Settings

4. Navigate to Integrations section

2

Add Bito AI Architect MCP server

1. Click "+ Add Custom Integration"

2. Enter the integration details:

   • Name: BitoAIArchitect

   • URL: <Your-Bito-MCP-URL>

• 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

1. Click "Connect" or "Add"

3

Complete OAuth authorization

1. A new browser window/tab will open showing the Bito Authorization page

2. Review the requested permissions

3. Enter your email address (required for tracking/identification)

4. Click "Authorize" or "Allow"

5. The window will close and you'll be returned to Claude.ai

4

Verify connection

1. Return to Claude.ai Settings → Integrations

2. BitoAIArchitect should show as "Connected" with a green indicator

3. Start a new conversation and try:

   What repositories are available in my organization?

Troubleshooting Claude.ai

"Integrations" option not visible:

• Verify you have a paid Claude subscription (Pro, Max, Team, or Enterprise)

• Free tier accounts do not have MCP access

• Contact Anthropic support if you have a paid plan but don't see the option

OAuth authorization fails:

• Ensure pop-ups are allowed for claude.ai

• Check that your Workspace ID is correct

• Verify your organization has OAuth enabled for the MCP server

• Try clearing browser cache and cookies, then retry

Connection shows "Disconnected":

• Click the server entry and select "Reconnect"

• OAuth tokens may have expired - re-authorize when prompted

• Check if your Bito workspace is still active

Tools not appearing in conversation:

• Ensure the MCP server shows "Connected" status

• Try starting a fresh conversation

• Some tools may require specific prompts to activate