# ChatGPT

Conecte o ChatGPT por meio de MCP Streamable HTTP hospedado e OAuth de navegador com escopos memory:read e memory:write.

- Canonical: https://docs.xmemo.dev/pt-br/docs/mcp/chatgpt
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 0a34bc1a4a60d47cc1fcab5b55616f0d81c50ddc2815030f687094efa4fdc4a5
- Edition-Digest: a4c1ae0fd6488480978818c0d3a3f6df43e9461033d07bfb7699b6ce17699c1c
- Source-Revision: sha256:9bc37480fb26a371846f25bf5ea25d86ddd8bd3808e3df34131ef15403069090

## 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:

```text
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:

```json
{
  "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.

```text
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.

```text
### 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.

## ChatGPT / OpenAI Apps SDK

OAuth marketplace lane: configure the hosted MCP URL and OAuth metadata in the OpenAI app dashboard; never paste XMEMO_KEY or Bearer tokens into the listing.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "transport": "streamable-http",
      "auth": {
        "type": "oauth2",
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      }
    }
  }
}
```