MCP y plugins

Con MCP, Claude Code deja de limitarse a tu repositorio: consulta tu gestor de incidencias, tu base de datos o tu documentación. Con un plugin, tu configuración entera (skills, subagentes, hooks y servidores) se instala de una vez en otro equipo. Las dos cosas multiplican lo que puede hacer y lo que puede salir mal.

Al terminar sabrásConectar un servidor MCP con el ámbito adecuado, explicar qué riesgo añade y decidir qué piezas de tu configuración merece la pena empaquetar en un plugin.

60 minutos· 1 esquema· 5 preguntas· 1 ejercicio· entregable

Repaso

Comprueba De la hora 10: ¿por qué un hook obliga y CLAUDE.md no?

Comprueba De la hora 9: tu subagente revisor tiene tools: Read, Grep. ¿Puede usar un servidor MCP que conectes?

Vocabulario

MCP: Model Context Protocol, un estándar abierto para conectar asistentes con herramientas y datos externos.
Servidor MCP: El programa que expone las herramientas de un sistema (incidencias, base de datos, documentación).
Ámbito: Dónde se guarda y para quién vale un servidor: local, de proyecto o de usuario.
Plugin: Un paquete instalable con skills, subagentes, hooks y servidores MCP.

El ejemplo: conectar la documentación del equipo

Ejemplo resuelto Un servidor MCP de solo lectura, compartido con el equipo

Decidir si hace falta. El equipo consulta a diario la documentación técnica de los equipos de planta, publicada en un servidor interno con MCP. Hoy se copia y se pega en la sesión: un conector ahorra tiempo y errores.
Elegir el ámbito. Lo necesita todo el equipo en este repositorio, así que va con ámbito de proyecto, en .mcp.json, dentro de Git.
Conectarlo: claude mcp add --transport http docs-planta https://docs.ejemplo.interno/mcp --scope project (dirección ficticia).
Revisarlo. Con /mcp se comprueba que está conectado y qué herramientas expone. Solo lee: no puede editar ni enviar nada.
Riesgo. Lee documentación interna (datos privados) que podría contener texto de cualquiera (contenido no fiable). No puede enviar nada fuera: no hay trifecta mientras no se añada una salida al exterior.

Ya lo sé: ir a la práctica ↓

Qué es MCP y cómo se conecta

Según la documentación de Claude Code (consultada el 24/10/2026), hay dos formas de añadir un servidor:

Servidor remoto (HTTP)

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

Servidor local (stdio): todo lo que va tras «--» es el comando del servidor

claude mcp add --transport stdio mi-servidor -- npx -y paquete-del-servidor

Un servidor por sistema; Claude decide cuándo usarlo y tú controlas qué puede hacer.

Los servidores se gestionan con claude mcp list, claude mcp get y claude mcp remove, y dentro de la sesión con /mcp, que muestra su estado y permite iniciar sesión en los que usan OAuth.

El ámbito: dónde vive cada servidor

Ámbito	Para quién	Se guarda en
`local` (por defecto)	Solo tú, en este proyecto	`~/.claude.json`
`project`	Todo el equipo, en este proyecto	`.mcp.json`, en Git
`user`	Solo tú, en todos tus proyectos	`~/.claude.json`

Un detalle de seguridad importante: en las sesiones interactivas, Claude Code pide tu aprobación antes de usar los servidores de proyecto de un .mcp.json, porque alguien los ha añadido al repositorio. Pero en claude -p y en el SDK no puede preguntar y los carga sin pedirla. Revisa el .mcp.json antes de automatizar nada.

La documentación lo advierte: comprueba que confías en cada servidor antes de conectarlo. Los que traen contenido externo pueden exponerte a la inyección de instrucciones. Es la trifecta de la hora 7 aplicada a Claude Code.

Plugins: tu configuración en un paquete

Un plugin reúne skills, subagentes, hooks y servidores MCP en una unidad que se instala de una vez. Se exploran e instalan con /plugin. Mientras desarrollas uno tuyo, lo cargas directamente desde su carpeta con claude --plugin-dir ./mi-plugin, sin publicarlo.

Lo que cuesta tenerlo activado, según la documentación: un plugin activado forma parte de todas tus sesiones. Las descripciones de sus skills y subagentes ocupan contexto en cada turno aunque no los uses, sus servidores MCP se arrancan y lo que ejecuta lo ejecuta con tus permisos. Si no lo usas, desactívalo con /plugin.

Cuándo merece la pena: cuando varias personas o varios repositorios necesitan la misma configuración. Si solo la usas tú en un repositorio, basta con .claude/ dentro de él.

Practica

Clasifica ¿Qué ámbito le darías a cada servidor MCP?

El gestor de incidencias del equipo, que todos usan en este repositorioCategoría
Tu cuenta personal de un servicio de notas, para cualquier proyectoCategoría
Una base de datos de pruebas que solo tú usas en este repositorioCategoría
La documentación interna de la planta, que el equipo consulta en este proyectoCategoría

Comprueba lo que has aprendido

Comprueba Vas a usar claude -p en un script sobre un repositorio que tiene un .mcp.json. ¿Qué tienes que saber?

Comprueba Conectas un servidor MCP que lee correos de clientes y otro que puede publicar en un canal del equipo. ¿Qué has creado?

Comprueba Solo tú usas tu configuración de Claude Code, en un único repositorio. ¿Merece la pena un plugin?

Entregable Tu mapa de servidores MCP

Haz la lista de los servidores MCP que conectarías en tu trabajo (o conecta uno de confianza al repositorio de práctica). Para cada uno: qué lee, qué puede hacer, qué ámbito le das y si con los demás formaría una trifecta. Termina decidiendo si tu configuración merece un plugin.

Está bien si: cada servidor tiene ámbito y motivo; señalas al menos una combinación que formaría trifecta y cómo la rompes; y tu decisión sobre el plugin dice quién más lo usaría. Tiempo: unos 25 minutos.

Tu entregable: Tu mapa de servidores MCP

Lo esencial

MCP conecta Claude Code con tus sistemas: claude mcp add, y /mcp para revisarlos.
Ámbito local para ti y aquí, project para el equipo (en Git) y user para ti en todo.
En claude -p, los servidores de .mcp.json se cargan sin pedir aprobación: revísalos antes.
Cada servidor que trae contenido externo suma riesgo de inyección: vigila la trifecta.
Un plugin compensa cuando varias personas o repositorios necesitan la misma configuración.

Fuentes y para seguir

MCP en Claude Code (se abre en otra pestaña) (documentación oficial, consultada el 24/10/2026).
Plugins (se abre en otra pestaña) (documentación oficial).
Qué es MCP (se abre en otra pestaña) (documentación del protocolo, en inglés).
The lethal trifecta for AI agents (se abre en otra pestaña) (Simon Willison, 2025).

← Hora 10Hooks Hora 12 →Automatizar y entregar

Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.