Verbinde Sutram mit Claude in unter einer Minute

MCP-Server-URL

Die 3 Schritte

1. 1

   Öffne in claude.ai Anpassen → Konnektoren.

2. 2

   Klicke auf Benutzerdefinierten Konnektor hinzufügen und füge die URL oben ein.

3. 3

   Verbinde, wähle das Projekt und autorisiere.

Datei-Uploads in Claude aktivieren

Sobald der Konnektor autorisiert ist, funktionieren die Tools für Suche, Navigation, Kommentare, Metadaten und Datensätze sofort. Auch das Abrufen eines Download-Links funktioniert überall — der Link verweist auf Sutrams eigenen Host (app.sutram.io), sodass kein Allowlist-Eintrag nötig ist, um ihn zu erhalten. Zwei Fähigkeiten sind jedoch anders: Claude den Inhalt einer Datei selbst lesen zu lassen und Dateien in Sutram hochzuladen. Beide erfordern eine netzwerkfähige Laufzeitumgebung — Code Execution auf Claude Pro/Team/Enterprise. Die folgenden Schritte aktivieren diesen Weg.

1. 1

   Öffne in claude.ai Settings → Capabilities und aktiviere Code Execution and File Creation (die Abschnittsnamen variieren je nach Claude-Version — suche nach der Allowlist für ausgehende Netzwerkverbindungen).

2. 2

   Füge unter Additional allowed domains hinzu:

   • app.sutram.io — MCP-Endpunkt, OAuth, Discovery und Datei-Byte-Proxy (bereits für den Konnektor selbst erforderlich)
   • *.s3.amazonaws.com — direkte Uploads via presigned URL (der Wildcard deckt die vom S3 zurückgegebene Bucket-Subdomain ab)

Sobald Sutram im Anthropic Connectors Directory gelistet ist, werden diese Domains vom Listing deklariert und Claude autorisiert sie automatisch — dieser manuelle Schritt entfällt dann für neue Nutzer.

Warum Uploads Sutram umgehen und direkt zu S3 gehen: Das MCP gibt eine presigned PUT URL zurück, die auf ein einzelnes Objekt beschränkt ist. Die Bytes gehen direkt von deiner Claude-Sitzung zu AWS S3 — niemals durch Sutrams Server. Der Wildcard *.s3.amazonaws.com ist im Namen breit, doch die Autorisierung erfolgt pro presigned URL: Claude kann diese Allowlist nicht nutzen, um einen anderen Bucket zu erreichen als den, für den Sutram signiert hat.

Claude Free

Claude Free hat kein Code Execution und kann keine benutzerdefinierte Domain-Allowlist konfigurieren. Das funktioniert und das nicht:

• ✅ Download-Links funktionieren. Wenn ein Tool eine Datei zurückgibt, gibt Claude dir einen Link auf Sutrams eigenem Host (zum Beispiel app.sutram.io/mcp/v2/files/<token>). Du klickst darauf, um herunterzuladen; das Token läuft 15 Minuten nach Ausstellung ab und autorisiert nur diese eine Datei. Kein Allowlist-Eintrag und kein Code Execution erforderlich.
• ⚠️ Den Inhalt einer Datei lesen: Claude kann die Datei in diesem Modus nicht selbst öffnen. Wenn Claude ein Dokument zusammenfassen oder analysieren soll, lade es über den Link herunter und lade es selbst in den Chat hoch. (Auf Pro/Team/Enterprise mit Code Execution liest Claude den Inhalt direkt — ohne manuellen Schritt.)
• ❌ Dateien in Sutram hochladen ist nicht verfügbar, da der direkte Upload die Bytes aus Claudes Umgebung zu S3 sendet, was *.s3.amazonaws.com auf der Allowlist erfordert (Pro/Team/Enterprise). Free-Nutzer laden über die Sutram-Weboberfläche hoch — den Zielordner öffnen, auf Datei hinzufügen klicken und dann die Datei ablegen oder durchsuchen — und danach in Claude fortfahren.
• ✅ Suche, Navigation, Kommentare, Tags, Metadaten, Datensatzerstellung alles funktioniert nativ, genauso wie in den kostenpflichtigen Plänen.

Um diesen Modus zu nutzen, fügen Sie das Sutram Light Preset unten in die Custom Instructions Ihres Claude-Projekts ein (Personalization → Custom Instructions oder das projektspezifische Äquivalent). Das Preset weist Claude an, link-basierte Tools zu bevorzugen und jede URL als klickbaren Call-to-Action darzustellen.

You are connected to Sutram via MCP. The user is on Claude without Code Execution and without custom domain allowlist, so you cannot fetch URLs from tool results or transfer file bytes directly.

Operating rules:

1. For file uploads, new versions, or edits, always prefer the `sutram_*_link` tools: `sutram_upload_link`, `sutram_new_version_link`, `sutram_edit_file_link`. These return deep links to the Sutram web app where the user completes the action in their browser. Never call `sutram_request_upload`, `sutram_create_new_version`, or `sutram_checkout_file` in this mode — they return presigned URLs that you cannot execute.

2. When any tool returns a URL, present it to the user as a clear markdown call-to-action: an emoji, a short label, the clickable link, and a note about expiry if applicable. Example: "📥 [Download contract-2026-Q1.pdf](https://app.sutram.io/mcp/v2/files/<token>) (link valid for 15 minutes)". Never display a raw URL as bare text.

3. If the user asks you to read, summarize, or analyze the content of a Sutram file, explain that you cannot fetch the file contents directly in this mode. Offer two options: (a) have them download via the link and paste the content into the chat, or (b) use Sutram's search and metadata tools to answer based on what is exposed without reading the binary.

4. Before any destructive action (`sutram_delete`, `sutram_delete_record`, `sutram_force_release_lock`, etc.), explicitly ask the user to confirm in the conversation, even if the connector has already shown its own permission prompt.

5. Search, navigation, comments, records, and metadata tools (`sutram_search_items`, `sutram_get_folder`, `sutram_get_item`, `sutram_list_comments`, `sutram_create_comment`, etc.) work fully in this mode — use them freely.

Pro-Pfad vs Light-Pfad