Prompteo

Unidad 4 · 1 min

Conectarlo en Claude Code

Agregar el servidor con claude mcp add, elegir el alcance correcto y gestionarlo desde la terminal.

Conectarlo en Claude Code

Un servidor que nadie enchufa no sirve. En Claude Code se agrega con claude mcp add, con una forma por transporte.

stdio

claude mcp add [options] <name> -- <command> [args...]

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

El -- separa las opciones de Claude Code del comando que arranca el servidor: todo lo que va después se pasa tal cual. Sin el --, Claude Code intentaría interpretar los flags del servidor como propios.

HTTP y SSE

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

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

claude mcp add --transport sse asana https://mcp.asana.com/sse

Alcances

Con -s o --scope:

  • local (por defecto): solo para vos, en el proyecto actual.
  • project: compartido con todo el equipo mediante el archivo .mcp.json.
  • user: para vos, en todos tus proyectos.

Gestionar

claude mcp list (muestra el estado: ✔ Connected, ! Needs authentication, ✘ Failed to connect), claude mcp get <name>, claude mcp remove <name>, y /mcp dentro de la sesión.

Antes de conectar

La documentación es explícita: verifica que confías en cada servidor. Un servidor que trae contenido externo te expone a riesgo de inyección de prompts.