Tutorial de Claude Code: plugins, skills y los mejores servidores MCP para instalar hoy

Claude Code es el CLI oficial de Anthropic para agentes de desarrollo. De fábrica puede leer, editar y ejecutar código en tu máquina. Con plugins, skills y servidores MCP conectados, se convierte en algo más cercano a un entorno de ingeniería completo que entiende tu repo, tus herramientas y tus sistemas externos — y los trae todos a una sola conversación.

Este es el tutorial que damos al equipo de ingeniería de cada cliente el primer día. Sin relleno. Copia los comandos, pruébalos, y tendrás un Claude Code listo para producción en menos de una hora.

Los tres primitivos: plugins, skills, servidores MCP

Antes de instalar nada, entiende la diferencia — es la parte que casi todos los equipos confunden en la primera semana.

• Plugins son paquetes de comandos, skills, agentes y hooks que se distribuyen juntos. Al instalar impeccable, recibes un conjunto de slash commands /impeccable:*, una suite de skills y los agentes que los sustentan. Una instalación, muchas herramientas.
• Skills son capacidades invocadas por el modelo. No las llamas directamente — Claude Code decide usarlas cuando la conversación encaja con su disparador. Un skill bien escrito es como un compañero de equipo que aparece en silencio con exactamente el checklist correcto cuando una tarea le encaja.
• Servidores MCP (Model Context Protocol) son herramientas externas de larga duración que exponen sus propias funciones a Claude. A diferencia de un plugin, un servidor MCP puede correr en cualquier parte — local, en un contenedor, en un host remoto — y expone capacidades tipadas que Claude puede llamar en cualquier conversación. Piensa en MCP como el bus entre Claude y todo lo que hay fuera de tu sistema de archivos.

Regla del pulgar: usa un plugin cuando quieras workflows preconectados, un skill cuando quieras que Claude haga lo correcto solo y en silencio, y un servidor MCP cuando quieras que Claude toque un sistema externo al que de otro modo no llega.

Instalando tu primer plugin

Los plugins viven en un marketplace. El camino feliz son dos comandos:

claude plugin marketplace add <marketplace-url>
claude plugin install <plugin-name>

Después de la instalación, ejecuta /reload-plugins dentro de Claude Code para activarlos sin reiniciar. Los nuevos slash commands, skills y agentes aparecen inmediatamente.

Puedes verificar que la instalación funcionó escribiendo / y escaneando la lista de comandos. Si el plugin trae comandos, aparecerán con su prefijo de namespace (p. ej. /impeccable:critique).

Instalando un servidor MCP

Los servidores MCP se añaden a través de tu configuración. La forma más rápida es con la config de Claude Code:

claude mcp add <server-name> -- <comando para correr el servidor>

Por ejemplo, para conectar un MCP de Postgres que permita a Claude consultar una base de datos local:

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

Reinicia Claude Code. Las herramientas del servidor ya están disponibles para el modelo. Pídele que consulte la base de datos y llamará al servidor MCP por debajo.

Los 10 servidores MCP que vale la pena instalar esta semana

Esta es nuestra lista real — los que añadimos a cada workspace nuevo por defecto. Cada uno se paga solo en la primera conversación.

1. filesystem — oficial. Acceso al sistema de archivos con alcance a un directorio elegido. Imprescindible cuando Claude Code corre fuera de tu repo.
2. github — oficial. Lee, busca y crea issues, PRs, archivos y gists. Convierte la REST API de GitHub en algo que el modelo puede navegar de forma nativa.
3. postgres — oficial. Consultas SQL de solo lectura contra un Postgres en vivo. Permite a Claude responder preguntas sobre tus datos de producción reales durante el debugging.
4. sqlite — oficial. La misma idea para SQLite. Excelente para desarrollo local y almacenes embebidos.
5. puppeteer — oficial. Control de navegador headless. Claude puede cargar una página, hacer clic, capturar pantalla y scrapear — útil para verificación E2E y QA visual.
6. brave-search — búsqueda web que no requiere una clave de OpenAI. Resultados limpios, atribución y límites de tasa predecibles.
7. slack — lee canales, publica mensajes, busca historial. La diferencia entre "reportar al equipo" siendo una interrupción o una acción de fondo.
8. linear — triaje de tickets, creación de issues desde code review, enlace de commits a work items. Ordena el loop de ingeniería ↔ gestión de proyecto.
9. sentry — trae datos de error en vivo. Cuando un agente está depurando una regresión, tener Sentry en contexto le gana a pegar stack traces.
10. context7 — trae documentación actual y versionada de librerías y frameworks. Evita que Claude adivine una API que cambió hace seis meses.

Menciones honoríficas: memory, git, fetch, google-drive, notion, stripe. Instala según tu stack.

Los 10 plugins de Claude Code que vale la pena instalar esta semana

Los plugins son de más alto nivel que los servidores MCP — agrupan skills, agentes y comandos que de otro modo tendrías que ensamblar tú mismo.

1. superpowers — una suite de skills para planificación, escritura de planes, ejecución, debugging sistemático, test-driven development, despliegue de subagentes en paralelo y code review. El "primer plugin" más común que instalamos para un ingeniero nuevo.
2. impeccable — review de diseño, crítica, polish, animate, layout y una docena de skills más enfocados al diseño. Si envías cualquier frontend, no es opcional. (Lo usamos para criticar y arreglar cada página del sitio que estás leyendo ahora mismo.)
3. code-review — revisión estilo pull request sobre cualquier diff. Ejecuta chequeos independientes, identifica riesgo y explica el por qué antes de sugerir cambios.
4. searchfit-seo — un kit SEO completo: auditorías, estrategia de contenido, clustering de keywords, schema markup, optimización on-page, análisis de enlazado interno y tracking de visibilidad en IA.
5. frontend-design — generador de UI con criterio que evita la estética AI-slop genérica. Entrega código frontend creativo y listo para producción, no retículas de tarjetas templadas.
6. ui-ux-pro-max — una librería más amplia de inteligencia UX: patrones de diseño, paletas, combinaciones tipográficas, tipos de gráfico, pautas UX y recomendaciones específicas por stack.
7. claude-api — skill para construir, depurar y optimizar apps con la Claude API / Anthropic SDK. Maneja patrones de prompt caching automáticamente.
8. update-config — configura el propio harness de Claude Code a través de settings.json. Necesario para hooks, comportamientos automáticos y reglas de workflow.
9. keybindings-help — la forma más rápida de rebindear teclas, añadir atajos en acorde o personalizar ~/.claude/keybindings.json. Ahorra una hora el primer día.
10. loop y schedule — ejecutan prompts o comandos en intervalos recurrentes o en cron. Convierten sesiones puntuales de Claude en automatizaciones siempre activas.

Un setup realista del primer día

Esta es la secuencia exacta que corremos en una máquina nueva. Diez minutos de extremo a extremo.

# 1. Instala Claude Code (si aún no lo tienes)
# Sigue la documentación oficial en claude.com/claude-code

# 2. Conecta los servidores MCP que vayas a usar de verdad
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/tu/code
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp add context7 -- npx -y @context7/mcp-server

# 3. Instala los plugins
claude plugin marketplace add <tu-marketplace-url>
claude plugin install superpowers
claude plugin install impeccable
claude plugin install code-review

# 4. Recarga sin reiniciar
# Dentro de Claude Code:
/reload-plugins

# 5. Verifica
# Escribe "/" y confirma que los nuevos comandos aparecen.
# Pregúntale a Claude "qué servidores MCP están conectados?" y deberías ver tu lista.

Eso es todo. Ahora tienes un Claude Code que llega a tu sistema de archivos, tu GitHub, documentación en vivo y tiene crítica de diseño, planificación, debugging y code review conectados como skills.

Qué usar primero

Tres experimentos que prueban que el setup funciona:

• Critica una página real: abre cualquier archivo con markup y corre /impeccable:critique. Recibirás una puntuación de salud de diseño, problemas prioritarios y arreglos sugeridos.
• Escribe un plan desde una spec de una línea: usa el skill superpowers:writing-plans. Pásale una frase de lo que quieres construir; te devuelve un plan estructurado.
• Revisa un diff: haz un commit sin push, corre /code-review:code-review. Recorrerá tu diff real, marcará riesgos y propondrá arreglos.

Si los tres funcionan, estás listo. Si alguno falla, la solución más común es un /reload-plugins seguido de un reinicio.

Cosas que evitar

• No instales todos los plugins el primer día. Elige 3–5 que encajen con lo que estás haciendo esta semana. Añadir los diez a la vez convierte tu paleta de comandos en ruido.
• No conectes servidores MCP para los que no tienes credenciales. Un servidor medio configurado es peor que ninguno — Claude intentará usarlo y fallará en silencio.
• No te saltes la verificación del marketplace. Instala solo desde marketplaces en los que confíes. Los plugins corren en el mismo proceso que Claude Code y pueden tocar tu sistema de archivos.
• No trates los skills como comandos. Los skills son invocados por el modelo — describes lo que quieres, Claude elige el skill. Si estás escribiendo /use-this-skill explícitamente, probablemente quieras un comando de plugin en su lugar.

¿Quieres que configuremos un entorno de Claude Code para todo tu equipo de ingeniería en una tarde? Eso es Camino 1 — Entrena a tu equipo — lo corremos como un taller práctico y tus ingenieros se van con una instalación funcional y personalizada.