Erste Schritte
Vorher brauchen Sie den Client auf Ihrem Rechner (Installation) und den Agenten auf dem anderen (Server-Kit).
1. Den Agenten auf dem anderen Rechner starten
Doppelklick auf die passende .bat aus dem Kit. Der Agent gibt eine Zeile wie diese aus und hat sie bereits in die Zwischenablage kopiert:
golem_connect https://192.168.1.40:8797 nSbK7q… A1B2C3…Startet ihn Ihr Kunde, genügt es, wenn er sie Ihnen per E-Mail oder Nachricht schickt, so wie er Ihnen heute eine AnyDesk-ID schickt.
2. Die Zeile in den Chat einfügen
Öffnen Sie Claude (war es geöffnet, starten Sie es neu, damit es die neue Konfiguration liest) und fügen Sie die Zeile in den Chat ein. Vollständig, genau so.
3. Den Agenten aufrufen
Das war's. Und ab hier hängt es davon ab, welches Claude Sie verwenden, denn nicht alle aktualisieren die Tool-Liste nach dem Verbinden:
| Wo | Was passiert | Wie der Agent aufgerufen wird |
|---|---|---|
| Claude Desktop | Aktualisiert den Katalog: Die Tools erscheinen mit dem Präfix vps__ | Direkt: vps__run_powershell, vps__screenshot… |
| Claude Code | Aktualisiert den Katalog nicht: Diese Tools werden nicht erscheinen | Mit golem_call: hier der normale Weg und kein Notbehelf |
In Claude Code sagt Ihnen golem_tools, was der Agent hat (mit Schemas), und golem_call ruft es beim entfernten Namen auf, ohne Präfix:
golem_call tool = "run_powershell"
arguments = { "script": "Get-Service W3SVC" }Das Ergebnis ist genau dasselbe wie beim direkten Aufruf, Bilder eingeschlossen. Zum Trennen golem_disconnect. Um zu sehen, was verbunden ist, golem_status, das nie ein Token zurückgibt.
Gut zu wissen
- Das Token ändert sich bei jedem Start des Agenten. Wurde der Agent neu gestartet, fügen Sie die neue Zeile ein, ohne vorher zu trennen: Golem erkennt, dass die alte Verbindung tot ist, ersetzt sie und sagt es Ihnen (
replaced_dead). Dieselbe Zeile zweimal einzufügen ist auch kein Fehler: Sie wird wiederverwendet. - Meldet es
alias_en_uso, gibt es wirklich eine andere aktive Verbindung mit diesem Alias, zu einem anderen Agenten, und wahrscheinlich eine andere Sitzung, die damit arbeitet. Die Meldung sagt, mit welchem Rechner. Verwenden Sie einen anderen Alias, odergolem_disconnect, wenn Sie wissen, dass sie niemand mehr braucht. - Der Agent beendet sich selbst nach 30 Minuten ohne Anfragen. Das ist Absicht: Auf niemandes Rechner bleibt ein Port offen, weil jemand es vergessen hat.
- Sie können sich mit mehreren Rechnern gleichzeitig verbinden, jeder mit seinem Alias:
golem_connect <Zeile> alias=andererveröffentlichtanderer__run_powershell. Im Evaluierungsmodus eine aktive Verbindung gleichzeitig. - Mehrere Dateien auf einmal:
golem_push paths = ["C:\\a\\eins.dbf", "C:\\b\\zwei.dll"] remote_path = "C:\\ziel". Immer absolute Pfade, und jede landet mit ihrem Namen im Ziel. - Nur die Tabellen eines Ordners:
golem_pull remote_path = "…" local_path = "…" include = ["*.dbf", "*.cdx"].includewird wieexcludegeschrieben und vor diesem angewendet.
Wenn etwas nicht funktioniert
| Was Sie sehen | Was es ist |
|---|---|
Claude hat kein golem_*-Tool | Es hat die Konfiguration nicht gelesen: vollständig schließen und erneut öffnen |
golem_connect kann keine Verbindung herstellen | Der Agent läuft nicht, oder die Firewall des anderen Rechners lässt diesen Port nicht durch |
| „Das Zertifikat ist nicht vertrauenswürdig“ | Der Agent erzeugt bei jedem Start sein eigenes. Der Fingerabdruck steht in der eingefügten Zeile: Wurde sie nicht vollständig eingefügt, fügen Sie sie erneut ein |
| Installiert, erscheint aber immer noch nicht | Prüfen Sie, ob %LOCALAPPDATA%\Golem\golem-client.exe existiert. Fehlt sie, hat der Virenscanner sie entfernt |
tope_de_evaluacion beim Aufruf eines eingreifenden Tools oder beim Verbinden mit dem zweiten Host | Kein Fehler: das ist die Grenze der Evaluierung. Eingreifende Tools brauchen eine Lizenz, und ohne sie gibt es eine aktive Verbindung gleichzeitig: Trennen Sie die bestehende mit golem_disconnect, oder kaufen Sie eine Lizenz |
Große Übertragungen
golem_push und golem_pull halten nach 30 Sekunden von selbst an und liefern done: false mit einem resume: Rufen Sie sie mit diesem resume erneut auf, so oft wie nötig, bis done true ist. Ein Ordner mit 305 MB sind drei Runden.
Dreißig Sekunden sind absichtlich knapp: Was einen langen Aufruf abbricht, ist die Geduld Ihres MCP-Clients, die Golem nicht kennen kann. Wissen Sie, dass Ihrer länger wartet, erhöhen Sie den Wert mit der Umgebungsvariable GOLEM_MAX_CALL_SECONDS (1 bis 240) im env-Block, der den Client startet:
{
"mcpServers": {
"golem": {
"command": "C:\\Users\\<tu usuario>\\AppData\\Local\\Golem\\golem-client.exe",
"args": [
"proxy"
],
"env": {
"GOLEM_MAX_CALL_SECONDS": "120"
}
}
}
}Ein Wert außerhalb des Bereichs oder ein Tippfehler wird ignoriert, und es bleibt bei 30. Und am bequemsten ist es, nicht den ganzen Eintrag zu schreiben: der Installer hat in der Konfiguration Ihres Clients bereits einen Eintrag golem mit dem richtigen Pfad hinterlassen, dem Sie nur den env-Block hinzufügen.