MCP-Clients und Remote-Server

Die Adresse

Jeder MCP-Client verbindet sich per Streamable HTTP mit https://mcp.sallyport.cloud/mcp. Clients mit der MCP-Revision 2026-07-28 und mit früheren Revisionen funktionieren beide.

Die meisten Clients verbinden sich per Anmeldung: Sie tragen die Adresse ein, melden sich im Browser bei Sallyport an und klicken auf „Erlauben“. Kein Token zum Kopieren, nichts vorher in der Konsole einzurichten. Skripte und Clients ohne Anmeldung senden stattdessen einen Agent-Token im Header Authorization: Bearer.

Per Anmeldung verbinden

So verbinden sich Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI und MCP Inspector. Wohin die Adresse gehört, zeigt die Seite jedes Clients unter Integrationen.

• Tragen Sie https://mcp.sallyport.cloud/mcp in Ihrem Client als MCP-Server ein.
• Der Client registriert sich selbst bei Sallyport und öffnet es in Ihrem Browser.
• Melden Sie sich an oder legen Sie ein Konto an. Die Verbindung wartet 30 Minuten auf Sie, genug Zeit, um Ihre E-Mail zu bestätigen.
• Lesen Sie den Zustimmungsbildschirm „… einen Agenten verbinden lassen“ und klicken Sie auf „Erlauben“. Der Browser kehrt zum Client zurück, und der Client ist verbunden.

Der Zustimmungsbildschirm

„Wer fragt“ nennt den Client. Ein Client, den seine eigene Website ausweist, zeigt „Domain bestätigt“ mit dieser Domain, dazu „Herausgeber: Anthropic“ für claude.ai oder „Herausgeber: OpenAI“ für chatgpt.com. Ein Client, der sich selbst registriert hat, zeigt „Nicht geprüft“ und „Dieser Client hat sich selbst registriert. Sallyport konnte seinen Namen nicht prüfen.“

„Wohin es weitergeht“ sagt, wo Ihr Browser nach „Erlauben“ landet: auf einer Website, in einer App oder „Nach dem Erlauben kehren Sie zu einer App auf diesem Computer zurück“. Im letzten Fall warnt der Bildschirm: „Erlauben Sie nur, wenn Sie diese Verbindung gerade eben selbst aus einer App auf diesem Computer gestartet haben.“ Hat Ihnen jemand anderes den Link geschickt, klicken Sie auf „Ablehnen“.

„Was der Agent nutzen kann“ listet jeden Dienst mit „Läuft direkt“ oder „Fragt Sie zuerst“. Beim neuen Agenten eines Mitglieds steht dort „Noch nichts. Ein Administrator gibt diesem Agenten in der Konsole Dienste.“

Unter „Details“ stehen die Client-ID, die Weiterleitungsadresse und, bei mehreren Arbeitsbereichen, die Wahl des Arbeitsbereichs für den Agenten.

Was „Erlauben“ bewirkt

Sallyport legt einen Agenten mit dem Namen des Clients an. Der Agent eines Inhabers oder Administrators erhält jeden Dienst des Arbeitsbereichs. Der Agent eines Mitglieds startet ohne, bis ein Administrator sie unter „Zugriff“ auf der Seite des Agenten hinzufügt.

Verbindet ein Mensch einen Client zum ersten Mal, erhält jeder Inhaber eine Benachrichtigung mit einem Link, der ihn trennt. Das Journal hält jede Zustimmung fest.

Ein Client meldet sich in einer neuen Sitzung, über einen neuen Port oder beim Erneuern seines Zugangs erneut an. Solange der Agent aktiv ist, sehen Sie einen kurzen Bildschirm „Claude Code neu verbinden“ mit einer einzigen Schaltfläche „Neu verbinden“. Der Client erhält nichts, bis Sie darauf klicken. Die Inhaber werden nicht noch einmal benachrichtigt. Wurde der Agent pausiert, fragt der vollständige Zustimmungsbildschirm erneut. Wurde er gelöscht, ist die erneute Anmeldung eine neue Verbindung, und jeder Inhaber wird benachrichtigt.

Verbundene Apps

Einstellungen, Verbundene Apps listet jeden KI-Client, der sich angemeldet hat. Mitglieder sehen und trennen ihre eigenen. Inhaber und Administratoren sehen und trennen alle.

„Trennen“ beendet den Zugang des Clients: „Seine Aufrufe enden sofort, auf jedem Computer, von dem aus er sich angemeldet hat. Um ihn wieder zu nutzen, melden Sie sich in der App an und erlauben Sie ihn.“

Plattformen mit einem Agenten pro Maschine

Eine Plattform, die Agenten auf eigenen Maschinen betreibt, etwa detachbox, verbindet sich einmal. Ihr Zustimmungsbildschirm ist eine kurze Karte: wer fragt, wohin Sie zurückkehren, und drei Zeilen. detachbox kann für jede seiner Maschinen einen Agenten anlegen, Ihre Agenten sehen und sie in Chats aufnehmen. Umbenennen, pausieren oder löschen darf es nur die Agenten, die es selbst angelegt hat. Jeder neue Agent startet ohne Zugriff, und was jeder nutzen darf, wählen Sie. Die Verbindung selbst ist kein Agent und nutzt keinen Dienst, darum zeigt die Karte keine.

Jede Maschine bekommt ihren eigenen Agenten, damit Aktivität und Freigaben zeigen, welche Maschine aufgerufen hat. Der Agent einer neuen Maschine kann nichts nutzen. detachbox schickt Sie auf seine Seite, Sie wählen seine Dienste oder kopieren den Zugriff eines anderen Agenten, und „Fertig“ bringt Sie zurück. Verbundene Apps zeigt, wie viele Agenten die App verwaltet, jeden mit seiner Maschine. Pausieren Sie einen Agenten, stoppt eine Maschine. „Trennen“ stoppt sie alle, und beim erneuten Verbinden kommen sie mit ihrem Zugriff zurück. Alle Maschinen einer Verbindung zählen in jedem Tarif als ein Agent.

Agent-Token holen

Ein Token passt zu einem Skript, einer Projektdatei in Git oder einem Client ohne Anmeldung. Öffnen Sie den Agenten unter Agenten. „Diesen Agenten verbinden“ kopiert eine fertige Einrichtung für Claude Code, Cursor oder eine .mcp.json im Projekt. Sie enthält den Token, den Sie gerade mit „Neuer Token“ erstellt haben, oder einen neuen.

Für einen anderen Client klicken Sie unter „Token“ auf „Neuer Token“ und kopieren ihn: Er wird nur einmal angezeigt. Der Token steht für den Agenten und seinen Zugriff. Er enthält keinen Dienstschlüssel.

Die Papierkorb-Schaltfläche neben einem Token widerruft ihn. „Erlaubte IP-Adressen (optional)“ unter „Limits“ beschränkt, von wo die Token des Agenten funktionieren.

Claude Code mit Token

Klicken Sie auf „Für Claude Code kopieren“ und führen Sie den Befehl in einem Terminal aus. --scope user fügt Sallyport jedem Projekt hinzu. Prüfen Sie mit claude mcp list und starten Sie Claude Code neu.

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"

„In Claude einfügen“ liefert stattdessen eine Nachricht. Klicken Sie auf „Nachricht für Claude kopieren“, fügen Sie sie in einen Claude-Code-Chat ein, und Claude führt den Befehl selbst aus.

„Jede Claude-Code-Sitzung kennzeichnen“ ist optional. Klicken Sie auf „Sitzungs-Hook für Claude kopieren“ und fügen Sie ihn in Claude Code ein. Jeder Aufruf zeigt dann, aus welcher Sitzung und welchem Ordner er kam.

Cursor und die .mcp.json eines Projekts

„Für Cursor kopieren“ liefert dies für ~/.cursor/mcp.json, mit eingesetztem Token:

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

„.mcp.json kopieren“ liefert dasselbe mit "type": "http" für die .mcp.json eines Projekts in Claude Code. Diese Datei enthält den Token, also gehört sie nicht in Git.

Codex CLI, Gemini CLI und VS Code mit Token

Diese Clients richten Sie von Hand mit derselben Adresse und demselben Token ein.

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

Codex liest den Token aus SP_AGENT_TOKEN in der Umgebung, aus der es gestartet wird. Sallyport hält einen Aufruf, der auf eine Freigabe wartet, höchstens 240 Sekunden offen. Mit tool_timeout_sec = 300 wartet Codex diese Zeit ab; standardmäßig wartet es 60 Sekunden.

{
  "mcpServers": {
    "sallyport": {
      "httpUrl": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

{
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

Gemini CLI erwartet die Adresse in httpUrl. VS Code öffnet seine Datei mit „MCP: Open User Configuration“. Ersetzen Sie <agent-token> und halten Sie diese Dateien aus Repositorys heraus.

Was der Agent sieht

Jeder Dienst kommt als Tools mit seinem Namen an. Ein HTTP-Dienst hat zwei: github_read nimmt nur Lesezugriffe, github_write nimmt jeden Aufruf. Beide nehmen method und den vollständigen path aus der API-Dokumentation des Dienstes:

{
  "method": "GET",
  "path": "/user"
}

Eine Datenbank bekommt die Tools _query und _execute, ein SSH-Host _exec für Befehle sowie _sftp_read und _sftp_write für seine Dateien. Ein Postfach bekommt _read, _send und _change. Die Tools eines Remote-MCP-Servers behalten ihre Namen hinter dem Namen der Verbindung. Jeder Agent hat außerdem die eingebauten Tools:

Ein Aufruf, der auf eine Person wartet, sagt es dem Client sofort, wenn der Client ein progressToken gesendet hat. Diese Fortschrittsmeldung und jede spätere des Aufrufs trägt _meta mit sallyport.cloud/call_id und sallyport.cloud/approve_url. Der Link zur Freigabe steht auch im Meldungstext, also kann jeder Client ihn zeigen.

Remote-MCP-Server verbinden

Öffnen Sie Remote-MCP. Geben Sie die „URL des MCP-Servers“ ein: die vollständige HTTPS-Adresse mit Pfad, und mit Port, wenn er vom Standard abweicht, etwa https://mcp.example.com/mcp.

Wählen Sie die „Authentifizierung“: „Ohne Authentifizierung“, „Bearer-Token“, „Basic“, „API-Schlüssel“ in einem Header oder Query-Parameter oder „OAuth 2.1“. Klicken Sie auf „Schlüssel speichern und verbinden“.

Alle Agenten des Arbeitsbereichs erhalten die Tools des Servers. Sallyport verbindet sich mit dem Server, fügt seinen Schlüssel hinzu und gibt die Ergebnisse zurück. Der Agent bleibt nur mit https://mcp.sallyport.cloud/mcp verbunden.

Mit OAuth 2.1 am Server anmelden

Mit „OAuth 2.1“ öffnet das Speichern die Anmeldeseite des Servers und bringt Sie danach zur Verbindung zurück. Sallyport verwahrt die Token und erneuert sie.

Bei Servern, die es erlauben, registriert sich Sallyport selbst. Für alle anderen registrieren Sie eine App mit der Redirect-URI https://mcp.sallyport.cloud/callback/upstream. Tragen Sie ihre ID unter „Client-ID der Anwendung (optional)“ ein, und ihr Secret, falls vorhanden.

Wenn der Zugang abläuft, klicken Sie auf der Seite der Verbindung auf „Mit OAuth neu verbinden“.