Agrega tu primer MCP server
Un comando para conectar Claude Code con GitHub, bases de datos y mucho más
⏱ Estim. ~6 min
01 · Leer
Agregar un MCP server a Claude Code es un solo comando. Usas claude mcp add seguido de un nombre y una URL (para HTTP) o un comando (para stdio).
Una vez agregado, Claude puede usar cada herramienta que ese server exponga, de forma automática. Sin cambios de código, sin archivos de configuración, sin reinicios. Lo agregas y empiezas a pedirle a Claude que lo use.
Puntos clave
- claude mcp add es el comando principal para agregar servers
- Los servers HTTP requieren un nombre y una URL
- Los servers stdio requieren un nombre y un comando para correr
- Opciones como --transport, --env y --scope van antes del nombre del server
02 · Ejemplo de código
Así se agrega un server HTTP remoto, el tipo más común. Este ejemplo conecta Claude con GitHub.
Agregar el MCP server de GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Agregar el MCP server de Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp
Agregar headers de autenticación
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
El patrón siempre es el mismo: claude mcp add --transport http <name> <url>. El nombre es como vas a referirte al server después. La URL es donde vive el MCP server. Si el server requiere un token, usa --header para agregar headers de autenticación.
03 · Ejemplo de código
Los servers stdio corren un proceso local. Este ejemplo usa el paquete dbhub para conectar Claude a una base de datos PostgreSQL.
Agregar el server de PostgreSQL
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/mydb"
Agregar con variables de entorno
claude mcp add --transport stdio airtable \
--env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server
El -- (doble guion) separa las opciones de Claude del comando y los argumentos del server. Todo lo que va después de -- es el comando para correr el MCP server. Usa --env para pasar API keys como variables de entorno de forma segura, sin hardcodearlas.
04 · Paso a paso
1. Elige un server
Decide qué MCP server quieres agregar. Para servers HTTP necesitas la URL del server. Para servers stdio necesitas el nombre del paquete npm o el comando. Revisa la lista oficial de MCP servers o la documentación de tu servicio.
2. Corre claude mcp add
Para servers remotos usa claude mcp add --transport http <name> <url>; para locales usa claude mcp add --transport stdio <name> -- <command>. Recuerda: todas las opciones van antes del nombre y -- separa el comando del server.
3. Verifica la conexión
Corre claude mcp list para ver todos los servers configurados, o usa /mcp dentro de Claude Code para revisar el estado y autenticarte. Un estado en verde significa que el server está conectado y listo.
4. Pídele a Claude que lo use
Empieza una conversación en Claude Code y hazle preguntas que requieran ese server. GitHub: "Muéstrame mis PRs abiertos". Base de datos: "¿Qué tablas hay?". Claude descubre las herramientas del server de forma automática.
05 · Quiz
Vas a agregar un server local de base de datos que necesita la variable de entorno DATABASE_URL. El orden de los flags importa. ¿Cuál comando es correcto?
- claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
- claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
- claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
- claude mcp add -- npx dbhub --transport stdio db
06 · Completar
Para listar todos los MCP servers que tienes configurados, corre claude mcp _____
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.