Model Context Protocol (Beta)

Integrating Baz with Your IDE via MCP

Baz offers code review according to your organization's configurations via the Model Context Protocol (MCP)—the open protocol that lets AI-native IDEs and CLIs like Cursor, Claude Code / Desktop and VS Code communicate with external AI servers.

By connecting to Baz’s MCP server, you can access high-signal, context-aware code reviews directly inside your editor. This guide explains how to configure Baz as an MCP server, how it works, and what you can expect from the integration.

---

What Is the Model Context Protocol?

MCP is a protocol for connecting LLMs to tools, which allows the LLM greater functionality and accuracy. Baz MCP enables:

• AI code review directly in your IDE

• Rich feedback based on file usage, history, and repo structure

• Secure, on-demand analysis of your codebase

• Review that is based on your organization's presets and configurations

You are in full control of when and how Baz connects—nothing is behind the scenes. You configure your tools explicitly using the instructions below.

---

Connecting Baz as a Remote MCP Server

Baz exposes an MCP server that you can connect to from any MCP-enabled IDE / app / CLI. Once connected, Baz will analyze your codebase and provide context-aware reviews directly in your editor.

Server URL

https://baz.co/mcp

IDE Configuration Examples

Claude Desktop

{
  "mcpServers": {
    "baz": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://baz.co/mcp"
      ]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git"]
    }
  }
}

Claude Code

claude mcp add baz npx -- -y mcp-remote https://baz.co/mcp

Cursor

{
  "mcpServers": {
    "baz": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://baz.co/mcp"
      ]
    }
  }
}

VS Code

{
  "mcp": {
    "servers": {
      "baz": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://baz.co/mcp"
        ]
      }
    }
  }
}

Baz on VSCODE

Windsurf

{
  "mcpServers": {
    "baz": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://baz.co/mcp"
      ]
    }
  }
}

Baz on Windsurf

Troubleshooting

Clear your ~/.mcp-auth directory

mcp-remote stores all credentials inside ~/.mcp-auth (or wherever your MCP_REMOTE_CONFIG_DIR points to). If you're seeing connection or auth issues, try:

rm -rf ~/.mcp-auth

Then restart your MCP client.

Resetting Tools in VS Code

If you update Baz’s tool signature (parameters, description, etc.), MCP caches may need to be reset:

1. Open the Command Palette (Cmd+Shift+P on Mac)

2. Run: MCP: Reset cached tools

How Baz Uses Context

Baz leverages repository-level context to deliver meaningful reviews. Context includes:

• File history and usage patterns

• Developer-authored messages and rationale

• Test coverage and check results

• Code relationships and architecture patterns

Each tool invocation from your IDE sends this structured context to Baz’s models for analysis.

You don’t need to manage this manually—once Baz is connected, the tools will automatically pull the right metadata from your current session and file view.

Leveraging Advanced Customizations

By integrating with Baz, you can manage your review configurations centrally in one place - https://baz.co. This allows for cross-org alignment and enforcement on review principles, coding standards and conventions. Sign up free for a 14 day trial at https://baz.co.

Summary

You can connect Baz to any MCP-compatible IDE in seconds using the https://baz.co/mcp endpoint. Once connected, Baz enhances your AI workflow by delivering context-aware, structured code reviews inside your editor.