Use o Sutram dentro do ChatGPT
Você continua conversando com o ChatGPT. O Sutram é onde o que importa fica guardado, versionado e aprovado. Conectar leva alguns minutos e o caminho depende do tipo da sua conta.
Como funciona
No ChatGPT
- Você conversa como sempre: pergunta, pede resumos, rascunhos, comparações.
- Quando você pede, o ChatGPT busca, lê e cria coisas no seu projeto do Sutram.
- Nada muda no jeito de usar. O Sutram aparece como mais um app 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 ChatGPT responde vem daqui.
Prefere ser guiado? Cole isto no ChatGPT
Abra uma conversa nova, cole o texto abaixo e siga. O ChatGPT 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. A configuração só existe no ChatGPT pela web, e assim o guia nunca sai da sua frente.
Quero conectar o Sutram ao ChatGPT 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 app MCP: endereço https://app.sutram.io/mcp/v2, login por OAuth.
Como me guiar:
- Pergunte primeiro se minha conta do ChatGPT é pessoal (Plus ou Pro), Business ou Enterprise/Edu, 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.
- Isso só funciona no ChatGPT pela web, no computador. Se eu estiver no celular, me peça para abrir o ChatGPT no navegador do computador e continuar esta conversa por aqui.
Caminhos:
- Pessoal (Plus ou Pro): não há configuração prévia. Plugins (barra lateral) > Add > Create MCP App: nome Sutram, colar o endereço em Connection, Authentication OAuth, marcar a confirmação e Create. Clicar em Continue to Sutram; se pedir login, entrar no Sutram; escolher o projeto e Continuar. Numa conversa, escrever @Sutram e escolher o app.
- Business: só administradores ou proprietários do workspace conseguem. Se eu for admin: Workspace settings > Apps > Create (isso liga o Developer mode), criar o app com os dados acima, testar numa conversa e publicar em Workspace settings > Apps > Drafts. Se eu não for admin, me ajude a escrever um pedido curto para quem é, com os dados acima.
- Enterprise ou Edu: um admin precisa liberar o Developer mode para mim em Permissions & Roles > Connected Data. Depois eu ligo em Settings > Apps > Advanced Settings e crio o app em Settings > Apps > Create. Só admin publica para todos.
- Se em algum ponto a opção Create MCP App não existir, me ajude a procurar um "Developer mode" em Settings; o nome e o lugar mudam entre versões.
No fim, me peça para testar com: "Use o Sutram para mostrar o projeto conectado, meu papel nele e a pasta raiz."
Referência: https://sutram.io/pt/connect-chatgpt/ 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 passos, por tipo de conta
O caminho muda conforme a sua conta do ChatGPT. Todos exigem o ChatGPT pela web, no computador. O aplicativo do celular não tem essa configuração.
Conta pessoal (Plus ou Pro)
- 1
Em Plugins, na barra lateral, clique em Add → Create MCP App.
- 2
No formulário: Name Sutram, Connection com o endereço acima, Authentication OAuth. Marque a confirmação e clique em Create.
- 3
Clique em Continue to Sutram. Se pedir login, entre no Sutram. Depois escolha o projeto e clique em Continuar.
- 4
Numa conversa nova, escreva @Sutram e escolha o app. Pronto.
Business
Só administradores e proprietários do workspace podem ligar o Developer mode e publicar apps. Se você não é um deles, peça a quem é. O texto guiado acima ajuda a escrever o pedido.
- 1
Em Workspace settings → Apps → Create, crie o app (isso liga o Developer mode para você): nome Sutram, endereço acima, autenticação OAuth.
- 2
Teste numa conversa: selecione o app Sutram e peça a pasta raiz do projeto.
- 3
Em Workspace settings → Apps → Drafts, publique. O app passa a aparecer para todo o workspace.
Enterprise e Edu
Um administrador precisa liberar o Developer mode para você. Depois de publicado, quem pode usar o app é definido pelo administrador.
- 1
Administrador: em Permissions & Roles → Connected Data, libere o Developer mode para as pessoas que vão criar apps.
- 2
Você: em Settings → Apps → Advanced Settings, ligue o Developer mode. Em Settings → Apps → Create, crie o app com nome Sutram, endereço acima e autenticação OAuth.
- 3
Administrador: em Workspace settings → Apps, publique e defina quem pode usar.
Numa conta Plus ou Pro não há configuração prévia: Create MCP App já aparece no menu Add (verificado em 30 de setembro de 2026). Se não aparecer, procure um Developer mode em Settings; a OpenAI muda o nome e o lugar com frequência. O texto guiado acima resolve na conversa.
Primeiros pedidos para testar
Depois de conectar, comece com um pedido que funcione em qualquer projeto, só para confirmar quem está conectado:
- “Mostre o projeto conectado, meu papel nele e a pasta raiz.”
- “Liste o que existe na pasta raiz e me diga como o projeto está organizado.”
Confira o resultado, não só o resumo. O ChatGPT pode resumir o que a ferramenta devolveu ou esconder os detalhes num painel. Quando precisar ter certeza, peça os nomes, IDs e links dos itens. Uma resposta na conversa, por si só, não confirma que uma alteração foi salva no Sutram.
Arquivos: o que funciona onde
Buscar, navegar, comentar e criar registros funciona assim que o app é autorizado. A diferença aparece quando é preciso mover os bytes de um arquivo.
| ChatGPT (web) | Codex | |
|---|---|---|
| Buscar, navegar, comentar, criar registros | ✓ | ✓ |
| Receber um link para baixar um arquivo | ✓ Você clica e baixa | ✓ |
| O assistente lê o arquivo sozinho | ✗ Baixe pelo link e anexe ao chat | ✓ Com acesso à rede ligado |
| Enviar um arquivo para o Sutram pelo assistente | ✗ Envie pela interface web do Sutram | ✓ Com acesso à rede ligado |
No ChatGPT pela web o assistente não tem como transferir arquivos por conta própria: ele entrega o link e você faz o resto. No Codex, a rede do ambiente precisa estar liberada; no modo workspace-write ela vem desligada.
Requisitos de plano
Sutram: Conectar o ChatGPT 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.
OpenAI: Contas Plus e Pro criam o app direto em Plugins → Add. Em Business, só administradores e proprietários do workspace. Em Enterprise e Edu, quem o administrador liberar. Contas Free não têm essa opção. O Codex tem configuração própria, descrita abaixo.
Usa Claude em vez de ChatGPT? Veja como usar o Sutram dentro do Claude →
Codex (para desenvolvedores)
O Codex conecta o Sutram diretamente como servidor MCP. Numa tarefa local, ele combina as ferramentas do Sutram com os arquivos e comandos do seu ambiente, conforme as permissões. Para conectar pela interface do aplicativo:
- Abra Settings (Configurações) → MCP servers (Servidores MCP) e clique em Add server (Adicionar servidor). Os nomes das opções podem variar conforme a versão.
- No campo de nome, digite sutram. No tipo de conexão ou transporte, selecione Streamable HTTP.
- No campo URL, cole https://app.sutram.io/mcp/v2. Essa é a URL do servidor MCP, não a página inicial do Sutram.
- Clique em Save (Salvar) e depois em Restart (Reiniciar) para carregar o servidor.
- Na lista de servidores, clique em Authenticate (Autenticar) quando o Sutram solicitar OAuth. No navegador, entre na sua conta Sutram, escolha o projeto e autorize o acesso.
- Volte ao aplicativo e confirme que o servidor está habilitado e conectado. Em uma tarefa, peça: “Use o Sutram para mostrar o projeto conectado, meu papel nele e a pasta raiz.”
Como alternativa à configuração pela interface, adicione esta entrada ao arquivo local ~/.codex/config.toml:
[mcp_servers.sutram]
url = "https://app.sutram.io/mcp/v2" Autentique-se pelo cliente ou execute codex mcp login sutram com o Codex CLI instalado. Entre no Sutram e autorize o projeto desejado. Recarregue a conexão se necessário e peça o nome do projeto, seu papel nele e a pasta raiz para verificar o acesso.
Documentação revisada em 30 de setembro de 2026: Configuração MCP da OpenAI e Developer mode e apps MCP no ChatGPT.
Para quem é técnico
O Sutram é um servidor MCP remoto (Streamable HTTP) com OAuth. O que o ChatGPT chama de app dentro de um plugin e o Claude chama de conector personalizado é a mesma conexão. Guia completo do MCP Server →