S3-Speicher
Verbinden Sie einen Bucket von Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces, Google Cloud Storage oder eines beliebigen S3-kompatiblen Speichers. Agenten listen, lesen, schreiben und löschen seine Objekte; der geheime Schlüssel bleibt bei Sallyport.
Auf dieser Seite
Der Agent nennt ein Objekt. Sallyport signiert die Anfrage mit AWS Signature V4, schickt sie an Ihren Bucket und gibt die Antwort zurück. Der Agent sieht weder den Zugriffsschlüssel noch sein Geheimnis.
Einen Bucket verbinden
- Öffnen Sie Schlüssel hinzufügen und wählen Sie „S3-Speicher“ unter „Quelle des Schlüssels“.
- Wählen Sie den „Speicher“. „Region“ und „Speicheradresse“ füllen sich selbst; ändern Sie die „Region“, und die Adresse folgt.
- Geben Sie den „Bucket“ ein. Agenten erreichen diesen Bucket und sonst nichts im Speicher.
- Erstellen Sie im Speicher einen Schlüssel, der nur diesen Bucket erreicht, und fügen Sie seine „Access-Key-ID“ und seinen „Secret Access Key“ ein.
- Der „Name der Verbindung“ ist der Name des Buckets, bis Sie ihn ändern. Wählen Sie den „Arbeitsbereich“ und die „Umgebung“.
- Klicken Sie auf „Speichern und Schlüssel prüfen“. Sallyport versiegelt den Schlüssel, legt die Verbindung an und listet damit ein Objekt des Buckets.
Die Seite des Schlüssels zeigt das Ergebnis unter „Wohin dieser Schlüssel geht“. Ein falsches Geheimnis wird dort abgelehnt, in den Worten des Speichers selbst, bevor ein Agent es versucht. Alle Agenten des Arbeitsbereichs können den Bucket nutzen, sobald er gespeichert ist.
| Speicher | Speicheradresse | Region |
|---|---|---|
| Amazon S3 | https://s3.<region>.amazonaws.com. Der Bucket steht im Hostnamen: https://<bucket>.s3.<region>.amazonaws.com. | Die Region des Buckets, etwa eu-central-1. |
| Cloudflare R2 | Die S3-API-Adresse aus der R2-Übersicht: https://<account-id>.r2.cloudflarestorage.com. | auto |
| Backblaze B2 | https://s3.<region>.backblazeb2.com | Die Region aus der Adresse des Buckets, etwa eu-central-003. |
| Wasabi | https://s3.<region>.wasabisys.com | Die Region des Buckets, etwa eu-central-1. |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com | Das Rechenzentrum, etwa fra1. |
| Google Cloud Storage | https://storage.googleapis.com, mit einem HMAC-Schlüssel eines Service-Accounts. | auto |
| Anderer S3-kompatibler Speicher | Die HTTPS-Adresse seiner S3-API: MinIO, Hetzner, Scaleway, OVH, IDrive e2 und andere. | Die Region, für die er signiert; us-east-1, wenn er keine nennt. |
Was der Agent aufruft
Die Tools des Buckets enden auf _read und _write. Ihre Beschreibung sagt dem Agenten, wie er listet, liest, schreibt und löscht, damit er nicht raten muss. Der Pfad ist der vollständige S3-Pfad: bei jedem Speicher außer Amazon S3 beginnt er mit dem Bucket.
{
"method": "GET",
"path": "/reports/",
"params": { "list-type": "2", "prefix": "notes/" }
}{
"method": "PUT",
"path": "/reports/notes/2026-09-30.md",
"headers": { "Content-Type": "text/markdown", "x-amz-meta-author": "agent" },
"body": "# Weekly notes",
"intent": "Die Notizen dieser Woche speichern"
}Ein Lesezugriff ist GET /reports/notes/2026-09-30.md. Eine Kopie ist ein PUT mit x-amz-copy-source: /reports/notes/2026-09-30.md. Ein Löschen ist DELETE /reports/notes/2026-09-30.md. Die Antworten sind das XML von S3 selbst.
Welche Aufrufe auf Sie warten
| Aufruf | Klasse |
|---|---|
GET und HEAD: eine Auflistung, ein Download, die Metadaten eines Objekts | Lesen |
PUT und POST: ein Upload, eine Kopie, ein mehrteiliger Upload | Schreiben |
POST ?delete, das viele Objekte auf einmal löscht | Schreiben |
DELETE | Destruktiv |
Der Name eines Objekts ändert nie seine Klasse: builds/run.log zu lesen ist ein Lesezugriff. Aufrufe laufen ohne Nachfrage, bis Sie anders entscheiden; die Regeln stehen in der Liste „Zugriff“ des Agenten. Siehe Freigaben.
Große Dateien und Binärdaten
Die MCP-Tools transportieren Text: CSV, JSON, Logs, Markdown. Dateien jeder Art schicken Sie als Bytes über den HTTP-Proxy mit dem Token des Agenten. Der Pfad nach /p/<connection-id> ist der Schlüssel des Objekts im Bucket.
export SP_AGENT_TOKEN='<agent-token>'
curl --fail-with-body -X PUT \
-H "Authorization: Bearer $SP_AGENT_TOKEN" \
-H 'Content-Type: application/pdf' \
-H 'X-Sallyport-Intent: Store the signed contract' \
--data-binary @contract.pdf \
"https://mcp.sallyport.cloud/p/<connection-id>/contracts/2026/acme.pdf"
curl --fail-with-body -H "Authorization: Bearer $SP_AGENT_TOKEN" \
-o acme.pdf "https://mcp.sallyport.cloud/p/<connection-id>/contracts/2026/acme.pdf"Ein Upload über den Proxy trägt bis zu 32 MiB, ein Download bis zu 512 MiB. Teilen Sie eine größere Datei in einen mehrteiligen Upload.