Freigaben und Berechtigungen

Standardmäßig läuft jeder Aufruf direkt durch. Sie legen fest, wo ein Aufruf auf eine Person wartet: je Agent, Verbindung und Klasse.

Festlegen, welche Aufrufe auf Sie warten

Öffnen Sie Agenten und wählen Sie den Agenten. Seine Liste „Zugriff“ hat eine Zeile pro Verbindung.

• Schalten Sie „Bei jedem Aufruf fragen“ ein, um jeden Aufruf dieser Verbindung freizugeben.
• Oder stellen Sie die Spalten „Lesen“, „Schreiben“ und „Destruktiv“ einzeln ein. „Automatisch“ führt den Aufruf aus, „Freigabe erforderlich“ wartet auf eine Person, „Abgelehnt“ weist ihn ab.
• Setzen Sie „Code“, damit destruktive Aufrufe einen sechsstelligen Code aus dem Authenticator verlangen. Die Spalte erscheint, sobald Sie unter Einstellungen die „Authenticator-App“ einrichten.

Sallyport ordnet einen Aufruf nach seiner HTTP-Methode ein. GET, HEAD und OPTIONS lesen. POST, PUT und PATCH schreiben. DELETE und jede andere Methode gelten als destruktiv. Ein Lesezugriff wird zum Schreibzugriff, wenn ein Pfadsegment mit einem Wort wie send, run, exec, build, trigger, invoke oder webhook beginnt. Das Rezept eines Dienstes kann das für bekannte Aufrufe anpassen.

Ein Aufruf über ein von Ihnen gesetztes Budget hinaus wartet, siehe Limits.

Wo Sie die Karte erreicht

Die Karte geht an die Person, für die der Agent handelt, und an alle Inhaber und Administratoren. Die erste Antwort entscheidet. Die Kanäle stellen Sie unter Benachrichtigungen ein.

Jeder verbundene Kanal hat „Test senden“. Die Tabelle „Was Sie wo erreicht“ legt fest, welche Ereignisse an Browser, Telegram und E-Mail gehen. Für einen destruktiven Aufruf bietet Telegram nur Deny und einen Link zur Karte.

Die Karte beantworten

Die Karte zeigt, was gesendet wird, welcher Agent fragt und aus welchem Arbeitsbereich. „Details“ enthält die Regel, den Schlüssel, die Aufruf-ID, die Frist und die Worte des Agenten, als ungeprüft markiert. Die Karte zeigt jeden Teil der Anfrage bis 2 KiB. Ist ein Teil länger, sagt sie das über den Schaltflächen, und „Die ganze Anfrage zeigen“ lädt ihn vollständig. „Details“ zeigt auch einen Header, den der Agent an der Stelle des Schlüssels gesendet hat, mit seinem Wert; dieser Header geht nicht hinaus.

Auch die Freigabe eines destruktiven Aufrufs braucht einen Grund. Ist in dieser Zeile „Code“ gesetzt, fragt die Karte zusätzlich den sechsstelligen Code aus Ihrem Authenticator ab.

Eine Berechtigung aus der Karte gilt so lange wie „Längste Berechtigung (Sekunden)“ unter Einstellungen, „Organisation“: standardmäßig 24 Stunden. Sie deckt 200 Lesezugriffe, 20 Schreibzugriffe oder 1 destruktiven Aufruf. Approve for 1 hour in Telegram gibt 20 Aufrufe für eine Stunde frei. Berechtigungen prüfen und widerrufen Sie unter Berechtigungen, erreichbar über „Freigaben“; die Seite eines Agenten listet seine aktiven Berechtigungen.

Die Schaltfläche „ab jetzt“ erscheint nur, solange die Klasse auf „Freigabe erforderlich“ steht. Die Änderung landet in Regeländerungen, wo „Rückgängig machen“ sie zurücknimmt. Steht eine Klasse auf „Abgelehnt“, werden ihre Berechtigungen widerrufen.

Was der Agent während des Wartens sieht

Jede Warteantwort enthält eine call_id und eine approve_url. Eine Wiederholung mit derselben call_id setzt denselben Aufruf fort und startet nie einen zweiten.

• Ein MCP-Client, der ein Fortschritts-Token sendet, hält den Aufruf offen. Sallyport meldet alle 10 Sekunden den Fortschritt, bis zu 240 Sekunden lang.
• Ein Client ohne Fortschritts-Token wartet bis zu 45 Sekunden.
• Endet diese Wartezeit, erhält der Agent APPROVAL_PENDING mit call_id, approve_url, expires_at und poll_after_ms. Danach antwortet get_call sofort, und eine Wiederholung mit call_id wartet erneut.
• Ein Client mit MCP Tasks erhält eine Aufgabe zum Abfragen. Ein Client mit URL elicitation zeigt Ihnen approve_url und wiederholt den Aufruf selbst.
• Auf /p/ lautet die Antwort 202 mit X-Sallyport-Call-Id. Fragen Sie GET https://mcp.sallyport.cloud/p/calls/{call_id} ab: 202 während des Wartens, die Antwort des Dienstes nach der Freigabe, 403 nach einer Ablehnung, 410 nach Ablauf.

Eine Antwort erreicht den wartenden Aufruf sofort. Claude Code schiebt einen Aufruf, der länger als 2 Minuten wartet, in den Hintergrund und liefert das Ergebnis, sobald es da ist.

Wie lange eine Karte wartet

• Standardmäßig bleibt eine Karte 60 Minuten offen. „Freigabefenster (Sekunden)“ unter Einstellungen, „Organisation“, ändert das.
• Das Öffnen der vollständigen Karte fügt 5 Minuten hinzu, höchstens zweimal. Die Karte in der Ecke verlängert nichts.
• Erinnerungen gehen 2, 15 und 45 Minuten nach dem Öffnen der Karte hinaus. Eine Erinnerung, die nach der Frist läge, entfällt.
• Nach einer Ablehnung erhält der Agent APPROVAL_DENIED mit Ihrem Grund. Nichts wurde ausgeführt.
• Nach Ablauf erhält der Agent APPROVAL_EXPIRED. Nichts wurde ausgeführt; wird die Aktion noch gebraucht, wiederholt der Agent sie ohne call_id.

Viele Aufrufe auf einmal

• Gleiche Aufrufe desselben Agenten schließen sich der schon offenen Karte an, egal wie viel Zeit dazwischen liegt. Der Aufruf läuft einmal, und jede Kopie erhält sein Ergebnis.
• Ein Agent mit 20 offenen Karten, oder eine Organisation mit 100, erzeugt keine weiteren. Der Agent wird pausiert, eine Karte nennt den Grund, und „Agent fortsetzen“ auf seiner Seite startet ihn wieder.

Wenn dem Agenten ein Schlüssel fehlt

Eine Karte beantwortet einen Aufruf, der schon einen Schlüssel hat. Ein Aufruf an einen Dienst ohne Schlüssel öffnet eine Anfrage unter Schlüssel fehlt und gibt dem Agenten ihren Link.

Dasselbe geschieht bei einer pausierten Verbindung, einem stillgelegten Schlüssel oder einer abgelaufenen OAuth-Anmeldung. Fügen Sie den Schlüssel mit „Zugriff erteilen“ hinzu, und der Agent wiederholt seinen Aufruf. Siehe Schlüssel und Agenten.