> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braingrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing BrainGrid MCP

> Step-by-step guide to install BrainGrid MCP

<Tabs>
  <Tab title="Claude Code">
    Add BrainGrid to your Claude Code configuration:

    ```bash theme={null}
    claude mcp add --transport http braingrid https://mcp.braingrid.ai/mcp
    ```

    Then restart your Claude Code session. You'll see that the BrainGrid MCP is available but needs authentication.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/claude-code-001.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=938cd7054b34f34dd1b4378d9821f1b9" alt="BrainGrid MCP in Claude Code" width="1622" height="456" data-path="images/claude-code-001.png" />
    </Frame>

    Enter `/mcp` to manage your MCP servers:

    ```bash theme={null}
    /mcp
    ```

    Then you'll see "BrainGrid disconnected - enter to login"

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/claude-code-002.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=8ea75760e3d07dc4c655593c17018c9f" alt="Manage MCP servers" width="1622" height="462" data-path="images/claude-code-002.png" />
    </Frame>

    Hit "Enter", this will open a browser window to login to BrainGrid. Once you log in, you can approve the BrainGrid MCP to connect to your account.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/claude-code-003.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=f9bea5ad7c28eda2ebc080fcaba84e46" alt="Login to BrainGrid" width="300" height="373" data-path="images/claude-code-003.png" />
    </Frame>

    Once the authentication is complete, you'll see "Authentication successful. Connected to BrainGrid." and you can start using the BrainGrid MCP.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/claude-code-004.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=8393ef6942e121cde96e081f1dcac4ad" alt="BrainGrid MCP connected" width="1634" height="246" data-path="images/claude-code-004.png" />
    </Frame>

    You can now use the BrainGrid MCP to create requirements and tasks.
  </Tab>

  <Tab title="Codex">
    To install the BrainGrid MCP server in Codex:

    1. **Install mcp-remote globally**
       ```bash theme={null}
       npm install -g mcp-remote
       ```

    2. **Open the Codex configuration file**
       * Open `~/.codex/config.toml` in your preferred text editor

    3. **Add the BrainGrid MCP configuration**
       * Add the following configuration:

    ```toml theme={null}
    [mcp_servers.braingrid]
    command = "npx"
    args = ["-y", "mcp-remote@latest", "https://mcp.braingrid.ai/mcp"]
    ```

    4. **Restart Codex**
       * Restart Codex to load the new MCP server configuration
       * Once restarted, you will need to authenticate with BrainGrid

    5. **Authenticate**
       * Follow the authentication prompts to connect your BrainGrid account
       * Once authenticated, you can start using the BrainGrid MCP
  </Tab>

  <Tab title="Cursor">
    To install the BrainGrid MCP server in Cursor, click the button below.

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=braingrid&config=eyJ1cmwiOiJodHRwczovL21jcC5icmFpbmdyaWQuYWkvbWNwIiwidHJhbnNwb3J0IjoiaHR0cFN0cmVhbSJ9">
      <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add braingrid MCP server to Cursor" height="32" />
    </a>

    Once you click, you'll be taken to the Cursor MCP settings.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/cursor-001.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=d04447ddd3a263ddbbf17654049a0339" alt="Cursor MCP settings" width="572" height="265" data-path="images/cursor-001.png" />
    </Frame>

    Click "Install" and you'll see the BrainGrid MCP server installed with a "Needs login" message.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/cursor-002.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=2a57db529da82a98e2392b78b0ee2c14" alt="BrainGrid MCP installed" width="546" height="71" data-path="images/cursor-002.png" />
    </Frame>

    Click on the "Needs login" message and you'll be taken to the BrainGrid login page. Once you log in, you can approve the BrainGrid MCP to connect to your account.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/cursor-003.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=8e069ed5442176ef8c6e5c5cf68bb2da" alt="BrainGrid login approval page" width="300" height="368" data-path="images/cursor-003.png" />
    </Frame>

    Once you're logged in, you can start using the BrainGrid MCP.

    <Frame>
      <img src="https://mintcdn.com/braingrid/e_wEFgP1tCKWafLo/images/cursor-004.png?fit=max&auto=format&n=e_wEFgP1tCKWafLo&q=85&s=1b2c7bab8bf10030ee7ef0083f574114" alt="BrainGrid MCP connected" width="546" height="61" data-path="images/cursor-004.png" />
    </Frame>
  </Tab>

  <Tab title="Windsurf">
    To install the BrainGrid MCP server in Windsurf:

    1. **Install mcp-remote globally**
       ```bash theme={null}
       npm install -g mcp-remote
       ```

    2. **Open Windsurf Settings**
       * Click the Settings -> **Windsurf Settings**, or

    <Frame>
      <img src="https://mintcdn.com/braingrid/-4WUO4mo3ZLCyd0y/images/windsurf-mcp-001.png?fit=max&auto=format&n=-4WUO4mo3ZLCyd0y&q=85&s=f90a36006cca208a1c92bd79bbf84673" alt="Windsurf settings" width="464" height="196" data-path="images/windsurf-mcp-001.png" />
    </Frame>

    3. **Scroll down to the MCP Servers section**
       * Click **Open MCP Marketplace**

    <Frame>
      <img src="https://mintcdn.com/braingrid/-4WUO4mo3ZLCyd0y/images/windsurf-mcp-002.png?fit=max&auto=format&n=-4WUO4mo3ZLCyd0y&q=85&s=7c7a4cb6f3ef33829ab2ca70021a33dc" alt="Windsurf MCP settings" width="617" height="142" data-path="images/windsurf-mcp-002.png" />
    </Frame>

    4. **In the Installed MCPs sub section**
       * Click the gear icon on the right.

    <Frame>
      <img src="https://mintcdn.com/braingrid/-4WUO4mo3ZLCyd0y/images/windsurf-mcp-003.png?fit=max&auto=format&n=-4WUO4mo3ZLCyd0y&q=85&s=68e6bf620e061ba2f22f8b768f708276" alt="Windsurf settings" width="764" height="72" data-path="images/windsurf-mcp-003.png" />
    </Frame>

    5. **Configure the Server**
       * Enter the following configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "braingrid": {
          "command": "npx",
          "args": ["-y", "mcp-remote@latest", "https://mcp.braingrid.ai/mcp"]
        }
      }
    }
    ```

    6. **Complete Setup**
       * Close all tabs
       * Reopen the Windsurf Settings
       * Go to the MCP Marketplace, click open
       * You will see the BrainGrid MCP server listed

    <Frame>
      <img src="https://mintcdn.com/braingrid/-4WUO4mo3ZLCyd0y/images/windsurf-mcp-004.png?fit=max&auto=format&n=-4WUO4mo3ZLCyd0y&q=85&s=19a943b818a7bb8a1d89a08715928c85" alt="BrainGrid MCP in Windsurf" width="750" height="157" data-path="images/windsurf-mcp-004.png" />
    </Frame>

    7. **Troubleshooting**
       * If you are having connection or auth issues, disable it and re-enable it.
  </Tab>

  <Tab title="Warp">
    To install the BrainGrid MCP server in Warp:

    1. **Open MCP Settings**
       * Click on the **Settings menu** in Warp
       * Navigate to **Features** → **AI** → **Model Context Protocol (MCP)** → **MCP settings**
       * Or visit the [MCP settings documentation](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) for more details

    2. **Add the Server Configuration**
       * In the MCP settings, add the following configuration:

    ```json theme={null}
    {
      "braingrid": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote@latest",
          "https://mcp.braingrid.ai/mcp"
        ],
        "env": {},
        "working_directory": null
      }
    }
    ```

    3. **Complete Setup**
       * Save the configuration
       * Restart Warp to load the new MCP server
       * You will need to authenticate with BrainGrid on first use
  </Tab>

  <Tab title="JSON Config">
    For other tools, add BrainGrid MCP to your JSON configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "braingrid": {
          "url": "https://mcp.braingrid.ai/mcp",
          "transport": "httpStream"
        }
      }
    }
    ```
  </Tab>
</Tabs>