Connectez Sutram à Claude en moins d'une minute

URL du serveur MCP

Les 3 étapes

1. 1

   Dans claude.ai, ouvrez Personnaliser → Connecteurs.

2. 2

   Cliquez sur Ajouter un connecteur personnalisé et collez l'URL ci-dessus.

3. 3

   Liez, choisissez le projet et autorisez.

Activer les envois de fichiers dans Claude

Les appels d’outil et les téléchargements de fichiers fonctionnent dès que le connecteur est autorisé — Sutram diffuse les octets du fichier via l’hôte du connecteur lui-même (app.sutram.io), aucune entrée supplémentaire dans l’allowlist n’est donc nécessaire pour lire ou joindre des fichiers. Les envois de fichiers, en revanche, voyagent directement depuis votre session Claude vers AWS S3 via une presigned URL ; sans autoriser *.s3.amazonaws.com dans l’allowlist, vous verrez des erreurs « réseau bloqué » dès le premier prompt qui demande à Claude d’enregistrer un fichier dans Sutram.

1. 1

   Dans claude.ai, allez dans Settings → Capabilities et activez Code Execution and File Creation (les noms de section varient selon la version de Claude — cherchez la liste des domaines autorisés en sortie).

2. 2

   Dans Additional allowed domains, ajoutez :

   • app.sutram.io — endpoint MCP, OAuth, discovery, et proxy d’octets de fichier (déjà requis pour le connecteur lui-même)
   • *.s3.amazonaws.com — envois directs via presigned URL (le caractère générique couvre le sous-domaine du bucket renvoyé par S3)

Une fois Sutram listé dans le Anthropic Connectors Directory, ces domaines seront déclarés par le listing et Claude les autorisera automatiquement — cette étape manuelle ne sera plus requise pour les nouveaux utilisateurs.

Pourquoi les envois contournent Sutram et vont directement vers S3 : le MCP renvoie une presigned PUT URL délimitée à un seul objet. Les octets voyagent directement depuis votre session Claude vers AWS S3, sans jamais passer par les serveurs de Sutram. Le caractère générique *.s3.amazonaws.com a un nom large, mais l’autorisation se fait par presigned URL : Claude ne peut pas utiliser cette allowlist pour atteindre un autre bucket que celui que Sutram a signé.

Claude Free

Claude Free ne permet pas de configurer une liste de domaines autorisés personnalisée et n’a pas Code Execution. Ce qui fonctionne et ce qui ne fonctionne pas :

• ✅ Les téléchargements de fichiers fonctionnent directement. Lorsqu’un outil renvoie un fichier téléchargeable, l’URL pointe vers l’hôte de Sutram lui-même — par exemple, app.sutram.io/mcp/v2/files/<token>. Sutram transmet les octets depuis S3 vers Claude via cette URL, donc aucune entrée dans la liste de domaines n’est nécessaire et Code Execution n’est pas requis. Le token expire 15 minutes après son émission et autorise uniquement ce fichier.
• ✅ Recherche, navigation, commentaires, tags, métadonnées, création d’enregistrements tout fonctionne nativement, comme sur Pro/Team/Enterprise.
• ❌ Les envois de fichiers sont limités. Envoyer un fichier via MCP nécessite d’envoyer les octets à S3 depuis l’environnement de Claude, ce qui requiert Code Execution (Pro/Team/Enterprise). Les utilisateurs Free doivent envoyer via l’interface web de Sutram — ouvrir le dossier cible, cliquer sur Ajouter un fichier, puis déposer ou parcourir le fichier — et poursuivre la conversation dans Claude ensuite.

Pour utiliser ce mode, collez le Sutram Light Preset ci-dessous dans les Custom Instructions de votre projet Claude (Personalization → Custom Instructions, ou l’équivalent par projet). Le preset indique à Claude de privilégier les outils basés sur des liens et de présenter chaque URL comme un call-to-action cliquable.

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.

Voie Pro vs voie Light