Collega Sutram a Claude in meno di un minuto

URL del server MCP

I 3 passaggi

1. 1

   In claude.ai, apri Personalizza → Connettori.

2. 2

   Clicca su Aggiungi connettore personalizzato e incolla l'URL qui sopra.

3. 3

   Collega, scegli il progetto e autorizza.

Abilita i caricamenti di file in Claude

Le chiamate degli strumenti e i download di file funzionano non appena il connettore è autorizzato — Sutram trasmette in streaming i byte del file attraverso l’host del connettore stesso (app.sutram.io), quindi non serve alcuna voce aggiuntiva nella allowlist per leggere o allegare file. I caricamenti di file, invece, viaggiano direttamente dalla tua sessione di Claude ad AWS S3 tramite una presigned URL; senza autorizzare *.s3.amazonaws.com nella allowlist, vedrai errori di “rete bloccata” la prima volta che chiederai a Claude di salvare un file in Sutram.

1. 1

   In claude.ai, vai su Settings → Capabilities e attiva Code Execution and File Creation (i nomi delle sezioni variano in base alla versione di Claude — cerca la lista dei domini consentiti in uscita).

2. 2

   In Additional allowed domains, aggiungi:

   • app.sutram.io — endpoint MCP, OAuth, discovery e proxy di byte di file (già richiesto per il connettore stesso)
   • *.s3.amazonaws.com — upload diretto via presigned URL (il carattere jolly copre il sottodominio del bucket restituito da S3)

Una volta che Sutram sarà elencato nell’Anthropic Connectors Directory, questi domini saranno dichiarati dal listing stesso e Claude li autorizzerà automaticamente — questo passaggio manuale non sarà più necessario per i nuovi utenti.

Perché i caricamenti aggirano Sutram e vanno direttamente su S3: l’MCP restituisce una presigned PUT URL limitata a un singolo oggetto. I byte viaggiano direttamente dalla tua sessione di Claude ad AWS S3, senza mai passare dai server di Sutram. Il carattere jolly *.s3.amazonaws.com ha un nome ampio, ma l’autorizzazione avviene per presigned URL: Claude non può usare questa allowlist per raggiungere alcun bucket diverso da quello che Sutram ha firmato.

Claude Free

Claude Free non può configurare un elenco di domini consentiti personalizzato e non ha Code Execution. Cosa funziona e cosa no:

• ✅ I download dei file funzionano direttamente. Quando uno strumento restituisce un file scaricabile, l’URL punta all’host di Sutram stesso — per esempio app.sutram.io/mcp/v2/files/<token>. Sutram trasmette i byte da S3 a Claude tramite questa URL, quindi non è necessaria alcuna voce nell’elenco di domini e non è richiesto Code Execution. Il token scade 15 minuti dopo l’emissione e autorizza solo quel file.
• ✅ Ricerca, navigazione, commenti, tag, metadati, creazione di record tutto funziona nativamente, come su Pro/Team/Enterprise.
• ❌ I caricamenti di file sono limitati. Caricare un file via MCP richiede l’invio dei byte a S3 dall’ambiente di Claude, il che richiede Code Execution (Pro/Team/Enterprise). Gli utenti Free dovrebbero caricare tramite l’interfaccia web di Sutram — aprire la cartella di destinazione, fare clic su Aggiungi file, poi trascinare o sfogliare il file — e proseguire la conversazione in Claude dopo.

Per usare questa modalità, incolla il Sutram Light Preset sotto nelle Custom Instructions del tuo progetto Claude (Personalization → Custom Instructions, o l’equivalente per progetto). Il preset dice a Claude di preferire strumenti basati su link e di mostrare ogni URL come call-to-action cliccabile.

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.

Percorso Pro vs percorso Light