Pular para o conteúdo

ChatGPT

Os Custom Connectors do ChatGPT (também chamados de MCP apps) ficam atrás da chave Developer Mode. Você adiciona o Engram pela URL, o OAuth dispara na hora e o conector passa a ser selecionável no menu de ferramentas dos seus chats. Disponível nos planos Plus, Pro, Business/Team e Enterprise/Edu no app web. O desktop e o celular não oferecem a criação de conectores.

Antes de começar, confirme:

  • Você tem uma conta do Engram em app.engram.page.
  • Pelo menos um cofre está sincronizado. Abra o plugin do Obsidian ou o app web e confirme que as notas foram sincronizadas no último dia.
  • Você consegue entrar pelo navegador. O fluxo de autenticação do MCP abre uma janela do navegador.
  • Se você pretende usar uma chave de API em vez do OAuth: chaves de API exigem o Pro. O login por OAuth funciona em todos os planos, inclusive o Free, e é o caminho recomendado. Free e Starter não podem criar nem usar chaves de API.

Além disso, os específicos do ChatGPT:

  • Um plano Plus, Pro, Business/Team ou Enterprise/Edu no app web.
  • No Team/Enterprise: o administrador do workspace ativou o Developer Mode no nível do workspace. Usuários pessoais do Plus/Pro podem ativá-lo sozinhos; workspaces corporativos dependem do administrador.
https://mcp.engram.page

1. Ative o Developer Mode. No ChatGPT web, vá em Settings → Apps & Connectors → Advanced → Developer Mode = ON. Confirme o aviso de que conectores não verificados podem modificar ou excluir dados. No caso do Engram, os únicos dados acessíveis são os do seu próprio cofre.

2. Adicione o conector. Na mesma tela, clique em Add new connector (ou Create). Preencha o formulário com estes valores:

Name: Engram
MCP server URL: https://mcp.engram.page
Authentication: OAuth
Transport: Streamable HTTP

Depois marque I trust this application.

3. Aprove. Clique em Create. O OAuth dispara na hora. Seu navegador abre para você entrar no Engram e aprovar a conexão. O ChatGPT guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo. Escopos granulares por ação estão no roteiro.

4. (Somente Team/Enterprise) Publique. Seu administrador então publica o rascunho em Workspace Settings → Apps → Drafts para que o restante do workspace possa usá-lo.

Não existe um prompt de sistema por conector. O lugar duradouro para colocar uma dica do tipo “recorra ao Engram” é Settings → Personalization → Custom Instructions, no campo “What traits should ChatGPT have?”. Cole esta linha curta:

Engram holds my personal notes. Treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Abra um chat novo. Selecione Engram no menu de ferramentas (o chip + ou o chip Developer Mode no campo de mensagem). Depois pergunte:

  • Pesquise no meu cofre as notas sobre o processo de entrevistas de engenharia e resuma as três principais.
  • Encontre tudo o que escrevi sobre embeddings no último mês.

O ChatGPT chama a ferramenta search do Engram (ou get_note, write_note etc.), traz os resultados e responde no contexto. Se a ferramenta disparar, está tudo certo.

A interface de Custom Connectors do ChatGPT não oferece autenticação estática por chave de API, apenas OAuth. Se você precisa de acesso por chave de API (por exemplo, em um self-host em que o OAuth não é uma opção), use outro cliente MCP. Veja Configuração do MCP → Autenticação por chave de API.

  • Nenhuma chave “Developer Mode” visível. O recurso está restrito por plano ou por liberação gradual. No Plus/Pro, aguarde a liberação. No Team ou Enterprise, peça ao administrador do workspace para ativá-lo em Workspace settings → Connectors → Developer Mode.
  • Erro Connector is … ao criar. A URL foi rejeitada ou o transporte está errado. Confirme que a URL corresponde ao endpoint acima e que o transporte é Streamable HTTP, não SSE.
  • O conector “some” entre chats. Os Custom Connectors precisam ser selecionados de novo a cada chat novo, no menu de ferramentas. É assim por design, não é um bug. O token OAuth continua válido.

Para falhas comuns a todos os clientes, veja Solução de problemas.

Para desconectar ChatGPT do Engram:

  1. Em ChatGPT, encontre a entrada do conector ou do servidor MCP e remova-a.
  2. No Engram, abra sua conta → API Keys & Sessions e revogue a sessão correspondente.
  3. O token OAuth é invalidado no servidor. ChatGPT precisará se autenticar de novo para reconectar.

Você também pode remover o conector em Settings → Apps & Connectors no próprio ChatGPT.