Añadir servidores MCP a Claude Code

Claude Code obtiene los servidores del comando claude mcp add o de un archivo .mcp.json en la raíz del repositorio.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

Archivo del proyecto

.mcp.json

Clave de nivel superior

mcpServers

Formato

json

OAuth para servidores remotos

●Sí

Ejemplo de configuración

Este ejemplo añade el servidor alojado de GitHub y Playwright como servidor local, con el formato que espera este cliente.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Notas y particularidades

• El ámbito local, que es el predeterminado, y el ámbito de usuario se guardan en ~/.claude.json; el ámbito del proyecto se guarda en .mcp.json.
• Cada entrada con url también necesita un type, como http; una url sin type da error.
• Los valores del archivo expanden ${VAR} y ${VAR:-default}.
• Ejecuta /mcp en una sesión para iniciar sesión en servidores OAuth. Para aplicaciones OAuth prerregistradas, pasa --client-id, --client-secret y --callback-port.

Crear una configuración para Claude Code →

Otros clientes