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

Dès que le connecteur est autorisé, les outils de recherche, de navigation, de commentaires, de métadonnées et d'enregistrements fonctionnent immédiatement. Obtenir un lien de téléchargement fonctionne aussi sur tous les plans — le lien pointe vers l'hôte de Sutram lui-même (app.sutram.io), aucune entrée dans l'allowlist n'est donc nécessaire pour le recevoir. Deux capacités sont toutefois différentes : faire lire le contenu d'un fichier à Claude par lui-même, et envoyer des fichiers dans Sutram. Les deux nécessitent un runtime avec accès réseau — Code Execution sur Claude Pro/Team/Enterprise. Les étapes ci-dessous activent cette voie.

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 n'a pas Code Execution et ne permet pas de configurer une liste de domaines autorisés personnalisée. Voici ce qui fonctionne et ce qui ne fonctionne pas :

• ✅ Les liens de téléchargement fonctionnent. Lorsqu'un outil renvoie un fichier, Claude vous donne un lien sur l'hôte de Sutram lui-même (par exemple, app.sutram.io/mcp/v2/files/<token>). Vous cliquez pour télécharger ; le token expire 15 minutes après son émission et autorise uniquement ce fichier. Aucune entrée dans l'allowlist ni Code Execution requis.
• ⚠️ Lecture du contenu d'un fichier : Claude ne peut pas ouvrir le fichier par lui-même dans ce mode. Si vous voulez que Claude résume ou analyse un document, téléchargez-le via le lien et envoyez-le vous-même dans le chat. (Sur Pro/Team/Enterprise avec Code Execution, Claude lit le contenu directement — sans étape manuelle.)
• ❌ Envoyer des fichiers dans Sutram n'est pas disponible, car l'envoi direct transmet les octets vers S3 depuis l'environnement de Claude, ce qui nécessite *.s3.amazonaws.com dans l'allowlist (Pro/Team/Enterprise). Les utilisateurs Free envoient via l'interface web de Sutram — ouvrir le dossier cible, cliquer sur Ajouter un fichier, puis déposer ou parcourir le fichier — et poursuivre dans Claude ensuite.
• ✅ Recherche, navigation, commentaires, tags, métadonnées, création d’enregistrements tout fonctionne nativement, comme sur les plans payants.

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