Conecte o Sutram ao Claude em 1 minuto

URL do servidor MCP

Os 3 passos

1. 1

   Em claude.ai, abra Personalizar → Conectores.

2. 2

   Clique em Adicionar conector personalizado e cole a URL acima.

3. 3

   Vincule, escolha o projeto e autorize.

Habilite envios de arquivo no Claude

Assim que o conector é autorizado, as ferramentas de busca, navegação, comentários, metadados e registros funcionam imediatamente. Obter um link de download também funciona em qualquer plano — o link aponta para o próprio host do Sutram (app.sutram.io), então nenhuma entrada na allowlist é necessária para recebê-lo. Duas capacidades são diferentes, porém: fazer o Claude ler o conteúdo de um arquivo por conta própria e enviar arquivos para o Sutram. Ambas exigem um runtime com acesso à rede — Code Execution no Claude Pro/Team/Enterprise. Os passos abaixo habilitam esse caminho.

1. 1

   No claude.ai, vá em Settings → Capabilities e ative Code Execution and File Creation (os nomes das seções variam conforme a versão do Claude — procure pela lista de domínios permitidos para saída de rede).

2. 2

   Em Additional allowed domains, adicione:

   • app.sutram.io — endpoint MCP, OAuth, discovery e proxy de bytes de arquivo (já necessário para o próprio conector)
   • *.s3.amazonaws.com — envio direto via presigned URL (o wildcard cobre o subdomínio do bucket retornado pelo S3)

Quando o Sutram for listado no Anthropic Connectors Directory, esses domínios serão declarados pela própria listagem e o Claude os autorizará automaticamente — esse passo manual deixará de ser necessário para novos usuários.

Por que os envios contornam o Sutram e vão direto para o S3: o MCP retorna uma presigned PUT URL com escopo para um único objeto. Os bytes viajam diretamente da sua sessão do Claude para o AWS S3, sem nunca passar pelos servidores do Sutram. O wildcard *.s3.amazonaws.com tem nome amplo, mas a autorização é por presigned URL: o Claude não consegue usar essa allowlist para alcançar qualquer bucket além daquele que o Sutram assinou.

Claude Free

O Claude Free não tem Code Execution e não permite configurar uma lista de domínios permitidos personalizada. Veja o que funciona e o que não funciona:

• ✅ Links de download funcionam. Quando uma ferramenta retorna um arquivo, o Claude fornece um link no próprio host do Sutram (por exemplo, app.sutram.io/mcp/v2/files/<token>). Você clica para baixar; o token expira 15 minutos após a emissão e autoriza apenas esse arquivo. Nenhuma entrada na allowlist e nenhum Code Execution são necessários.
• ⚠️ Leitura do conteúdo de um arquivo: o Claude não consegue abrir o arquivo por conta própria nesse modo. Se você quiser que o Claude resuma ou analise um documento, baixe-o pelo link e envie-o você mesmo para o chat. (No Pro/Team/Enterprise com Code Execution, o Claude lê o conteúdo diretamente — sem passo manual.)
• ❌ Enviar arquivos para o Sutram não está disponível, porque o envio direto manda os bytes para o S3 a partir do ambiente do Claude, o que exige o *.s3.amazonaws.com na allowlist (Pro/Team/Enterprise). Usuários Free enviam pela interface web do Sutram — abrir a pasta de destino, clicar em Adicionar arquivo e depois soltar ou navegar pelo arquivo — e continuar no Claude depois.
• ✅ Busca, navegação, comentários, tags, metadados, criação de registros tudo funciona nativamente, igual aos planos pagos.

Para usar esse modo, cole o Sutram Light Preset abaixo nas Custom Instructions do seu projeto Claude (Personalização → Custom Instructions, ou o equivalente por projeto). O preset diz ao Claude para preferir tools baseadas em link e renderizar cada URL como um call-to-action clicável.

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.

Trilha Pro vs trilha Light