# Client Integrations

<p className="subtitle">
	Set up the Sourcegraph MCP server with your preferred AI coding tool or IDE.
</p>

<TierCallout>
	Supported on [Enterprise](/pricing/plans/enterprise) plans.
</TierCallout>

## Supported Clients

- [Claude Code](#claude-code)
- [Codex](#codex)
- [Cursor](#cursor)
- [Copilot](#copilot)
- [OpenCode](#opencode)
- [Amp](#amp)
- [Google Gemini Code Assist](#google-gemini-code-assist)
- [VS Code](#vs-code)
    - [Antigravity](#antigravity)
    - [Windsurf](#windsurf)

### Claude Code

Add the Sourcegraph MCP server to [Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp):

```bash
claude mcp add --transport http sourcegraph https://sourcegraph.example.com/.api/mcp
```

Then run `/mcp` in Claude Code and follow the browser authentication flow.

To share an access-token configuration with a project, set `SOURCEGRAPH_ACCESS_TOKEN` in your environment and add the following to `.mcp.json` in the project root:

```json
{
	"mcpServers": {
		"sourcegraph": {
			"type": "http",
			"url": "https://sourcegraph.example.com/.api/mcp",
			"headers": {
				"Authorization": "token ${SOURCEGRAPH_ACCESS_TOKEN}"
			}
		}
	}
}
```

You can also add an access-token configuration for the current project with the CLI:

```bash
claude mcp add --transport http sourcegraph https://sourcegraph.example.com/.api/mcp \
  --header "Authorization: token $SOURCEGRAPH_ACCESS_TOKEN"
```

Locally scoped servers take precedence over project-scoped servers with the same name.

### Codex

Add the Sourcegraph MCP server to [Codex](https://learn.chatgpt.com/docs/extend/mcp) by adding the following to `~/.codex/config.toml`, or to `.codex/config.toml` for a trusted project:

```toml
[mcp_servers.sourcegraph]
url = "https://sourcegraph.example.com/.api/mcp"
scopes = ["mcp"]
```

Then authenticate with `codex mcp login sourcegraph`.

<Callout type="note">
	`scopes = ["mcp"]` is required. Without it, Codex's OAuth login fails with
	an `invalid_scope` error because Sourcegraph's MCP endpoints require the
	`mcp` scope. See [Troubleshooting: `invalid_scope` error during
	OAuth](/api/mcp#invalid_scope-error-during-oauth) for details.
</Callout>

### Cursor

Add the following to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` for a project:

```json
{
	"mcpServers": {
		"sourcegraph": {
			"url": "https://sourcegraph.example.com/.api/mcp"
		}
	}
}
```

Enable the server from **Cursor Settings > Tools & MCP** and follow the OAuth prompt. See [Cursor's MCP documentation](https://cursor.com/docs/mcp) for more information.

To authenticate with a Sourcegraph access token instead, set `SOURCEGRAPH_ACCESS_TOKEN` in Cursor's environment and add an authorization header:

```json
{
	"mcpServers": {
		"sourcegraph": {
			"url": "https://sourcegraph.example.com/.api/mcp",
			"headers": {
				"Authorization": "token ${env:SOURCEGRAPH_ACCESS_TOKEN}"
			}
		}
	}
}
```

### Copilot

Add the Sourcegraph MCP server to [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers):

```bash
copilot mcp add --transport http sourcegraph https://sourcegraph.example.com/.api/mcp
```

Then run `/mcp auth sourcegraph` and follow the authentication flow.

### OpenCode

Add the following to `~/.config/opencode/opencode.json` for a global configuration, or to `opencode.json` in a project root for a project-specific configuration:

```json
{
	"$schema": "https://opencode.ai/config.json",
	"mcp": {
		"sourcegraph": {
			"type": "remote",
			"url": "https://sourcegraph.example.com/.api/mcp"
		}
	}
}
```

Then authenticate with `opencode mcp auth sourcegraph`. See [OpenCode's MCP documentation](https://opencode.ai/docs/mcp-servers/) for more information.

To authenticate with a Sourcegraph access token instead, disable OAuth and add an authorization header:

```json
{
	"$schema": "https://opencode.ai/config.json",
	"mcp": {
		"sourcegraph": {
			"type": "remote",
			"url": "https://sourcegraph.example.com/.api/mcp",
			"oauth": false,
			"headers": {
				"Authorization": "token {env:SOURCEGRAPH_ACCESS_TOKEN}"
			}
		}
	}
}
```

### Amp

Add the Sourcegraph MCP server to [Amp](https://ampcode.com/manual#mcp):

```bash
amp mcp add sourcegraph https://sourcegraph.example.com/.api/mcp
```

Amp starts the OAuth flow in your browser when it connects to the server.

To authenticate with a Sourcegraph access token instead, add an authorization header:

```bash
amp mcp add sourcegraph --header "Authorization=token $SOURCEGRAPH_ACCESS_TOKEN" https://sourcegraph.example.com/.api/mcp
```

You can also configure the access-token connection in VS Code's `settings.json`:

```json
{
	"amp.mcpServers": {
		"sourcegraph": {
			"url": "https://sourcegraph.example.com/.api/mcp",
			"headers": {
				"Authorization": "token ${SOURCEGRAPH_ACCESS_TOKEN}"
			}
		}
	}
}
```

In all examples, replace `sourcegraph.example.com` with your Sourcegraph instance URL. For Claude Code, Cursor, OpenCode, and Amp access-token authentication, set `SOURCEGRAPH_ACCESS_TOKEN` in the client's environment. In other access-token examples, replace `YOUR_ACCESS_TOKEN` with a [Sourcegraph access token](/cli/how-tos/creating-an-access-token).

### Google Gemini Code Assist

You can add the Sourcegraph MCP server to Google Gemini Code Assist by configuring the `.gemini/settings.json` file:

1. Open or create the configuration file at `~/.gemini/settings.json` (or the equivalent path on your system).
2. Add the following configuration:

    ```json
    {
    	"mcpServers": {
    		"sourcegraph": {
    			"httpUrl": "https://your-sourcegraph-instance.com/.api/mcp",
    			"headers": {
    				"Authorization": "token YOUR_ACCESS_TOKEN"
    			}
    		}
    	}
    }
    ```

    <Callout type="info">
    	Replace `your-sourcegraph-instance.com` with your Sourcegraph instance
    	URL and `YOUR_ACCESS_TOKEN` with your access token.
    </Callout>

3. Save the configuration file.
4. Restart Gemini Code Assist to apply the new configuration.

### VS Code

You can add the Sourcegraph MCP server to VS Code in one of two ways:

#### Option 1: `code` CLI

1. Run the following command to add the MCP server to the global configuration

```bash
code --add-mcp "{ \"name\": \"sourcegraph\", \"type\": \"remote\", \"url\": \"https://your-sourcegraph-instance.com/.api/mcp\" }"
```

2. Launch or restart VS Code to apply the new configuration.

#### Option 2: VSCode `mcp.json`

1. Create `.vscode/mcp.json` in your project.
2. Add the following configuration:

    ```json
    {
    	"servers": {
    		"sourcegraph": {
    			"type": "http",
    			"url": "https://your-sourcegraph-instance.com/.api/mcp"
    		}
    	},
    	"inputs": []
    }
    ```

3. Save the configuration file.
4. Restart VS Code to apply the new configuration.

#### Antigravity

1. Create ⁠`.vscode/mcp.json` (Antigravity uses `.vscode` for configs) in your project.
2. Add the following:

    ```json
    {
    	"servers": {
    		"sourcegraph": {
    			"url": "https://your-sourcegraph-instance.com/.api/mcp",
    			"type": "http",
    			"headers": {
    				"Authorization": "token YOUR_ACCESS_TOKEN"
    			}
    		}
    	},
    	"inputs": []
    }
    ```

    <Callout type="info">
    	Replace `your-sourcegraph-instance.com` with your Sourcegraph instance
    	URL and `YOUR_ACCESS_TOKEN` with your access token.
    </Callout>

#### Windsurf

1. Create ⁠`~/.codeium/windsurf/mcp_config.json`.
2. Add the following:

    ```json
    {
    	"mcpServers": {
    		"sourcegraph": {
    			"serverUrl": "https://your-sourcegraph-instance.com/.api/mcp",
    			"headers": {
    				"Authorization": "token YOUR_ACCESS_TOKEN",
    				"Content-Type": "application/json"
    			}
    		}
    	}
    }
    ```

    <Callout type="info">
    	Replace `your-sourcegraph-instance.com` with your Sourcegraph instance
    	URL and `YOUR_ACCESS_TOKEN` with your access token.
    </Callout>

3. Save the configuration file.