ChatGPT

Pré-requisitos

Use uma configuração de aplicativo OpenAI que ofereça suporte a um servidor MCP remoto e ao endpoint Streamable HTTP hospedado. Ambientes de execução e pré-requisitos:

• Interface concreta: Cliente web e desktop do ChatGPT (OpenAI Apps / Actions).
• Endpoint: https://xmemo.dev/mcp.
• Transporte: Streamable HTTP (streamable-http).
• Modo de autenticação: OAuth com escopos memory:read e memory:write.
• Conta: Conta válida do XMemo em https://xmemo.dev.

Instalação / configuração

No cliente ChatGPT ou no painel da plataforma OpenAI, registre a URL MCP hospedada e os metadados OAuth para a conexão remota:

• Configure a URL MCP hospedada no painel do aplicativo: https://xmemo.dev/mcp.
• Solicite memory:read e memory:write no consentimento.
• Não adicione um token de portador à listagem do aplicativo.

Definir a credencial

Nenhuma chave — conclua o OAuth no navegador. O ChatGPT recebe a credencial por meio da concessão de OAuth; não defina XMEMO_KEY nem adicione um cabeçalho Authorization:

No XMEMO_KEY
Complete browser OAuth in ChatGPT

Gerar / confirmar XMEMO_AGENT_INSTANCE_ID

A listagem OAuth revisada do ChatGPT não possui cabeçalho de identidade no lado do cliente. Não invente nem cole XMEMO_AGENT_INSTANCE_ID na configuração do aplicativo; confirme que a atribuição é gerenciada pela concessão de OAuth para este caminho de cliente.

Preservar o bloco de configuração existente

Use o bloco de configuração revisado do ChatGPT. Preserve sua URL hospedada, modo OAuth e escopos solicitados; altere apenas os valores do painel local que o cliente exigir:

{
  "servers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Reiniciar o cliente

Salve a configuração do aplicativo, feche qualquer conexão MCP obsoleta e reabra o aplicativo ou a conversa do ChatGPT para que ele carregue os metadados OAuth atuais.

Testar com uma chamada real de recall

Faça a primeira chamada MCP somente leitura. Esta é uma invocação real de recall, não um espaço reservado para verificação de integridade, e não grava na memória.

recall({ query: "connection check", limit: 1 })

Resposta esperada (formato literal)

Uma chamada bem-sucedida retorna o formato de texto classificado público abaixo; a referência e o conteúdo são valores reais do espaço de memória autorizado.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Primeira tarefa útil: Ciclo de vida de memória sintética

Exercite a tarefa completa de memória sintética dentro do ChatGPT:

• 1. Salvar fato sintético: Peça ao ChatGPT para chamar remember com o conteúdo "Demo project timestamps use UTC." e caminho "projects/demo-onboarding/conventions".
• 2. Transição sem estado: Abra uma conversa totalmente nova no ChatGPT para garantir que nenhuma memória da conversa anterior seja transmitida.
• 3. Recall com atribuição de fonte: Peça ao ChatGPT para lembrar "demo project timestamp format". Confirme Reference e Location retornados.
• 4. Corrigir memória: Peça ao ChatGPT para chamar update_memory com o ID ativo, atualizando a convenção para a formatação ISO 8601.
• 5. Limpeza opcional: Peça ao ChatGPT para chamar forget com o ID da memória quando os testes forem concluídos.

Recursos e ferramentas de perfil

O ChatGPT tem acesso a ferramentas qualificadas por perfil definidas no contrato de documentação do MCP para o perfil chatgpt-public:

• Ferramentas de memória principais: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Ferramentas de projeto e contexto: get_mcp_identity, get_project_summary, project, todo, update_state, record_event, restore_memory, analyze_memory_text, memory_overview.
• Espaços de trabalho interativos: open_project_workspace, open_todo_board, open_ledger, ledger.

Limitações e limites

Limites operacionais e restrições para a integração do ChatGPT:

• Limite do espaço de trabalho: O acesso à memória é estritamente confinado ao espaço de trabalho do usuário autorizado.
• Suporte a Skill: O ChatGPT executa chamadas de ferramentas remotamente e não executa skills locais independentes do Node.js.
• Sessão OAuth: Sessões OAuth inativas podem expirar periodicamente, exigindo uma reautorização no navegador com um clique.

Erros comuns

Falhas de OAuth específicas do ChatGPT são mapeadas para as respostas reais do endpoint de token:

• invalid_grant — O código de autorização é inválido, expirou ou já foi usado: reconecte o ChatGPT e autorize novamente.
• invalid_target — O recurso OAuth não corresponde a este servidor MCP: reinicie a conexão usando https://xmemo.dev/mcp como recurso.
• 403 insufficient_scope — A concessão não inclui memory:read ou memory:write: aprove o escopo solicitado e reconecte.

Atualização e remoção

Procedimentos de manutenção para o ChatGPT:

• Atualização: Atualize o cliente ChatGPT ou autentique-se novamente para atualizar as definições das ferramentas.
• Remoção: Remova a conexão do XMemo em ChatGPT Settings -> Connected Accounts / MCP.