Getting Started
Quick Install
Click one of the buttons below to install the MCP server in your preferred IDE:
Manual Installation
Note: When you install the MCP server, you may be prompted to enter the following:
- GITCODE_ACCESS_TOKEN: Replace placeholder value
${input:gitcode_access_token}with your actual GitCode access token and you can start using the service.
Standard config works in most tools:
{
"servers": {
"GitCode API": {
"command": "uvx",
"args": [
"--from",
"gitcode-api[mcp]",
"gitcode-api",
"serve"
],
"env": {
"GITCODE_ACCESS_TOKEN": "${input:gitcode_access_token}"
}
}
}
}
VS Code
Click the button to install:
Or install manually:
Follow the MCP install guide, use the standard config above. You can also install the GitCode API MCP server using the VS Code CLI:
code --add-mcp '{\"name\":\"GitCode API\",\"command\":\"uvx\",\"args\":[\"--from\",\"gitcode-api[mcp]\",\"gitcode-api\",\"serve\"],\"env\":{\"GITCODE_ACCESS_TOKEN\":\"${input:gitcode_access_token}\"},\"inputs\":[{\"id\":\"gitcode_access_token\",\"type\":\"promptString\",\"description\":\"Enter GITCODE_ACCESS_TOKEN\",\"password\":true}]}'
After installation, the GitCode API MCP server will be available for use with your GitHub Copilot agent in VS Code.
VS Code Insiders
Click the button to install:
Or install manually:
Follow the MCP install guide, use the standard config above. You can also install the GitCode API MCP server using the VS Code Insiders CLI:
code-insiders --add-mcp '{\"name\":\"GitCode API\",\"command\":\"uvx\",\"args\":[\"--from\",\"gitcode-api[mcp]\",\"gitcode-api\",\"serve\"],\"env\":{\"GITCODE_ACCESS_TOKEN\":\"${input:gitcode_access_token}\"},\"inputs\":[{\"id\":\"gitcode_access_token\",\"type\":\"promptString\",\"description\":\"Enter GITCODE_ACCESS_TOKEN\",\"password\":true}]}'
After installation, the GitCode API MCP server will be available for use with your GitHub Copilot agent in VS Code Insiders.
Visual Studio
Click the button to install:
Or install manually:
- Open Visual Studio
- Navigate to the GitHub Copilot Chat window
- Click the tools icon (🛠️) in the chat toolbar
- Click the + "Add Server" button to open the "Configure MCP server" dialog
- Fill in the configuration:
- Server ID:
GitCode API - Type: Select
stdiofrom the dropdown - Command:
uvx - Arguments:
--from gitcode-api[mcp] gitcode-api serve - Environment Variables: Configure as needed
- Note: You'll be prompted for secure values during installation
- Server ID:
- Click "Save" to add the server
For detailed instructions, see the Visual Studio MCP documentation.
Cursor
Click the button to install:
Or install manually:
Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command from the standard config above. You can also verify config or add command like arguments via clicking Edit.
Goose
Click the button to install:
Or install manually:
Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command from the standard config above. Click "Add Extension".
LM Studio
Click the button to install:
Or install manually:
Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.
Claude Code
Use the Claude Code CLI to add the GitCode API MCP server:
claude mcp add GitCode API uvx --from gitcode-api[mcp] gitcode-api serve
Claude Desktop
Follow the MCP install guide, use the standard config above.
Alternatively, download the gitcode-<version>.mcpb asset from the matching GitHub Release and install it in Claude Desktop (double-click, drag-and-drop, or Settings → Extensions → Advanced settings → Install Extension…). That format is Anthropic’s MCP bundle for local servers; see Build a desktop extension with MCPB.
Codex
Create or edit the configuration file ~/.codex/config.toml and add:
[mcp_servers.GitCode API]
command = "uvx"
args = ["--from", "gitcode-api[mcp]", "gitcode-api", "serve"]
For more information, see the Codex MCP documentation.
Gemini CLI
Follow the MCP install guide, use the standard config above.
OpenCode
Follow the MCP Servers documentation. For example in ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"GitCode API": {
"type": "local",
"command": [
"uvx",
"--from",
"gitcode-api[mcp]",
"gitcode-api",
"serve"
],
"enabled": true
}
}
}
GitHub Copilot Coding Agent
GitHub Copilot Coding Agent can use MCP servers to extend its capabilities. Use the configuration below specifically formatted for the Coding Agent:
{
"mcpServers": {
"GitCode API": {
"command": "uvx",
"args": [
"--from",
"gitcode-api[mcp]",
"gitcode-api",
"serve"
],
"env": {
"GITCODE_ACCESS_TOKEN": "${input:gitcode_access_token}"
},
"type": "local",
"tools": [
"*"
]
}
}
}
Add this configuration to your repository settings under Copilot > Coding agent. The "tools": ["*"] setting enables all available tools from the MCP server.
For more information, see the GitHub Copilot Coding Agent MCP documentation.
Configuration Details
- Server Name:
GitCode API - Type: UVX Package
- Package:
gitcode-api - From:
gitcode-api[mcp]
Optional — quiet stdio startup: Some hosts prefer minimal stdout noise from MCP servers. Append --show-banner and false to the serve arguments (after serve):
"args": [
"--from",
"gitcode-api[mcp]",
"gitcode-api",
"serve",
"--show-banner",
"false"
]
Need Help?
For more information about the Model Context Protocol, visit modelcontextprotocol.io.