Usar y verificar

Has conectado un servidor. Ahora: comprobar que funciona, autenticarte si hace falta, y entender cómo aparecen sus tools y recursos. El centro de todo esto es el comando /mcp.

El panel /mcp

Dentro de la sesión, escribe:

/mcp

Te muestra cada servidor conectado, cuántas tools expone y su estado. Es lo primero que miras siempre que algo no va. Verás algo así:

 MCP Servers

 ● github      connected    · 14 tools
 ● postgres    connected    ·  6 tools
 ○ sentry      needs auth   ·  —
 ◓ figma       connecting…  ·  —

 ↑/↓ moverse · Enter ver tools / autenticar · r reconectar · q salir

Cómo leerlo:

• connected + un número de tools → listo para usar. Si el número es 0, el servidor conectó pero no expone nada útil (revisa su config).
• needs auth → conectó pero requiere login: lo resuelves abajo, con OAuth.
• failed → no pudo arrancar (comando mal, binario que no existe, token caducado). Selecciónalo y pulsa r para reintentar.

Autenticación: OAuth

Muchos servidores en la nube requieren login. Claude Code marca un servidor como needs auth cuando responde 401/403. Para resolverlo:

1. Abre /mcp y selecciona con ↑/↓ el servidor en estado needs auth (en el ejemplo, sentry).
2. Pulsa Enter: Claude abre tu navegador en la página de login del proveedor.
3. Haces login y autorizas. La pestaña te dice que puedes volver al terminal.
4. De vuelta en /mcp, el servidor pasa a connected y aparece su número de tools.

Los tokens se guardan cifrados y se refrescan solos. Para revocar, elige "Clear authentication" en el mismo menú.

Si el navegador no se abre solo (típico en SSH o en un contenedor), Claude imprime la URL en el terminal: cópiala y ábrela a mano.

Cómo aparecen las tools

Las tools de un servidor MCP llegan con el nombre mcp__<servidor>__<tool>. Por ejemplo, el servidor github puede exponer mcp__github__create_issue. No las invocas tú por nombre: Claude las usa cuando la tarea lo pide, igual que sus tools internas.

Esto enlaza directo con el curso de permisos: puedes gobernarlas con reglas. mcp__github casa todas las tools de ese servidor; mcp__github__create_issue casa una concreta.

{ "permissions": { "allow": ["mcp__github__*"], "deny": ["mcp__github__delete_repo"] } }

Por qué a veces ves un paso ToolSearch

Por defecto, Claude Code no carga todas las tools de tus servidores al arrancar: difiere sus definiciones y las busca bajo demanda cuando la tarea las necesita (el tool search). Por eso, al pedir algo que toca un servidor, puede aparecer un paso ToolSearch antes de usar la tool. Solo entran en contexto las que de verdad usa, así que conectar muchos servidores casi no consume contexto — es lo que hace MCP escalable.

Desde tu lado, las tools funcionan igual. Si un servidor tiene tools que Claude necesita en cada turno y no quieres ese paso de búsqueda, márcalo con alwaysLoad para que se carguen al inicio:

{ "mcpServers": { "core-tools": { "type": "http", "url": "https://mcp.example.com/mcp", "alwaysLoad": true } } }

Úsalo con moderación: cada tool cargada de antemano ocupa contexto que pierdes para la conversación. Es justo lo contrario del comportamiento por defecto, que prioriza mantener la ventana libre.

Referenciar recursos con @

Además de tools, un servidor puede exponer recursos que referencias como ficheros, con @:

¿Puedes analizar @github:issue://123 y proponer un fix?

Escribe @ para ver los recursos disponibles en el autocompletado, junto a tus ficheros. Puedes mezclar varios en un prompt.

Prompts del servidor como comandos

Algunos servidores exponen prompts que aparecen como comandos, con el formato /mcp__<servidor>__<prompt>:

/mcp__github__pr_review 456

Pruébalo

Con tu servidor connected (y autenticado, si hizo falta), lánzale una tarea real que lo use:

(con el servidor de GitHub) "Enséñame los PRs abiertos asignados a mí." (con Sentry) "¿Cuáles son los errores más comunes de las últimas 24h?"

Si responde con datos reales —no con un "no tengo acceso a eso"—, está funcionando. Ese servidor usable es el artefacto del curso.

Si falla

Casi todo se diagnostica desde el propio /mcp. Los tres fallos más comunes y su causa real:

• Sale failed o needs auth → el token caducó o nunca te autenticaste. Repite el flujo OAuth; si el servidor usa API key/PAT por variable de entorno (curso anterior), revisa que la variable sigue puesta y la clave no ha expirado. Luego r para reconectar.
• Está connected pero la tool que esperas no aparece → no es la conexión, es el scope: tu token no tiene permiso para esa capacidad. Amplía los scopes en el proveedor (o en oauth.scopes, que ves en la siguiente lección) y reconecta.
• Claude no usa la tool aunque el servidor esté connected → revisa tus reglas de permisos: un deny que case mcp__servidor__* deja la tool existiendo pero bloqueada.

Y si @ no autocompleta ningún recurso de tu servidor: es normal, no todos los servidores publican resources —muchos solo exponen tools.

Qué llevas hasta aquí

• /mcp muestra estado y nº de tools; sabes leer connected / needs auth / failed y resolver cada uno.
• Es donde autenticas (OAuth) y reconectas (r) cuando algo falla.
• Las tools llegan como mcp__servidor__tool y se gobiernan con reglas de permisos (mcp__servidor__*).
• Referencias recursos con @servidor:... y ejecutas prompts como /mcp__servidor__prompt.

En la siguiente lección, gobernar el acceso a escala: managed MCP y seguridad.

Fuente oficial: Connect Claude Code to tools via MCP · Permissions