Saltar al contenido principal

Conectar Claude Desktop

Claude Desktop soporta MCP servers vía configuración local. Esta guía conecta tu deployment Whet en menos de un minuto.

Pre-requisitos​

  • Claude Desktop instalado (descarga).
  • Tu deployment Whet corriendo, accesible vía HTTPS o http://localhost.
  • Un agent token (de Settings → Agent tokens en la UI, o el mismo que usás con el CLI).

Editar el config​

El archivo vive en:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Si no existe, creálo. Si ya tenés otros MCP servers configurados, agregá la entry whet dentro de mcpServers.

{
  "mcpServers": {
    "whet": {
      "url": "https://your.vps/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

Para dev local​

Si corrés Whet con bench-up.sh:

{
  "mcpServers": {
    "whet": {
      "url": "http://localhost:3000/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

Reiniciar Claude Desktop​

Después de guardar el config, salí completamente de Claude Desktop (en macOS: Cmd+Q, no solo cerrar la ventana) y volvé a abrirlo. Las MCP connections se inicializan en boot.

Verificar la conexión​

  1. Abrí una conversación nueva.
  2. Mirá el indicador de tools en la barra de input — deberías ver el ícono con un contador (cerca de 35 tools, 2 prompts, 2 resources disponibles — ver Tools disponibles para el desglose entre core / sessions / dashboards).
  3. Probá un prompt mínimo:

Pedile al MCP de Whet que lea el inbox del pipeline pp_a1b2c3.

Si responde con la lista de artifacts, todo está conectado.

Troubleshooting​

No aparece el ícono de tools — el config tiene un error de JSON. Pegalo en un validator (jq o web) antes de guardar.

401 unauthorized — token expirado o revocado. Generá uno nuevo y actualizalo en el config.

fetch failed / ECONNREFUSED — la URL del MCP no responde. Si es local, confirmá que bench-up.sh está corriendo. Si es prod, chequeá que el dominio resuelve y el certificado es válido.

Claude Desktop dice "tool requires confirmation" — eso es deseado. Cada tool del MCP de Whet tiene su propia política de confirmación según el riesgo. Las acciones de publicación siempre piden confirmación explícita.

Siguiente paso​