Primeros pasos

Antes de esto necesitas el cliente instalado en tu máquina (Instalación) y el agente en la otra (Kit del servidor).

1. Arranca el agente en la otra máquina

Doble clic en el .bat que toque del kit. El agente imprime una línea como esta y ya la deja copiada en el portapapeles:

La línea golem_connect que imprime el agente

golem_connect https://192.168.1.40:8797 nSbK7q…  A1B2C3…

Si quien la arranca es tu cliente, basta con que te la pegue en un correo o un mensaje, igual que hoy te manda un ID de AnyDesk.

2. Pega la línea en el chat

Abre Claude (si estaba abierto, reinícialo, para que lea la configuración nueva) y pega esa línea en el chat. Entera, tal cual.

3. Llama al agente

Ya está. Y a partir de aquí depende de qué Claude estés usando, porque no todos refrescan la lista de herramientas después de conectar:

Dónde	Qué pasa	Cómo se llama al agente
Claude Desktop	Refresca el catálogo: aparecen las tools con el prefijo `vps__`	Directamente: `vps__run_powershell`, `vps__screenshot`…
Claude Code	No refresca el catálogo: esas tools no van a aparecer	Con `golem_call`, que es el camino normal aquí y no un apaño

En Claude Code, golem_tools te dice qué tiene el agente (con sus esquemas) y golem_call lo llama por su nombre remoto, sin prefijo:

Llamar a una tool del agente con golem_call

golem_call  tool = "run_powershell"
            arguments = { "script": "Get-Service W3SVC" }

Devuelve exactamente lo mismo que la llamada directa, imágenes incluidas. Para desconectar, golem_disconnect. Para ver qué hay conectado, golem_status, que nunca devuelve ningún token.

Cosas que conviene saber

El token cambia en cada arranque del agente. Si el agente se reinició, pega la línea nueva sin desconectar antes: Golem ve que la conexión de antes está muerta, la sustituye y te lo dice (replaced_dead). Pegar dos veces la misma línea tampoco es un error: la reusa.
Si te dice alias_en_uso, hay otra conexión viva de verdad con ese alias, a otro agente, y probablemente otra sesión trabajando con ella. El mensaje dice a qué máquina está conectada. Usa otro alias, o golem_disconnect si sabes que ya no le sirve a nadie.
El agente se apaga solo a los 30 minutos sin peticiones. Es a propósito: no se queda un puerto abierto en la máquina de nadie porque alguien se olvidó.
Puedes conectar a varias máquinas a la vez, cada una con su alias: golem_connect <línea> alias=otro publica otro__run_powershell. En modo evaluación, una conexión viva a la vez.
Varios ficheros de golpe: golem_push paths = ["C:\\a\\uno.dbf", "C:\\b\\dos.dll"] remote_path = "C:\\destino". Rutas absolutas siempre, y cada uno cae en el destino con su nombre.
Solo las tablas de una carpeta: golem_pull remote_path = "…" local_path = "…" include = ["*.dbf", "*.cdx"]. include se escribe igual que exclude y se aplica antes que él.

Si algo no va

Lo que ves	Qué es
Claude no tiene ninguna tool `golem_*`	No leyó la configuración: ciérralo del todo y ábrelo otra vez
`golem_connect` dice que no puede conectar	El agente no está arrancado, o el cortafuegos de la otra máquina no deja pasar ese puerto
«el certificado no es de confianza»	El agente genera el suyo en cada arranque. La huella va en la línea que pegas: si no la pegaste entera, pégala otra vez
Instalé y sigue sin aparecer	Comprueba que existe `%LOCALAPPDATA%\Golem\golem-client.exe`. Si no está, el antivirus se lo llevó
`tope_de_evaluacion` al llamar a una tool que actúa, o al conectar al segundo host	No es un fallo: es el tope de la evaluación. Las tools que actúan piden licencia, y sin ella hay una conexión viva a la vez: suelta la que tienes con `golem_disconnect`, o compra una licencia

Transferencias grandes

golem_push y golem_pull se paran solos a los 30 segundos y devuelven done: false con un resume: se vuelve a llamar igual añadiendo ese resume, tantas veces como haga falta, hasta que done sea true. Una carpeta de 305 MB son tres vueltas.

Treinta segundos es bajo a propósito: lo que corta una llamada larga es la paciencia de tu cliente MCP, que Golem no puede conocer. Si sabes que el tuyo aguanta más, súbelo con la variable de entorno GOLEM_MAX_CALL_SECONDS (de 1 a 240) en el bloque env que arranca el cliente:

Entrada golem con GOLEM_MAX_CALL_SECONDS en el bloque env

{
  "mcpServers": {
    "golem": {
      "command": "C:\\Users\\<tu usuario>\\AppData\\Local\\Golem\\golem-client.exe",
      "args": [
        "proxy"
      ],
      "env": {
        "GOLEM_MAX_CALL_SECONDS": "120"
      }
    }
  }
}

Un valor fuera de rango o mal escrito se ignora y se sigue con 30. Y lo más cómodo no es escribir la entrada entera: el instalador ya dejó una golem en la configuración de tu cliente, con la ruta puesta, y basta con añadirle el bloque env.