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.
Pré-requisitos
Seção intitulada “Pré-requisitos”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.
Endpoint
Seção intitulada “Endpoint”https://mcp.engram.pageConfiguração
Seção intitulada “Configuração”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: EngramMCP server URL: https://mcp.engram.pageAuthentication: OAuthTransport: Streamable HTTPDepois 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.
Diga ao ChatGPT como usá-lo
Seção intitulada “Diga ao ChatGPT como 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.
Experimente
Seção intitulada “Experimente”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.
Acesso por chave de API
Seção intitulada “Acesso por chave de API”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.
Solução de problemas (específico do ChatGPT)
Seção intitulada “Solução de problemas (específico do ChatGPT)”- 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.
Revogação
Seção intitulada “Revogação”Para desconectar ChatGPT do Engram:
- Em ChatGPT, encontre a entrada do conector ou do servidor MCP e remova-a.
- No Engram, abra sua conta → API Keys & Sessions e revogue a sessão correspondente.
- 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.