Administrar y compartir MCP servers

Organiza tus servers con scopes y compártelos con tu equipo

⏱ Estim. ~5 min

01 · Leer

Cuando agregas un MCP server, eliges un scope que define quién lo ve y dónde se guarda.

Local (por defecto): privado, solo en el proyecto actual. Se guarda en ~/.claude.json bajo la ruta de tu proyecto. Úsalo para servers de desarrollo personal o servers con credenciales sensibles.

Project: se comparte con el equipo vía un archivo .mcp.json en la raíz del repo. Se hace commit a git y todos los que clonen el repo obtienen los mismos servers. Úsalo para las herramientas estándar del equipo.

User: disponible en todos tus proyectos. Se guarda en ~/.claude.json. Ideal para herramientas personales que usas en todas partes (como GitHub o tu base de datos personal).

Puntos clave

Local (por defecto): privado, solo en el proyecto actual
Project: se comparte con el equipo vía .mcp.json en el repo, con commit a git
User: personal, disponible en todos tus proyectos
Elige el scope con --scope local|project|user

02 · Ejemplo de código

El flag --scope controla dónde se guarda la configuración del server.

Scope local (por defecto: solo tú, este proyecto)

claude mcp add --transport http stripe https://mcp.stripe.com

Scope project (compartido con el equipo vía git)

claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

Scope user (tú, todos los proyectos)

claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

Local es el valor por defecto: no necesitas usar --scope local. El scope project crea un archivo .mcp.json en tu repo que tus compañeros reciben al hacer pull. El scope user vive en la configuración de tu directorio personal y te acompaña a todas partes.

03 · Ejemplo de código

Cuando usas --scope project, Claude Code crea un archivo .mcp.json en la raíz de tu repo. Se ve así, y lo puedes hacer commit a git.

.mcp.json (con commit al repo)

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Fíjate en la sintaxis ${DATABASE_URL}: las variables de entorno se expanden en tiempo de ejecución, así que puedes compartir la configuración sin exponer secretos. Cada compañero define DATABASE_URL en su propio entorno. La estructura del archivo sigue el formato estándar que Claude Code lee de forma automática.

04 · Leer

Una vez configurados los servers, los administras con unos pocos comandos sencillos.

claude mcp list muestra todos los servers. claude mcp get <name> muestra los detalles de un server. claude mcp remove <name> lo elimina.

Dentro de Claude Code, escribe /mcp para ver el estado de los servers, autenticarte con servers OAuth o solucionar problemas de conexión. Cuando un server no responde, /mcp es el primer lugar para diagnosticar.

Puntos clave

claude mcp list: ver todos los servers configurados
claude mcp get <name>: detalles de un server
claude mcp remove <name>: eliminar un server
/mcp dentro de Claude Code: estado, autenticación, solución de problemas

05 · Quiz

Todos en tu equipo deben usar el mismo MCP server de Sentry. Quieres configurarlo y hacer commit a git para que los nuevos integrantes lo reciban de forma automática. ¿Qué scope usas?

Local (por defecto)
Project
User
Global

06 · Clasificar arrastrando

Tienes tres MCP servers diferentes para configurar. Empareja cada uno con el scope correcto según quién lo necesita.

(Esta sección es interactiva — activa JavaScript para usarla.)

Otras lecciones de este capítulo

⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.

※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.