Skip to main content
Model Context Protocol (MCP) servers give your agents access to external tools, APIs, and data sources beyond their built-in capabilities. Codeg manages MCP server configuration for all supported agents — Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, and Cline — from a single interface. Navigate to Settings → MCP to manage your MCP servers.

​
How Codeg stores MCP configuration

Codeg writes MCP server entries directly into each agent’s native configuration file:
AgentConfig file
Claude Code~/.claude.json (mcpServers)
Codex CLI~/.codex/config.toml (mcp_servers)
OpenCode~/.config/opencode/config.json (mcpServers)
Gemini CLI~/.gemini/settings.json
OpenClaw~/.openclaw/openclaw.json
Cline~/.cline/data/settings/cline_mcp_settings.json
MCP servers are global — once added, they are available in all your projects unless you remove them from a specific agent.

​
Adding a server

​
Scan for locally installed servers

When you open Settings → MCP, Codeg automatically scans your machine for already-configured MCP servers across all supported agents. Any server already present in an agent’s config file appears in the Local tab immediately — no manual steps required. Use the refresh button to rescan after installing a new server outside of Codeg.

​
Install from a marketplace

Codeg connects to two MCP marketplaces:
  • Official MCP Registry — registry.modelcontextprotocol.io
  • Smithery — smithery.ai
1

Open the Marketplace tab

In Settings → MCP, click the Market tab in the left panel.
2

Select a marketplace

Choose Official MCP Registry or Smithery from the marketplace dropdown.
3

Search for a server

Type a keyword in the search field and press Enter or click the search button. Results show the server name, protocol badges, version, and use count.
4

Review the server details

Click a result to open its detail panel. You can see the description, homepage link, install options, and the default configuration JSON.
5

Install the server

Click Install. A dialog appears where you:
  • Select the connection protocol (stdio, HTTP, or SSE — Codeg defaults to the lowest-overhead option)
  • Fill in required parameters (API keys, tokens, or other values)
  • Select which agents should use this server
6

Confirm

Click Confirm Install. Codeg writes the server entry into each selected agent’s configuration file.
Codeg requests Smithery and Official Registry servers with a 20-second timeout and retries up to three times on network errors or rate limits before reporting a failure.

​
Add a server manually

To configure a local server by hand, switch to the Local tab and edit the JSON spec for an existing server, or install from the marketplace and then edit the resulting entry. A stdio server spec looks like this: 
{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@my-org/my-mcp-server"],
  "env": {
    "API_KEY": "your-api-key"
  }
}
A remote HTTP or SSE server spec looks like this: 
{
  "type": "http",
  "url": "https://my-mcp-server.example.com/mcp",
  "headers": {
    "Authorization": "Bearer your-token"
  }
}
Codeg validates and normalizes the spec before writing it. The type field is inferred automatically — if you supply command, it defaults to stdio; if you supply url, it defaults to http.

​
Managing which agents use a server

Each MCP server has an apps setting — the list of agents that have the server in their config. After installing or selecting a server in the Local tab, you can check or uncheck individual agents to add or remove the server from their config without deleting it entirely. Supported app values:
ValueAgent
claude_codeClaude Code
codexCodex CLI
geminiGemini CLI
open_clawOpenClaw
open_codeOpenCode
clineCline
At least one agent must be selected — Codeg rejects a save with an empty apps list.

​
Removing a server

Select the server in the Local tab and click Uninstall, or right-click the server entry and choose Uninstall from the context menu. This removes the entry from every agent’s config file. To remove a server from only specific agents, uncheck those agents in the apps checkboxes and save, rather than clicking Uninstall.