Conectar un servidor MCP

Vamos a conectar tu primer servidor — el artefacto del curso empieza aquí. El comando es claude mcp add, y solo necesitas decidir dos cosas: el transport (cómo se comunica) y el scope (quién lo ve).

El comando

claude mcp add --transport <tipo> <nombre> <url-o-comando>

Un ejemplo real, conectar Sentry para depurar errores de producción:

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Orden de las opciones: todas las flags (--transport, --scope, --env, --header) van antes del nombre. Para servidores locales, el -- separa el nombre del comando que se ejecuta.

Los transports

Estos son los que eliges con --transport:

Para los remotos, HTTP es la opción por defecto. stdio arranca un proceso local en tu máquina, ideal para una CLI o un script tuyo (fíjate en el -- antes del comando).

Hay un cuarto, WebSocket (ws), para servidores que empujan eventos por una conexión persistente. Es nicho: no admite el flag --transport (se configura solo con claude mcp add-json) ni OAuth. Si tu servidor solo responde a peticiones, usa HTTP.

Los scopes: quién ve el servidor

Esto es lo que decide si el servidor es solo tuyo o de todo el equipo:

# Servidor del equipo, versionado:
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

.mcp.json: el servidor del equipo

Con --scope project, Claude Code crea o actualiza un .mcp.json en la raíz del repo. Lo commiteas y todo el equipo hereda los mismos servidores:

{
  "mcpServers": {
    "paypal": { "type": "http", "url": "https://mcp.paypal.com/mcp" }
  }
}

Soporta expansión de variables de entorno, para compartir la config sin filtrar secretos:

{
  "mcpServers": {
    "api": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": { "Authorization": "Bearer ${API_KEY}" }
    }
  }
}

${API_KEY} lo pone cada uno en su entorno; el .mcp.json versionado no lleva el secreto. (Mismo principio que viste con settings.json.) Por seguridad, Claude Code pide aprobación antes de usar servidores de un .mcp.json que vienen del repo.

Gestionar lo conectado

claude mcp list            # lista todos
claude mcp get sentry      # detalle de uno
claude mcp remove sentry   # quitar uno

Tu turno

Conecta un servidor real que uses. Si no tienes uno claro, el de GitHub es útil y vale para el resto del curso:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer TU_GITHUB_PAT"

Qué llevas hasta aquí

• Conectas con claude mcp add --transport <tipo> <nombre> <url>.
• HTTP para remotos, stdio para locales; SSE está deprecado.
• El scope decide el alcance: project escribe un .mcp.json versionado (con expansión de env vars) que hereda el equipo.

En la siguiente lección, usar y verificar lo que acabas de conectar: /mcp, autenticación y cómo aparecen las tools.

Fuente oficial: Connect Claude Code to tools via MCP