Codex CLI

Codex CLI meldet sich selbst bei Sallyport an und hält seine MCP-Server in ~/.codex/config.toml.

Verbinden

• Führen Sie codex mcp add sallyport --url https://mcp.sallyport.cloud/mcp aus.
• Führen Sie codex mcp login sallyport aus. Ihr Browser öffnet Sallyport.
• Melden Sie sich an oder legen Sie ein Konto an, dann klicken Sie auf dem Zustimmungsbildschirm auf „Erlauben“.
• Ergänzen Sie den Eintrag um tool_timeout_sec = 300, wie unten.

[mcp_servers.sallyport]
url = "https://mcp.sallyport.cloud/mcp"
tool_timeout_sec = 300

„Erlauben“ legt einen Agenten mit dem Namen des Clients an. Der Agent eines Inhabers oder Admins startet mit allen Verbindungen des Arbeitsbereichs. Der eines Mitglieds startet ohne, und ein Admin fügt sie unter „Zugriff“ hinzu. Eine spätere Anmeldung kostet einen Klick auf „Neu verbinden“.

Mit Token verbinden

Auf einem Rechner, an dem sich niemand anmeldet, nimmt Codex einen Bearer-Token aus einer Umgebungsvariable, die Datei enthält also kein Geheimnis.

• Öffnen Sie in der Konsole Agenten, klicken Sie auf „Neuer Agent“, geben Sie einen Namen ein und klicken Sie auf „Agent erstellen“.
• Klicken Sie auf der Seite des Agenten unter „Token“ auf „Neuer Token“ und kopieren Sie ihn. Er wird nur einmal angezeigt.
• Legen Sie den Token in SP_AGENT_TOKEN in der Umgebung ab, die Codex startet, und ergänzen Sie den Eintrag unten in ~/.codex/config.toml.

[mcp_servers.sallyport]
url = "https://mcp.sallyport.cloud/mcp"
bearer_token_env_var = "SP_AGENT_TOKEN"
tool_timeout_sec = 300

bearer_token_env_var enthält den Namen der Variable, nie den Token. codex mcp add sallyport --url https://mcp.sallyport.cloud/mcp --bearer-token-env-var SP_AGENT_TOKEN schreibt die ersten drei Zeilen für Sie.

Warum tool_timeout_sec 300 ist

Standardmäßig wartet Codex 60 Sekunden auf ein Tool. Sallyport hält einen Aufruf, der auf einen Menschen wartet, höchstens 4 Minuten. Mit 300 wartet Codex länger, als Sallyport den Aufruf je hält.

Wenn ein Aufruf auf einen Menschen wartet

Standardmäßig läuft ein Push, ein Release oder ein Deployment direkt durch. Es wartet, wenn Sie für diese Verbindung „Bei jedem Aufruf fragen“ eingeschaltet, eine Klasse auf „Freigabe erforderlich“ gestellt oder ein Budget gesetzt haben. Ein wartender Aufruf kommt mit approve_url und call_id zurück.

Beantworten Sie die Karte und sagen Sie Codex, es soll weitermachen. Es wiederholt den Aufruf mit derselben call_id, der Dienst wird also einmal aufgerufen. Für eine lange Sitzung kann die Karte diese Art Aufruf für eine Zeit und eine Anzahl Aufrufe freigeben.