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

Tool-Aufrufe und Datei-Downloads funktionieren, sobald der Konnektor autorisiert ist — Sutram streamt die Datei-Bytes über den Host des Konnektors selbst (app.sutram.io), sodass kein zusätzlicher Allowlist-Eintrag nötig ist, um Dateien zu lesen oder anzuhängen. Datei-Uploads gehen dagegen direkt von deiner Claude-Sitzung zu AWS S3 über eine presigned URL; ohne *.s3.amazonaws.com auf der Allowlist siehst du beim ersten Versuch, eine Datei in Sutram zu speichern, Fehler vom Typ „Netzwerk blockiert“.

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 kann keine benutzerdefinierte Domain-Allowlist konfigurieren und hat kein Code Execution. Was funktioniert und was nicht:

• ✅ Datei-Downloads funktionieren direkt. Wenn ein Tool eine herunterladbare Datei zurückgibt, verweist die URL auf Sutrams eigenen Host — zum Beispiel app.sutram.io/mcp/v2/files/<token>. Sutram streamt die Bytes von S3 über diese URL direkt zu Claude, sodass kein Allowlist-Eintrag und kein Code Execution erforderlich ist. Das Token läuft 15 Minuten nach Ausstellung ab und autorisiert nur diese eine Datei.
• ✅ Suche, Navigation, Kommentare, Tags, Metadaten, Datensatzerstellung alles funktioniert nativ, genauso wie bei Pro/Team/Enterprise.
• ❌ Datei-Uploads sind eingeschränkt. Um eine Datei über MCP hochzuladen, müssen die Bytes aus Claudes Umgebung zu S3 gesendet werden, was Code Execution erfordert (Pro/Team/Enterprise). Free-Nutzer sollten über die Sutram-Weboberfläche hochladen — den Zielordner öffnen, auf Datei hinzufügen klicken und dann die Datei ablegen oder durchsuchen — und das Gespräch danach in Claude fortsetzen.

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