Braucht der Agent meinen SSH-Schlüssel?

Nein. TermCraft verbindet sich mit dem Schlüssel aus deinem Schlüsselbund. Der Agent sieht ihn nie.

Können andere Apps auf meinem Mac den Server erreichen?

Nur mit dem Zugriffstoken. Der Server lauscht auf 127.0.0.1 und lehnt Anfragen ohne Token ab.

Claude Code, Cursor oder Codex mit TermCraft verbinden

1. MCP-Server einschalten

Öffne die Einstellungen, geh zu „KI-Agenten“ und schalte den Agenten-Zugriff ein. Der Server lauscht auf http://127.0.0.1:47823/mcp und nimmt nur Anfragen mit deinem Zugriffstoken an. Dort änderst du auch den Port oder erzeugst ein neues Token; Agenten mit dem alten Token verlieren sofort den Zugriff.

TermCraft zeigt diese Snippets auch mit deinem echten Token zum Kopieren an.

2. TermCraft im Agenten eintragen

Claude Code

Im Terminal ausführen:

claude mcp add --transport http termcraft http://127.0.0.1:47823/mcp --header "Authorization: Bearer <token>"

Cursor

In ~/.cursor/mcp.json unter mcpServers einfügen:

"termcraft": {
  "url": "http://127.0.0.1:47823/mcp",
  "headers": { "Authorization": "Bearer <token>" }
}

VS Code

In .vscode/mcp.json einfügen. VS Code fragt beim ersten Start nach dem Token, so landet es nicht in einer Datei, die du vielleicht committest:

{
  "inputs": [
    { "type": "promptString", "id": "termcraft-token", "description": "TermCraft access token", "password": true }
  ],
  "servers": {
    "termcraft": {
      "type": "http",
      "url": "http://127.0.0.1:47823/mcp",
      "headers": { "Authorization": "Bearer ${input:termcraft-token}" }
    }
  }
}

Codex CLI

In ~/.codex/config.toml einfügen. Codex wartet standardmäßig nur 60 Sekunden auf ein Werkzeug, eine Freigabe kann bis zu zwei Minuten dauern. Deshalb hebt das Beispiel die Grenze an:

[mcp_servers.termcraft]
url = "http://127.0.0.1:47823/mcp"
http_headers = { "Authorization" = "Bearer <token>" }
tool_timeout_sec = 300

Claude Desktop

In claude_desktop_config.json unter mcpServers einfügen (braucht Node.js):

"termcraft": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "http://127.0.0.1:47823/mcp", "--header", "Authorization: Bearer <token>"]
}

3. Festlegen, was der Agent darf

Kein Zugriff: Der Agent sieht den Host nicht.
Mit Freigabe: Der Agent schlägt Befehle vor, und du führst jeden im Terminal des Hosts aus oder lehnst ihn ab. Einem Agenten kannst du 10 Minuten erlauben.
Vollzugriff: Befehle laufen ohne Rückfrage und werden protokolliert.

Produktions-Hosts und gefährliche Befehle warten unabhängig von der Stufe immer auf deine Freigabe mit Touch ID oder dem Mac-Passwort. ⌥⌘. pausiert alle Agenten auf einmal.

Was der Agent aufrufen kann

Werkzeug	Was es tut
`list_hosts`, `get_host`	Hosts, die der Agent sehen darf, mit Adresse, Umgebung und Agenten-Zugriff. Hosts mit „Kein Zugriff“ tauchen nicht auf.
`run_command`, `run_snippet`	Führt einen Befehl oder ein gespeichertes Snippet per SSH aus und gibt Exit-Code, stdout und stderr zurück. Der Agent gibt eine kurze Begründung mit, die du in der Anfrage siehst.
`open_session`	Öffnet in TermCraft eine Sitzung, in der du selbst arbeitest.
`list_snippets`, `list_groups`, `list_keys`	Listen zum Lesen. SSH-Schlüssel erscheinen mit Name, Typ und Fingerabdruck, nie mit dem privaten Teil.
`create_host`, `update_host`, `delete_host`, `create_snippet`, `generate_key`	Änderungen an deiner Bibliothek. Standardmäßig wartet jede auf deine Freigabe.

Was der Agent nie bekommt

Passwörter, private Schlüssel, Passphrasen und das Zugriffstoken bleiben im Schlüsselbund von macOS. TermCraft baut die SSH-Verbindung selbst auf. Der Agent schickt nur einen Befehl und bekommt Exit-Code, stdout und stderr zurück (bis 256 KB je Ausgabe). Hosts mit „Kein Zugriff“ und Jump-Hosts mit „Kein Zugriff“ bleiben unsichtbar.

Deinen Agenten mit TermCraft verbinden