Servidores MCP en Claude Code: qué son y cómo usarlos (Guía 2026)
Estás usando Claude Code para escribir código, pero cada vez que necesitas consultar la base de datos, verificar un pago en Stripe o verificar una solicitud de extracción en GitHub, debes salir de Claude Code, abrir otra herramienta, copiar los datos y regresar. Esto interrumpe el flujo de trabajo y consume tiempo.
O MCP (Protocolo de contexto modelo)resuelve exactamente este problema. Permite a Claude Code conectarse directamente a herramientas y servicios externos, sin tener que abandonar el terminal. Claude Code consulta el banco, procesa pagos, lee repositorios, todo dentro de la misma sesión.
En esta guía comprenderá qué es MCP, cómo configurarlo, qué servidores están disponibles y cómo usarlo en la práctica con Supabase, Stripe, GitHub y otros servicios.
1. ¿Qué es MCP (Protocolo de contexto modelo)?
MCP y unprotocolo abiertocreado por Anthropic que estandariza cómo los modelos de IA se conectan a herramientas externas y fuentes de datos. Piense en ello como USB-C para IA: una interfaz universal que permite a Claude Code "conectarse" a cualquier servicio que implemente el protocolo.
Definición técnica:MCP (Protocolo de contexto modelo) es un protocolo cliente-servidor donde Claude Code actúa como cliente y las herramientas externas actúan como servidores. Cada servidor expone un conjunto de herramientas (funciones) que Claude Code puede llamar durante una sesión. La comunicación se realiza a través de JSON-RPC a través de stdio o HTTP.
Antes de MCP, la integración de Claude Code con herramientas externas requería soluciones alternativas: ejecutar comandos CLI, analizar resultados y copiar datos manualmente. Con MCP, la integración es nativa. Claude Code sabe qué herramientas están disponibles, qué parámetros acepta cada una y cómo interpretar los resultados.
La analogía más simple
Imagínese que Claude Code es un profesional sentado frente a un escritorio. Sin MCP, solo tiene acceso a los archivos de la tabla (su proyecto local). Con MCP, obtiene un teléfono con línea directa a la base de datos, al sistema de pago, al repositorio de códigos y a cualquier otro departamento. Llama, pide información, la recibe y sigue trabajando, sin levantarse de la mesa.
Componentes del protocolo
MCP trabaja con tres componentes principales:
- Cliente MCPC:El Código Claude. Envía solicitudes a los servidores y procesa las respuestas.
- Servidor MCPS:un proceso que expone herramientas para un servicio específico. Ejemplo: el servidor MCP de Supabase expone herramientas para consultar tablas, ejecutar SQL y enumerar migraciones
- Transporte:el canal de comunicación entre el cliente y el servidor. Puede ser stdio (proceso local) o HTTP (servidor remoto)
2. Cómo funciona MCP en la arquitectura de Claude Code
Cuando configura un servidor MCP en Claude Code, sucede lo siguiente:
- Inicialización:Al iniciar Claude Code, lee el archivo.
.mcp.jsone inicia los procesos de los servidores MCP configurados - Descubrimiento:Claude Code pregunta a cada servidor qué herramientas ofrece. El servidor responde con una lista de funciones, parámetros y descripciones.
- Disponibilidad:las herramientas están disponibles para que Claude Code las utilice durante la sesión, como si fueran funciones nativas
- Ejecución:Cuando Claude Code decide que necesita una herramienta (por ejemplo, consultar al banco), envía una solicitud al servidor MCP, que ejecuta la acción y devuelve el resultado.
[MCP] Servidor inicial: supabase
[MCP] Servidor inicial: github
# 2. Descubrimiento: Claude descubre las herramientas disponibles
[MCP:supabase] Herramientas: ejecutar_sql, list_tables, get_project
[MCP:github] Herramientas: create_issue, list_prs, get_file
#3. Pides algo que requiere datos externos
> quantos usuarios se cadastraram ontem?
# 4. Claude usa la herramienta MCP automáticamente
[MCP:supabase] ejecutar_sql("SELECCIONAR CONTADOR(*) DE usuarios DONDE creado_en >= '2026-04-01'")
Ayer se registraron 47 nuevos usuarios en el sistema.
El punto importante: no es necesario que le diga a Claude Code "use el MCP de Supabase". Automáticamente identifica que necesita datos del banco y utiliza la herramienta adecuada. La experiencia es transparente.
3. Servidores MCP versus habilidades: ¿cuál es la diferencia?
Esta es una duda común. Ambos amplían las capacidades de Claude Code, pero de maneras fundamentalmente diferentes:
| Aspecto | Servidores MCP | Habilidades |
|---|---|---|
| lo que proporcionan | Herramientas (acciones ejecutables en servicios externos) | Conocimientos e instrucciones de expertos. |
| Analogía | Herramientas en el banco (martillo, llave, taladro) | Manual de expertos (cómo utilizar cada herramienta) |
| Ejemplo | Ejecute SQL en Supabase, cree cargos en Stripe | Saber estructurar consultas optimizadas, cómo modelar datos. |
| Ajustes | Archivo.mcp.json | Archivos.md em .claude/commands/ |
| Requerir credenciales | Sí (claves API, tokens) | Nao |
| Realizar acciones exteriores | Sim | No (solo instruye a Claude) |
En la práctica,Las habilidades y los servidores MCP son complementarios.. Una habilidad de "arquitecto de bases de datos" le enseña a Claude Code las mejores prácticas de modelado de datos. El servidor MCP de Supabase le permite ejecutar estas consultas directamente en la base de datos. Juntos, tenéis un Código Claude que sabe qué hacer y tiene acceso para hacerlo.
Potente combinación:habilidadesPaquete de desarrolloincluya instrucciones para Supabase, Stripe, API REST y más. Cuando se combina con los servidores MCP correspondientes, Claude Code se convierte en un desarrollador full-stack con acceso directo a toda la infraestructura.
4. Configurando .mcp.json paso a paso
La configuración de los servidores MCP se realiza en el archivo.mcp.json. Puedes configurarlo en dos ámbitos:
- Proyecto:
.mcp.jsonen la raíz del proyecto (versionado en git, compartido con el equipo) - Global:
~/.claude/.mcp.json(disponible en todos los proyectos)
Estructura de archivos básica
Ejemplo completo con Supabase
Ejemplo con múltiples servidores
Después de guardar el archivo, reinicie Claude Code. Iniciará los servidores automáticamente y verá las herramientas disponibles.
Comprobando si los servidores están activos
3 servidores MCP activos:
- supabase (12 herramientas)
- github (15 herramientas)
- raya (8 herramientas)
Utilice todo este potencial con habilidades ya preparadas
Cada mejora de Claude hace que sus habilidades sean aún más poderosas. El Mega Paquete viene con las últimas noticias: más de 748 habilidades actualizadas, probadas y listas para usar en Claude Code.
Ver habilidades actualizadas: R$ 195. 7 servidores MCP más utilizados en 2026
El ecosistema de MCP ha crecido rápidamente. Estos son los servidores más utilizados por la comunidad:
| Servidor | que hace | paquete npm |
|---|---|---|
| Supabase | SQL, tablas, migraciones, funciones perimetrales, autenticación | @supabase/mcp-server |
| GitHub | Problemas, relaciones públicas, repositorios, acciones, búsqueda de código | @modelcontextprotocol/server-github |
| Raya | Clientes, cargos, suscripciones, facturas. | @stripe/mcp-server |
| flojo | Mensajes, canales, hilos, búsqueda. | @modelcontextprotocol/server-slack |
| Sistema de archivos | Acceso ampliado a archivos fuera del proyecto. | @modelcontextprotocol/server-filesystem |
| PostgreSQL | Conexión directa a cualquier base de datos PostgreSQL | @modelcontextprotocol/server-postgres |
| Búsqueda valiosa | Búsqueda web en tiempo real | @modelcontextprotocol/server-brave-search |
Además de estos, existen servidores MCP para Notion, Linear, Jira, Google Drive, AWS y docenas de otros servicios. El repositorio oficial de Anthropic enumera todos los servidores verificados.
6. Ejemplos prácticos: Supabase, Stripe y GitHub
Ejemplo 1: Supabase: consultar datos y crear migraciones
[MCP:supabase] lista_tables()
Tablas encontradas: usuarios, productos, pedidos, pagos, sesiones.
> quantos pedidos foram feitos nos ultimos 7 dias? agrupe por status
[MCP:supabase] ejecutar_sql("SELECCIONAR estado, CONTAR(*) como total DE pedidos DONDE creado_en >= AHORA() - INTERVALO '7 días' GRUPO POR estado ORDEN POR total DESC")
Pedidos en los últimos 7 días:
completado: 234
pendiente: 18
cancelado: 7
> crie uma migration para adicionar uma coluna "phone" na tabela users
[MCP:supabase] apply_migration("ALTERAR TABLA usuarios AGREGAR COLUMNA TEXTO del teléfono;")
La migración se aplicó con éxito.
Ejemplo 2: Stripe: verificar pagos y crear productos
[MCP:stripe] list_charges({límite: 5})
Últimos pagos:
R$ 19,00 - joao@email.com - 2 de abril de 2026 (éxito)
R$ 19,00 - maria@email.com - 2 de abril de 2026 (éxito)
R$ 19,00 - pedro@email.com - 1 de abril de 2026 (éxito)
...
> crie um produto "Pacote Enterprise" por R$197 com checkout link
[MCP:stripe] create_product({nombre: "Paquete empresarial", ...})
[MCP:stripe] create_price({unit_amount: 19700, moneda: "brl", ...})
Producto creado. Enlace de pago: https://buy.stripe.com/...
Ejemplo 3: GitHub: gestionar problemas y relaciones públicas
[MCP:github] list_pull_requests({estado: "abierto", etiquetas: ["error"]})
3 relaciones públicas abiertas con la etiqueta "error":
#142 - Corregir el tiempo de espera del webhook de pago
#138 - Resolver el desbordamiento de CSS en dispositivos móviles
#135 - Corregir el análisis de fechas en los informes
> crie uma issue para rastrear o bug do checkout no Safari
[MCP:github] create_issue({title: "Error: el pago falla en Safari 18", cuerpo: "...", etiquetas: ["error", "alta prioridad"]})
Número 143 creado correctamente.
7. Cómo crear tu propio servidor MCP
Si tienes una API interna o un servicio que no tiene un servidor MCP oficial, puedes crear el tuyo propio. El SDK está disponible en TypeScript yPitón.
Estructura básica en TypeScript
Estructura básica en Python
Después de crear el servidor, configúrelo en.mcp.json:
8. Buenas prácticas y seguridad
Seguridad de credenciales
- Nunca confirmes las credenciales en git.Utilice variables de entorno o un archivo
.envubicación referenciada en.mcp.json - Utilice tokens con permisos mínimos.El servidor MCP de Supabase no necesita un token con permiso para eliminar proyectos. Crear tokens con alcance limitado
- Gire las virutas periódicamente.Especialmente en entornos de producción.
- Agregar
.mcp.jsonao.gitignoresi contiene tokens directamente (en lugar de variables de entorno)
Actuación
- Configura los servidores que necesitas.Cada servidor consume recursos. Si no usa Slack, no configure Slack MCP
- Utilice el alcance del proyecto.Los servidores MCP globales se inician en todos los proyectos. Prefiera la configuración por proyecto cuando sea posible
- Monitorear el consumo de tokens.Cada llamada MCP agrega contexto a la conversación. Las consultas SQL que devuelven 10.000 filas consumirán muchos tokens
Organización
- Documente sus servidores MCP.Si creó un servidor personalizado, incluya un archivo README en el directorio que explique qué hace y cómo configurarlo.
- Utilice nombres descriptivos.
"db-producao"y mejor que"server1" - Ambientes separados.Tener diferentes configuraciones para desarrollo y producción.
Claude evoluciona. Tus habilidades también.
No basta con tener la herramienta más avanzada: es necesario saber cómo utilizarla. Las habilidades son atajos profesionales que transforman a Claude en un experto. Más de 748 habilidades, 7 categorías, R$ 19.
Quiero las Habilidades — R$ 19Preguntas frecuentes
MCP (Model Context Protocol) es un protocolo abierto creado por Anthropic que permite a Claude Code conectarse a herramientas y servicios externos de forma estandarizada. En lugar de que la IA simplemente lea y escriba archivos locales, MCP le permite interactuar directamente con bases de datos (Supabase), procesadores de pagos (Stripe), repositorios (GitHub), plataformas de comunicación (Slack) y cualquier otro servicio que implemente el protocolo.
Los servidores MCP proporcionan herramientas: acciones que Claude Code puede realizar en servicios externos, como consultar una base de datos o crear un registro en Stripe. Las habilidades proporcionan conocimientos e instrucción especializados, como un manual de experto que Claude sigue. En la práctica, las habilidades le dicen a Claude CÓMO pensar y actuar; Los servidores MCP le dan ACCESO para realizar acciones en sistemas externos. Los dos son complementarios. Paquetes comomishabilidades.ioOfrece cientos de habilidades listas para usar que funcionan perfectamente con servidores MCP.
Usted configura los servidores MCP creando o editando el archivo.mcp.jsonen la raíz de su proyecto (para el alcance del proyecto) o en~/.claude/.mcp.json(para alcance global). El archivo define cada servidor con su comando de ejecución, argumentos y variables de entorno. Después de guardar el archivo, reinicie Claude Code y los servidores estarán disponibles automáticamente. Claude Code muestra qué herramientas ofrece cada servidor durante el inicio.