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

Chamadas de ferramenta e downloads de arquivos funcionam assim que o conector é autorizado — o Sutram faz o streaming dos bytes do arquivo pelo próprio host do conector (app.sutram.io), então nenhuma entrada extra de allowlist é necessária para ler ou anexar arquivos. Já os envios de arquivos viajam diretamente da sua sessão do Claude para o AWS S3 via uma presigned URL; sem permitir *.s3.amazonaws.com na allowlist, você verá erros de “rede bloqueada” na primeira vez que pedir ao Claude para salvar um arquivo no Sutram.

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 permite configurar uma lista de domínios permitidos personalizada e não tem Code Execution. O que funciona e o que não funciona:

• ✅ Downloads de arquivos funcionam diretamente. Quando uma ferramenta retorna um arquivo para download, a URL aponta para o próprio host do Sutram — por exemplo, app.sutram.io/mcp/v2/files/<token>. O Sutram transmite os bytes do S3 para o Claude através dessa URL, então nenhuma entrada na lista de domínios é necessária e nenhum Code Execution é exigido. O token expira 15 minutos após a emissão e autoriza apenas esse arquivo.
• ✅ Busca, navegação, comentários, tags, metadados, criação de registros tudo funciona nativamente, igual aos planos Pro/Team/Enterprise.
• ❌ Uploads de arquivos são limitados. Enviar um arquivo via MCP exige transmitir os bytes para o S3 a partir do ambiente do Claude, o que precisa de Code Execution (Pro/Team/Enterprise). Usuários Free devem fazer upload pela interface web do Sutram — abrir a pasta de destino, clicar em Adicionar arquivo e depois soltar ou navegar pelo arquivo — e continuar a conversa no Claude depois.

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