Zur Dokumentation springen
DokumentationSchnellstart

Verbinden Sie Ihren ersten Agenten

Registrieren Sie sich, speichern Sie einen Dienstschlüssel, verbinden Sie Ihren Agenten per MCP, starten Sie seinen ersten Aufruf und beantworten Sie seine erste Freigabe.

Auf dieser Seite

1. Konto anlegen

Öffnen Sie my.sallyport.cloud. Klicken Sie auf „Weiter mit Google“, oder registrieren Sie sich per E-Mail: Klicken Sie auf „Weiter mit E-Mail“, geben Sie Ihre E-Mail ein und klicken Sie auf „Weiter“. Bei einer neuen E-Mail füllen Sie „Vorname“, „Nachname“ und „Passwort“ aus und klicken auf „Konto erstellen“. Geben Sie danach den 6-stelligen Code aus der Nachricht ein und klicken Sie auf „E-Mail bestätigen“.

Wer sich registriert, besitzt die Organisation und ihren ersten Arbeitsbereich. Schlüssel und Agenten hinzufügen können Inhaber und Administratoren.

2. Dienstschlüssel speichern

Öffnen Sie Schlüssel hinzufügen. Diese Anleitung nutzt GitHub: Tippen Sie es in „Dienst aus dem Katalog“ und wählen Sie GitHub API. Lassen Sie unter „Umgebung“ die Option „Live“ stehen.

Wählen Sie unter „So verbinden Sie GitHub API“ die Option „Zugriffstoken“. Klicken Sie auf „Schlüssel bei GitHub API erstellen“, erstellen Sie auf GitHub einen Token und fügen Sie ihn ein. Klicken Sie auf „Schlüssel speichern“.

Sallyport prüft den Token beim Speichern bei GitHub. Ab dann können alle Agenten des Arbeitsbereichs den Schlüssel nutzen. Der andere Weg, „Mit GitHub anmelden“, schickt Sie zur Freigabe zu GitHub; das Formular zeigt, was dafür nötig ist.

3. Agenten anlegen

Öffnen Sie Agenten und klicken Sie auf „Neuer Agent“. Geben Sie einen „Name“ ein, etwa laptop-claude, und klicken Sie auf „Agent erstellen“. Die Seite des Agenten öffnet sich.

Seine Liste „Zugriff“ enthält den GitHub-Schlüssel bereits. Neue Zeilen führen jeden Aufruf ohne Rückfrage aus.

4. Claude Code verbinden

Auf der Seite des Agenten ist unter „Diesen Agenten verbinden“ Claude Code ausgewählt. Klicken Sie auf „Für Claude Code kopieren“. Sallyport erstellt einen Token und kopiert den ganzen Befehl mit ihm.

Shell · derselbe Befehl, von Hand getippt
export SP_AGENT_TOKEN='<agent-token>'
claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp --header "Authorization: Bearer $SP_AGENT_TOKEN"

Führen Sie ihn in einem Terminal aus und starten Sie Claude Code neu. Der kopierte Befehl enthält den Token selbst; das Beispiel oben liest ihn aus SP_AGENT_TOKEN. Danach zeigt claude mcp list den Eintrag sallyport.

Der Token wird nur einmal angezeigt und steht unter „Token“ auf der Seite des Agenten. Für Cursor, Codex, Claude, ChatGPT und andere Clients siehe MCP-Clients und Remote-Server.

5. Ersten Aufruf starten

Bitten Sie den Agenten: „Lies mein GitHub-Profil über Sallyport.“ Er findet GitHub unter seinen Tools und ruft github_read mit diesen Argumenten auf:

JSON · Argumente für github_read
{
  "method": "GET",
  "path": "/user"
}

Sallyport fügt den Token hinzu, ruft api.github.com auf und gibt die Antwort von GitHub zurück. Der Agent sieht den Token nie. Aufruf und Ergebnis erscheinen unter Aktivität.

6. Erste Freigabe beantworten

Aufrufe laufen ohne Rückfrage, bis Sie es anders festlegen. Schalten Sie auf der Seite des Agenten in der Liste „Zugriff“ in der GitHub-Zeile „Bei jedem Aufruf fragen“ ein.

Bitten Sie den Agenten, das Profil noch einmal zu lesen. Der Aufruf wartet, und seine Karte erscheint unter Freigaben und auf jeder offenen Seite der Konsole. Dauert das Warten länger, zeigt Ihnen der Agent den Link zur Karte.

Klicken Sie auf „Freigeben“: Der Aufruf läuft, und der Agent bekommt die Antwort. „Ablehnen“ stoppt ihn, und der Agent liest den Grund, den Sie angeben. Karten können auch in diesem Browser, in Telegram oder per E-Mail ankommen: Schalten Sie das unter Benachrichtigungen ein. Mehr unter Freigaben.

Ohne Schlüssel fragt der Agent danach

Ein Agent kann einen öffentlichen Dienst erreichen, den Sie noch nicht verbunden haben. Er ruft http_request mit der vollständigen URL auf oder request_access mit dem Namen des Dienstes und einem purpose: einem Satz dazu, wofür er den Dienst braucht. Sallyport antwortet mit einem Link für Sie.

JSON · Argumente für http_request
{
  "method": "GET",
  "url": "https://api.stripe.com/v1/balance"
}

Der Link öffnet die Anfrage unter Schlüssel fehlt. Fügen Sie den Schlüssel hinzu oder melden Sie sich an und klicken Sie auf „Zugriff erteilen“. Alle Agenten des Arbeitsbereichs erhalten den Schlüssel, und der Agent wiederholt seinen Aufruf.