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

Non appena il connettore è autorizzato, gli strumenti di ricerca, navigazione, commenti, metadati e record funzionano immediatamente. Anche ottenere un link di download funziona ovunque — il link punta all'host di Sutram stesso (app.sutram.io), quindi non serve alcuna voce nella allowlist per riceverlo. Due funzionalità sono però diverse: far leggere a Claude il contenuto di un file da solo e caricare file in Sutram. Entrambe richiedono un runtime con accesso alla rete — Code Execution su Claude Pro/Team/Enterprise. I passaggi seguenti abilitano questa modalità.

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 ha Code Execution e non può configurare un elenco di domini consentiti personalizzato. Ecco cosa funziona e cosa no:

• ✅ I link di download funzionano. Quando uno strumento restituisce un file, Claude ti fornisce un link sull'host di Sutram stesso (per esempio app.sutram.io/mcp/v2/files/<token>). Fai clic per scaricare; il token scade 15 minuti dopo l'emissione e autorizza solo quel file. Nessuna voce nella allowlist e nessun Code Execution richiesti.
• ⚠️ Lettura del contenuto di un file: Claude non può aprire il file da solo in questa modalità. Se vuoi che Claude riassuma o analizzi un documento, scaricalo tramite il link e caricalo tu stesso nella chat. (Su Pro/Team/Enterprise con Code Execution, Claude legge il contenuto direttamente — senza passaggi manuali.)
• ❌ Caricare file in Sutram non è disponibile, perché il caricamento diretto invia i byte a S3 dall'ambiente di Claude, il che richiede *.s3.amazonaws.com nella allowlist (Pro/Team/Enterprise). Gli utenti Free caricano tramite l'interfaccia web di Sutram — aprire la cartella di destinazione, fare clic su Aggiungi file, poi trascinare o sfogliare il file — e proseguire in Claude dopo.
• ✅ Ricerca, navigazione, commenti, tag, metadati, creazione di record tutto funziona nativamente, come nei piani a pagamento.

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