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

# Connect AI coding tools to Profound MCP

This guide walks you through connecting your AI tool to Profound using our hosted MCP server.

<CodeGroup>
  ```text Streamable HTTP theme={null}
  https://mcp.tryprofound.com/mcp
  ```
</CodeGroup>

## Claude Code

<Steps>
  <Step>
    Run this command in your terminal:

    ```bash theme={null}
    claude mcp add --transport http profound https://mcp.tryprofound.com/mcp
    ```
  </Step>

  <Step>
    Use `/mcp` in Claude Code to confirm the server is installed and complete any authentication flow if prompted.
  </Step>
</Steps>

<Accordion title="Using Different Installation Scopes">
  * `--scope local` installs the server only for the current project
  * `--scope project` shares the configuration with your team in the project
  * `--scope user` installs the server across your projects

  For more details, see [Claude Code MCP Installation Scopes](https://code.claude.com/docs/en/mcp#mcp-installation-scopes).
</Accordion>

## Claude Desktop

<Steps>
  <Step>
    Open **Settings** -> **Connectors** in Claude Desktop.
  </Step>

  <Step>
    Click **Add Custom Connector** and enter the server URL:

    ```text theme={null}
    https://mcp.tryprofound.com/mcp
    ```
  </Step>

  <Step>
    Save the connector and complete any authentication flow if prompted.
  </Step>
</Steps>

<Note>
  Remote MCP servers in Claude Desktop are configured through **Settings** -> **Connectors**, not through `claude_desktop_config.json`.
</Note>

## Cursor

<Steps>
  <Step>
    Open **Cursor Settings** -> **Tools & MCPs** -> **New MCP Server**.
  </Step>

  <Step>
    Add the following configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "profound": {
          "url": "https://mcp.tryprofound.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step>
    Save changes to the config.
  </Step>

  <Step>
    Open **Cursor Settings** -> **Tools & MCPs** -> **New MCP Server**.
  </Step>

  <Step>
    Look for the `profound` MCP server entry, click the **Connect** button, and complete any authentication flow if prompted.
  </Step>
</Steps>

## OpenCode

Add Profound MCP to your OpenCode config:

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "https://mcp.tryprofound.com/mcp",
      "enabled": true
    }
  }
}
```

If OpenCode prompts for authentication, run `opencode mcp auth profound`.

## VS Code

<Steps>
  <Step>
    Create a `.vscode/mcp.json` file in your workspace:

    ```json theme={null}
    {
      "servers": {
        "profound": {
          "type": "http",
          "url": "https://mcp.tryprofound.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step>
    Open the Command Palette and run **MCP: List Servers**.
  </Step>

  <Step>
    Start the Profound server and complete any authentication flow if prompted.
  </Step>
</Steps>

## Windsurf

<Steps>
  <Step>
    Open **Windsurf Settings** and search for **MCP**.
  </Step>

  <Step>
    Open the raw `mcp_config.json` file and add the following configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "profound": {
          "serverUrl": "https://mcp.tryprofound.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step>
    Save the configuration and restart Windsurf.
  </Step>
</Steps>

## Other Tools

### JSON Configuration Format

Most MCP clients accept a JSON configuration.

<CodeGroup>
  ```json Streamable HTTP theme={null}
  {
    "mcpServers": {
      "profound": {
        "url": "https://mcp.tryprofound.com/mcp"
      }
    }
  }
  ```
</CodeGroup>

## Troubleshooting

### Authentication Issues

If your client prompts for authentication and the connection fails, try restarting the client and reconnecting. If your client offers a disconnect option for MCP servers, disconnect the existing connection and try again.

If you need a long-lived credential instead of the OAuth flow, see [Authentication](/mcp/authentication) for the Bearer token (API key) alternative.
