Inicio / Extender: habilidades, MCP, subagentes, hooks, plugins

MCP: el protocolo de conexión

MCP es el estándar abierto que conecta a Claude con herramientas y datos externos alrededor de tres primitivas: las herramientas que puede llamar, los recursos que puede leer, las invitaciones reutilizables que puede proponer.

Model Context Protocol, abreviado MCP, es un estándar abierto que describe cómo un asistente como Claude Code se conecta a herramientas y datos que viven fuera de él, una base de datos, una API, un sistema de tickets. Un servidor MCP es un pequeño programa que habla este protocolo y expone tres cosas distintas a Claude: herramientas que puede llamar con argumentos, recursos que puede leer como un contenido, e invitaciones, plantillas de solicitud listas para usar que el usuario mismo activa. Estas tres primitivas no se sustituyen entre sí, y confundir herramienta y recurso hace perder la mitad de lo que un servidor MCP ofrece realmente.

Tres primitivas, tres detonantes

Una herramienta (tool) es una función. Claude decide solo llamarla cuando la tarea lo requiere, con argumentos validados contra un esquema declarado por el servidor. Un recurso (resource) es un contenido expuesto como un dato para leer, un archivo de configuración remoto o el contenido de una página interna, sin argumento ni efecto secundario. Una invitación (prompt) es una plantilla de solicitud que el servidor propone, pero que solo el usuario activa explícitamente, jamás Claude por iniciativa propia. La figura que sigue cruza estas tres primitivas según lo que las detona y lo que retornan.

Dónde vive realmente el registro

Un servidor MCP se declara en un archivo de configuración, no en los ajustes generales del harnais. Coexisten dos ubicaciones: un archivo .mcp.json en la raíz del proyecto, compartido por el repositorio git y por lo tanto visible para todo el equipo, o la entrada mcpServers del archivo ~/.claude.json, en alcance de usuario o local, propio de tu equipo. Un servidor declarado en .mcp.json y conectado a una API que exige una clave privada expone esa clave a cualquiera que clone el repositorio, lo que lleva a preferir el alcance de usuario para todo lo que lleve un identificador personal. Un ejemplo mínimo de declaración:

{
  "mcpServers": {
    "depot-tickets": {
      "command": "node",
      "args": ["./serveurs/tickets.js"]
    }
  }
}

Nada de esto pasa por un archivo settings.json en sentido estricto, una confusión frecuente ya que settings.json gestiona los permisos y no las conexiones. La lección siguiente detalla cómo agregar un servidor por línea de comandos y verificar su estado de conexión.