← Claude Code Hub
Feb 14, 2026 · 3 min de lectura ✦ Tip #010

Configura tu primer servidor MCP en Claude Code en 5 minutos

MCP no es un plugin, ni una skill, ni una API. Es un protocolo. claude mcp add + URL o comando local y tienes Claude conectado a cualquier servicio.

MCP (Model Context Protocol) no es un plugin. No es una skill. No es una API. Es un protocolo — un estándar abierto que define cómo un agente de IA se comunica con herramientas externas. Piensa en USB, pero para conectar Claude con tus servicios: Notion, GitHub, Sentry, bases de datos, lo que sea.

MCP en Claude Code

TL;DR claude mcp add + URL o comando local. Con eso tienes Claude conectado a cualquier servicio.

La diferencia clave: una skill es un prompt que le das a Claude. Una API es algo que tú consumes desde tu código. MCP es algo que Claude consume directamente — le da herramientas nuevas que puede usar sin que tú escribas código.

Result:

> /mcp

  MCP Servers:
  ● notion (http, connected)
  ● db (stdio, connected)

Los dos tipos de servidor

1. Remoto (HTTP) — servicios en la nube

Un servidor HTTP vive en internet. Alguien lo mantiene, tú solo lo conectas:

# Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Algunos requieren autenticación OAuth. Después de añadirlo, ejecuta /mcp dentro de Claude Code y sigue el flujo en el navegador. ¿Te corta a media sesión? Autentícalo desde la terminal y no vuelve a pasar.

2. Local (stdio) — procesos en tu máquina

Un servidor stdio es un proceso que corre localmente. Ideal para bases de datos, herramientas de sistema o scripts propios:

# PostgreSQL
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

# Servidor personalizado
claude mcp add --transport stdio my-tool -- node ./my-mcp-server.js

Referencia rápida

Comando Qué hace
claude mcp add Añade un servidor
claude mcp list Lista servidores configurados
claude mcp remove <name> Elimina un servidor
/mcp Estado y autenticación (dentro de Claude Code)
Scope Dónde se guarda Para qué
--scope local ~/.claude.json (por defecto) Solo tú, solo este proyecto
--scope project .mcp.json en la raíz Compartido con el equipo (va a git)
--scope user ~/.claude.json Solo tú, todos tus proyectos

Con el setup claro, la siguiente pregunta es cuáles instalar: revisa los cinco servidores MCP que de verdad se ganan el slot — más conectores no es mejor agente. Y si te lías con qué va en .mcp.json, qué en ~/.claude.json y qué en settings.json, aquí tienes en qué archivo va cada cosa. ¿Y si el servidor que necesitas no existe? Haz que Claude te lo construya desde tu caso de uso. Y cuando uno tarde de más en responder, ya no te bloquea la sesión: a los dos minutos la llamada pasa a segundo plano. Y si una tarea programada en la nube no encuentra tu servidor, es por el scope: los tres sitios que sí lee. Y un servidor stdio admite sus propios flags después del --: con dos, el Chrome DevTools MCP prueba las herramientas WebMCP de tu web.

Documentación oficial: Connect Claude Code to tools via MCP

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

  • 1. Qué es «mejor» capacidad, tiempo y dinero
  • 2. Modelo a quién mandas
  • 3. Effort cuánta cuerda le das
  • 4. Diagnóstico tres preguntas cuando algo falla
  • 5. La factura por dónde llega
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 8
#

Wmedia · 8 páginas
GUÍA GRATUITA · 8 páginas · 2 mandos

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Usas Opus para todo? Mira cuándo no hace falta.