Skip to main content
MCP (Model Context Protocol) lets the model call external tools and data sources safely, such as fetching a web page, looking up docs, or accessing a database. In CC GUI, open Settings → MCP servers. Claude and Codex are shown separately, each with its own server list and tool set. MCP server list

​
Add a server

Click Add. There are three paths.

​
Manual config

Paste MCP Servers JSON. Prefer npx or uvx to start a local process. Two transports: Scope:
  • Global: written to ~/.claude.json, available to all projects
  • This project only: applies only to the current project
The config will run commands on your computer. Check the source, arguments, and environment variables before you add it.

​
Add from the MCP marketplace

The marketplace lists installable servers by registry. You can search by name, publisher, or tag.
  • Installable: can generate a config directly
  • Browse only: metadata only. Add it yourself from the repo docs
MCP marketplace

​
Import from GitHub Copilot

Paste Copilot MCP JSON. The root key is servers. Preview first, then import. Duplicate names are renamed automatically.

​
Status and tools

Each server card shows connected, connecting, needs auth, or connection failed. Open a card to:
  • Enable / disable
  • View the tool list
  • Open connection logs
  • Edit or delete

​
Use it in chat

After a server is enabled and connected, Claude Code picks tools for the task automatically. You can also run /mcp to inspect status. Permissions still follow the current run mode. In default mode, an MCP tool may still ask first. See Run modes and permissions.