Use o Sutram dentro do Claude

Você continua conversando com o Claude. O Sutram é onde o que importa fica guardado, versionado e aprovado. Conectar leva um minuto e não exige nada técnico.

Como funciona

No Claude

  • Você conversa como sempre: pergunta, pede resumos, rascunhos, comparações.
  • Quando você pede, o Claude busca, lê e cria coisas no seu projeto do Sutram.
  • Nada muda no jeito de usar. O Sutram aparece como mais uma ferramenta na conversa.

No Sutram

  • Os documentos, registros e conversas da sua equipe, organizados por projeto.
  • Cada versão, cada autor e cada aprovação ficam registrados.
  • A mesma fonte para as pessoas e para a IA. O que o Claude responde vem daqui.

Prefere ser guiado? Cole isto no Claude

Abra uma conversa nova, cole o texto abaixo e siga. O Claude pergunta que tipo de conta você tem e conduz um passo de cada vez. Ele não faz a conexão por você, porque as configurações ficam fora da conversa, mas explica cada tela até o fim.

Dica: abra essa conversa no celular e faça os cliques no computador. Assim o guia nunca sai da sua frente.

Texto para colar 
Quero conectar o Sutram ao Claude e preciso que você me guie, um passo de cada vez.

Contexto: o Sutram é onde minha equipe guarda documentos e registros, com versão e aprovação. Eu continuo conversando aqui; o Sutram é a memória. Para conectar eu preciso ter uma conta no Sutram e participar de pelo menos um projeto; se eu não tiver, me mande criar a conta em app.sutram.io antes de começar. Tecnicamente ele é um conector personalizado (MCP): endereço https://app.sutram.io/mcp/v2, login por OAuth.

Como me guiar:
- Pergunte primeiro se minha conta do Claude é pessoal (Free, Pro ou Max) ou de uma organização (Team ou Enterprise), porque o caminho muda.
- Depois me dê um passo por vez. No fim de cada passo, peça para eu descrever o que apareceu na tela antes de continuar.
- Use os nomes dos menus como estão hoje. Se eu disser que não encontrei algo, sugira onde mais pode estar em vez de repetir.

Caminhos:
- Pessoal: Personalização (barra lateral) > aba Conectores > Adicionar > Adicionar conector personalizado. Nome Sutram, colar o endereço, Continuar; o Claude verifica o servidor e mostra as opções de login já detectadas: deixar como está e clicar em Adicionar. Na lista, clicar em Vincular ao lado de Sutram; se pedir login, entrar no Sutram; escolher o projeto e Continuar. Na primeira conversa, quando o Claude pedir permissão para usar uma ferramenta do Sutram, clicar em Permitir. No plano Free só cabe um conector personalizado.
- Team ou Enterprise: só o proprietário da organização adiciona o conector, em Configurações da organização > Conectores. Se eu for proprietário, me guie por lá. Se não for, me ajude a escrever um pedido curto para quem é, com o endereço acima. Depois que estiver adicionado, eu clico em Vincular em Personalização > Conectores.

No fim, me peça para testar com: "Mostre o projeto conectado, meu papel nele e a pasta raiz."

Referência: https://sutram.io/pt/connect-claude/

Antes de começar, você precisa de

  • Uma conta no Sutram. Criar é grátis.
  • Participar de pelo menos um projeto, seu ou de outra pessoa. O dono do projeto precisa ter plano Pro ou superior; você pode estar no plano Basic.
  • Estar logado no Sutram neste navegador. Se não estiver, a tela de login aparece antes da escolha do projeto.

Você vai precisar deste endereço

https://app.sutram.io/mcp/v2

Os 3 passos

  1. 1

    No claude.ai, abra Personalização na barra lateral e clique na aba Conectores.

  2. 2

    Clique em Adicionar → Adicionar conector personalizado. Nome: Sutram. URL do servidor MCP: o endereço acima. Clique em Continuar; o Claude verifica o servidor e mostra as opções de login já detectadas. Deixe como está e clique em Adicionar.

  3. 3

    Na lista, o Sutram aparece com o botão Vincular. Clique nele. Se pedir login, entre no Sutram. Depois escolha o projeto e clique em Continuar. Na primeira conversa, o Claude pede permissão para usar as ferramentas do Sutram: clique em Permitir.

Team e Enterprise: só o proprietário da organização adiciona o conector, em Configurações da organização → Conectores. Depois disso, cada pessoa clica em Vincular e autoriza o próprio acesso.

No plano Free cabe um conector personalizado. O Sutram pode ser esse.

Arquivos: o que funciona onde

Buscar, navegar, comentar e criar registros funciona em qualquer plano, assim que o conector é autorizado. A diferença entre os planos aparece só quando o Claude precisa mover os bytes de um arquivo.

claude.ai e Claude Desktop no chat (Free, Pro, Max) Team e Enterprise Cowork e Claude Code
Buscar, navegar, comentar, criar registros ✓ ✓ ✓
Receber um link para baixar um arquivo ✓ Você clica e baixa ✓ ✓
O Claude lê o arquivo sozinho ✓ Depois de liberar os domínios abaixo ✓ Se o proprietário liberar os domínios abaixo ✓ Pode pedir permissão na primeira vez
Enviar um arquivo para o Sutram pelo Claude ✓ Depois de liberar os domínios abaixo ✓ Se o proprietário liberar os domínios abaixo ✓ Pode pedir permissão na primeira vez

Nos planos Free, Pro e Max você mesmo libera os domínios, em Settings → Capabilities. Em Team e Enterprise, só o proprietário da organização. Sem isso, o link de download continua funcionando: você clica, baixa e, se quiser que o Claude leia, anexa o arquivo ao chat.

Liberar os domínios

Free, Pro e Max: você faz isso em Settings → Capabilities. Team e Enterprise: só o proprietário da organização, em Organization settings → Capabilities, uma vez para todo mundo.

  1. 1

    Ative Code execution and file creation e, logo abaixo, Allow network egress. O campo Domain allowlist pode ficar em Package managers only.

  2. 2

    Em Additional allowed domains, adicione os dois domínios:

    • app.sutram.io — o próprio Sutram: endereço do conector e dos links de arquivo
    • *.s3.amazonaws.com — onde os arquivos ficam guardados; o envio vai direto para lá

Por que os arquivos vão direto para o S3: o Sutram gera um endereço assinado, válido para um único arquivo e por pouco tempo. Os bytes viajam da sessão do Claude para o armazenamento sem passar pelos servidores do Sutram. O curinga *.s3.amazonaws.com parece amplo, mas cada endereço assinado só serve para o arquivo que o Sutram autorizou.

Sem acesso a arquivos? Cole estas instruções

Se você ainda não liberou os domínios, ou está num Team ou Enterprise em que o proprietário não liberou, cole o texto abaixo nas instruções do seu projeto no Claude (Personalizar → Instruções, ou o equivalente por projeto). Ele ensina o Claude a preferir links clicáveis e a não tentar mover arquivos que não consegue mover.

Instruções para o Claude 
You are connected to Sutram via MCP. The user is on Claude without a custom network 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 attach the file to 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.

Requisitos de plano

Sutram: Conectar o Claude ao Sutram exige um projeto de propriedade de um usuário com plano Pro ou superior. Membros desse projeto também podem conectar, mesmo no plano Basic.

Claude: Qualquer plano do Claude conecta, inclusive o Free, que aceita um conector personalizado. Em Team e Enterprise, o proprietário da organização adiciona o conector e cada pessoa autoriza o próprio acesso.

Usa ChatGPT em vez de Claude? Veja como usar o Sutram dentro do ChatGPT →

Para quem é técnico

O Sutram é um servidor MCP remoto (Streamable HTTP) com OAuth. O que o Claude chama de conector personalizado e o ChatGPT chama de app é a mesma conexão. Guia completo do MCP Server →

Comece grátis no Sutram