🤖 Servidores MCP

MCP (Model Context Protocol) es el protocolo abierto que conecta LLMs con herramientas externas mediante JSON-RPC.

Es el patrón que Claude Code usa para todas las integraciones externas.

JSON-RPC, transporte stdio/SSE, handshake de capabilities.

Claude Code es el cliente; cada MCP es un servidor que expone tools mediante un schema.

Entender la separación ayuda a depurar y elegir MCPs.

Cliente, servidor, capa de transporte, ciclo de vida.

Cada server declara sus tools con inputSchema de JSON Schema; el client las lista y las invoca.

Es el mecanismo que permite al agente usar herramientas sin código hardcodeado.

tools/list, tools/call, inputSchema, JSON Schema.

MCP transforma al agente de "lector de archivos" en "operador de sistemas".

Sin MCP, el agente solo lee y escribe archivos; con MCP, opera con DBs, APIs y services.

Extensibilidad, composición, estandarización.

Ya existen más de 200 servidores MCP open source que cubren bases de datos, SaaS, DevOps y más.

Saber qué existe evita reinventar la rueda.

Awesome MCP, Smithery, categorías de servers.

MCP es como una API REST, pero optimizada para agentes: schema declarativo, discovery automático.

La analogía facilita entender el modelo mental si ya usaste APIs.

Endpoints REST frente a tools de MCP; OpenAPI frente a inputSchema.

El archivo .claude/settings.json donde declaras cada servidor MCP.

Sin esto, ningún MCP funciona; es el primer paso práctico.

mcpServers, command, args, env.

Server que expone operaciones del filesystem como tools MCP.

Es el MCP más básico e ilustra perfectamente el patrón.

read_file, write_file, list_directory, sandboxing.

Server MCP para operaciones Git: status, diff, commit, branch.

Permite que el agente versione código sin que tengas que intervenir manualmente.

git_status, git_commit, git_diff, permisos.

Server que da al agente acceso SQL a bases de datos SQLite.

Muestra cómo los MCP pueden dar acceso a datos estructurados.

query, execute, schema inspection, read-only mode.

Cómo verificar si el MCP está conectado y las tools aparecen en el agente.

Sin pruebas, no sabes si la configuración está bien.

/mcp, listado de herramientas, invocación manual, logs.

Diagnosticar errores comunes: el server no inicia, timeout, permission denied.

El 90% de los problemas con MCP son de configuración; saber depurar ahorra horas.

stderr logs, npx vs global install, PATH, env vars.

MCP que conecta al agente con canales y DMs de Slack.

Automatización de la comunicación: resumir hilos, responder, notificar.

Token OAuth, canales, send_message, read_channel.

MCP para crear/listar/editar eventos en Google Calendar.

El agente puede verificar disponibilidad y programar reuniones por ti.

Cuenta de servicio, scopes, list_events, create_event.

MCP que permite leer, buscar y enviar correos electrónicos mediante Gmail.

Triaje automático, respuestas rápidas, búsqueda en el historial.

Gmail API, search_emails, send_email, borradores.

MCP para la gestión de proyectos: crear pages, actualizar issues, buscar docs.

El agente puede crear y actualizar tareas y documentación automáticamente.

Notion API key, Linear API, create_page, create_issue.

Ejecutar 3-5 MCP simultáneamente y dejar que el agente los coordine.

La composición es donde MCP brilla: workflows entre varias tools sin código.

Configuración de varios servidores, enrutamiento de herramientas, presupuesto de contexto.

Recetas prácticas: reunión diaria automática, clasificación de correos, resumen de agenda.

Pasar de la teoría a tener automatizaciones funcionando en tu día a día.

Scheduled prompts, multi-MCP chains, output routing.

MCP que conecta al agente con una base de datos PostgreSQL para consultas y mutaciones.

El agente puede analizar datos, generar informes y depurar esquemas.

Cadena de conexión, solo lectura frente a lectura y escritura, query tool.

MCP para operaciones Redis: get/set, inspect keys, pub/sub.

Depurar la caché, verificar colas, monitorear el estado en tiempo real.

URL de Redis, inspección de GET/SET, KEYS y TTL.

MCP genérico para llamar a endpoints REST con headers y body personalizables.

Conecta el agente a cualquier servicio que tenga una API REST.

Base URL, auth headers, request/response mapping.

MCP para ejecutar consultas y mutations GraphQL en cualquier endpoint.

Si tu API es GraphQL, este MCP da acceso completo al agente.

Schema introspection, query/mutation, variables.

Patrones para conectar MCPs a servicios reales (no solo local dev).

El valor real aparece cuando el agente opera en entornos de staging/prod.

Túneles SSH, configuraciones de entorno, pools de conexiones.

Best practices para gestionar tokens, passwords y connection strings con MCPs.

Los MCP con acceso a DBs/APIs necesitan credenciales; filtrarlas = desastre.

Env vars, .env files, gitignore, secret managers.

Un servidor MCP es un proceso que se comunica mediante JSON-RPC por stdio y expone tools.

Entender la anatomía es un requisito previo para crear el tuyo.

Proceso, stdin/stdout, initialize, handler de tools/list.

El paquete @modelcontextprotocol/sdk que abstrae el protocolo por ti.

Con el SDK, creas un server funcional en 30 líneas.

Clase McpServer, StdioServerTransport, tool(), resource().

Cada tool tiene nombre, descripción y un inputSchema (JSON Schema) que el agente usa.

Un schema bien diseñado = el agente acierta los parámetros a la primera.

name, description, inputSchema, required fields, types.

La función que recibe los argumentos del agente, ejecuta la acción y devuelve el resultado.

Es donde vive la lógica real; el handler es el "cuerpo" de la tool.

CallToolResult, matriz content, respuestas text/image, manejo de errores.

Probar el servidor MCP localmente con MCP Inspector y Claude Code.

Un servidor sin pruebas falla en silencio; el inspector facilita mucho las cosas.

MCP Inspector, JSON-RPC manual, pruebas de integración.

Cómo empaquetar y publicar tu servidor MCP (npm, Docker, Smithery).

Compartirlo con el equipo o la comunidad multiplica el impacto.

npm publish, npx entry point, Docker image, publicación en Smithery.

El repositorio awesome-mcp-servers en GitHub: la lista curada por la comunidad.

Punto de partida para descubrir MCP de alta calidad ya disponibles.

Categorías, estrellas, mantenimiento activo, oficiales vs. comunitarios.

Smithery.ai: el npm/marketplace para MCP servers con instalación con un clic.

Instalar MCP mediante Smithery es más rápido que configurarlos manualmente.

smithery install, verified servers, usage stats.

Criterios para evaluar si un MCP server es confiable antes de usarlo.

Un MCP deficiente puede bloquearse, filtrar datos o dar respuestas incorrectas.

Commits recientes, issues abiertas, documentación, pruebas, licencia.

Patrones para combinar de 3 a 8 MCPs en una configuración coherente y productiva.

El poder de MCP se manifiesta en la composición, no en servers aislados.

Presupuesto de tools, conflictos de nombres, enrutamiento prioritario.

Riesgos de MCP maliciosos y cómo protegerte (sandbox, auditoría, privilegio mínimo).

Un MCP ejecuta código en tu máquina; confiar ciegamente es peligroso.

Revisión de código, versiones fijadas, sandboxing, ámbitos de permisos.

Tendencias: servidores remotos, autenticación federada, streaming, herramientas multimodales.

Saber la dirección ayuda a invertir en lo que perdurará.

Remote MCP, OAuth2, Streamable HTTP, composición de herramientas.