Claude Code

Claude Code meldet sich selbst bei Sallyport an: kein Token zum Kopieren, nichts vorher in der Konsole einzurichten. Ein Token aus der Konsole funktioniert ebenfalls, für eine Projektdatei, die über git geteilt wird.

Verbinden

• Führen Sie den Befehl unten in einem Terminal aus. --scope user fügt Sallyport jedem Projekt hinzu.
• Führen Sie claude mcp login sallyport aus, oder tippen Sie in Claude Code /mcp und wählen Sie sallyport. Ihr Browser öffnet Sallyport.
• Melden Sie sich an oder legen Sie ein Konto an, dann klicken Sie auf dem Zustimmungsbildschirm auf „Erlauben“. Dort steht „Nach dem Erlauben kehren Sie zu einer App auf diesem Computer zurück“: Diese App ist Claude Code.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp

„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

Claude Code nimmt auch einen Agent-Token im Header. Die Konsole schreibt Ihnen den ganzen Befehl, samt Token.

• Öffnen Sie in der Konsole Agenten, klicken Sie auf „Neuer Agent“, geben Sie einen Namen ein und klicken Sie auf „Agent erstellen“.
• Lassen Sie auf der Seite des Agenten unter „Diesen Agenten verbinden“ „Claude Code“ ausgewählt und klicken Sie auf „Für Claude Code kopieren“. Die Kopie enthält den Token, den Sie gerade auf dieser Seite erstellt haben, oder einen neuen.
• Führen Sie den kopierten Befehl im Terminal aus und starten Sie Claude Code neu. claude mcp list zeigt sallyport als verbunden.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp \
  --header "Authorization: Bearer YOUR_AGENT_TOKEN"

--scope user macht Sallyport in allen Projekten verfügbar und legt den Token in ~/.claude.json ab, außerhalb Ihrer Repositorys.

Ohne Terminal geht es so: Wählen Sie „In Claude einfügen“ und klicken Sie auf „Nachricht für Claude kopieren“. Fügen Sie die Nachricht in einen Chat von Claude Code ein, und Claude führt den Befehl selbst aus.

Nur Inhaber und Admins legen Agenten an. Ein neuer Agent startet mit allen Verbindungen seines Arbeitsbereichs, und seine Liste „Zugriff“ auf der Seite des Agenten ändert das.

Über eine Projektdatei teilen

Eine .mcp.json im Projekt landet mit dem Code in git. Claude Code ersetzt ${VAR} in ihren Headern, also nennt die Datei eine Variable, und jeder Entwickler hält den Token in seiner eigenen Umgebung.

{
  "mcpServers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${SP_AGENT_TOKEN}" }
    }
  }
}

Setzen Sie SP_AGENT_TOKEN in der Shell, die Claude Code startet. Die Option „.mcp.json“ der Konsole kopiert dieselbe Datei mit eingetragenem Token, und diese Fassung bleibt außerhalb von git.

Sitzungen unterscheiden

Viele Sitzungen von Claude Code können sich einen Token teilen. Klicken Sie unter „Jede Claude-Code-Sitzung kennzeichnen“ auf „Sitzungs-Hook für Claude kopieren“ und fügen Sie ihn in Claude Code ein. Jeder Aufruf zeigt dann Sitzung und Ordner, aus denen er kam.

Was der Agent sieht

stripe_read     Stripe API (api.stripe.com/v1), reading only. Key: stripe-live.
stripe_write    Stripe API (api.stripe.com/v1). Key: stripe-live. For reads use stripe_read.
http_request    For a host in your list use its own tool.
list_access     Every service you can reach, one short entry each.
get_call        The state of a call by call_id, at once.

Eine Verbindung zu einer Web-API liefert zwei Tools: _read zum Lesen und _write für alles andere. Ein Server, auf dem der Agent Befehle ausführt, liefert ein Tool _exec. Eine Datenbank liefert _query und _execute, und ein entfernter MCP-Server bringt seine eigenen Tools mit. Jede Beschreibung nennt den Schlüssel und sagt, was direkt durchläuft, also kennt der Agent seinen Zugriff vor dem ersten Aufruf.

Wenn ein Aufruf auf einen Menschen wartet

Standardmäßig laufen Aufrufe direkt durch. Ein Aufruf wartet dort, wo Sie „Bei jedem Aufruf fragen“ eingeschaltet oder eine Klasse auf „Freigabe erforderlich“ gestellt haben, beides unter „Zugriff“ des Agenten. Er wartet auch, wenn er ein Budget überschreitet, das Sie unter Limits gesetzt haben.

Solange die Karte offen ist, hält Sallyport den Aufruf bis zu 4 Minuten am Leben und meldet alle 10 Sekunden den Fortschritt. In einer interaktiven Sitzung schiebt Claude Code den Aufruf nach 2 Minuten in den Hintergrund und liefert die Antwort, sobald sie kommt.

Keine Antwort nach 4 Minuten? Der Agent erhält approve_url und call_id, zeigt Ihnen den Link und wiederholt den Aufruf mit dieser call_id, sobald Sie geantwortet haben. Der Dienst wird einmal aufgerufen. Die Karte bleibt standardmäßig eine Stunde offen. Wo Karten ankommen, steht unter Freigaben.

Lassen Sie MCP_TOOL_TIMEOUT und den timeout eines Servers leer oder setzen Sie sie über 240000. Ein kleinerer Wert beendet das Warten in Claude Code, und der Agent verliert Link und call_id.