Client Integrations

Set up the Sourcegraph MCP server with your preferred AI coding tool or IDE.

Supported Clients

• Claude Code
• Codex
• Cursor
• GitHub Copilot
• OpenCode
• Amp
• Google Antigravity
• Google Gemini Code Assist
• Devin Desktop

In all examples, replace sourcegraph.example.com with your Sourcegraph instance URL. For Claude Code, Cursor, GitHub Copilot, 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.

Claude Code

Add the Sourcegraph MCP server to Claude Code for all your projects:

BASH
claude mcp add --transport http --scope user sourcegraph https://sourcegraph.example.com/.api/mcp

Then run claude mcp login sourcegraph, or run /mcp in Claude Code, and follow the browser authentication flow. Without --scope user, Claude Code adds the server only for the current project.

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 by adding the following to ~/.codex/config.toml, or to .codex/config.toml for a trusted project. The Codex CLI, IDE extension, and ChatGPT desktop app share this configuration.

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

Then authenticate with codex mcp login sourcegraph.

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's Customize page and follow the OAuth prompt. See Cursor's MCP documentation for more information.

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

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

GitHub Copilot

GitHub Copilot CLI and Copilot in VS Code read the same MCP configuration file, ~/.copilot/mcp-config.json. Add the Sourcegraph MCP server with the Copilot CLI:

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

Or add the following to ~/.copilot/mcp-config.json:

JSON
{
	"mcpServers": {
		"sourcegraph": {
			"type": "http",
			"url": "https://sourcegraph.example.com/.api/mcp",
			"tools": ["*"]
		}
	}
}

To authenticate, run /mcp auth sourcegraph in Copilot CLI, or select Authenticate on the server in VS Code. In VS Code, you can also run Chat: Open Customizations, select MCP Servers > Add Server, choose HTTP, and save the server to Global > Copilot Global to write the same file. See VS Code's MCP documentation for more information.

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

JSON
{
	"mcpServers": {
		"sourcegraph": {
			"type": "http",
			"url": "https://sourcegraph.example.com/.api/mcp",
			"tools": ["*"],
			"headers": {
				"Authorization": "token ${SOURCEGRAPH_ACCESS_TOKEN}"
			}
		}
	}
}

OpenCode

Add the Sourcegraph MCP server to OpenCode for all your projects:

BASH
opencode mcp add sourcegraph --global --url https://sourcegraph.example.com/.api/mcp

Without --global, OpenCode adds the server to the current project's configuration. You can also add the following to ~/.config/opencode/opencode.json, or to opencode.json in a project root:

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

Then authenticate with opencode mcp auth sourcegraph, or run /mcps in OpenCode and select the server.

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

JSON
{
	"$schema": "https://opencode.ai/config.json",
	"mcp": {
		"servers": {
			"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:

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 Amp's settings file, ~/.config/amp/settings.json:

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

These commands and settings configure Amp on your computer. Amp threads that run in orbs don't read them. To use Sourcegraph in orbs, add the server in your Amp MCP server settings, or with amp mcp remote --personal add sourcegraph https://sourcegraph.example.com/.api/mcp.

Google Antigravity

The Antigravity app, IDE, and CLI read MCP servers from an mcp_config.json file. Antigravity CLI uses ~/.gemini/config/mcp_config.json for all projects and .agents/mcp_config.json for a workspace. In the Antigravity app, click Copy Config File Path in the MCP servers section to find its file. Add the following:

JSON
{
	"mcpServers": {
		"sourcegraph": {
			"serverUrl": "https://sourcegraph.example.com/.api/mcp"
		}
	}
}

Then click Authenticate next to the server in Customizations and complete the browser authentication flow.

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

JSON
{
	"mcpServers": {
		"sourcegraph": {
			"serverUrl": "https://sourcegraph.example.com/.api/mcp",
			"headers": {
				"Authorization": "token YOUR_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://sourcegraph.example.com/.api/mcp",
   			"headers": {
   				"Authorization": "token YOUR_ACCESS_TOKEN"
   			}
   		}
   	}
   }

   Replace sourcegraph.example.com with your Sourcegraph instance URL and YOUR_ACCESS_TOKEN with your access token.

3. Save the configuration file.

4. Restart Gemini Code Assist to apply the new configuration.

Devin Desktop

Devin Desktop, formerly Windsurf, shares its MCP configuration with the Devin CLI. Add the Sourcegraph MCP server for all your projects:

BASH
devin mcp add -s user sourcegraph https://sourcegraph.example.com/.api/mcp

Or add the following to ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json on Windows):

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

Then run devin mcp login sourcegraph, or click Authenticate on the server in Devin Desktop.

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

JSON
{
	"mcpServers": {
		"sourcegraph": {
			"url": "https://sourcegraph.example.com/.api/mcp",
			"headers": {
				"Authorization": "token YOUR_ACCESS_TOKEN"
			}
		}
	}
}