ChatGPT

Requisitos previos

Utilice una configuración de aplicación de OpenAI que admita un servidor MCP remoto y el punto de conexión Streamable HTTP alojado. Entornos de ejecución y requisitos previos:

• Interfaz concreta: Cliente web y de escritorio de ChatGPT (OpenAI Apps / Actions).
• Punto de conexión: https://xmemo.dev/mcp.
• Transporte: Streamable HTTP (streamable-http).
• Modo de autenticación: OAuth con ámbitos memory:read y memory:write.
• Cuenta: Cuenta válida de XMemo en https://xmemo.dev.

Instalación / configuración

En el cliente de ChatGPT o en el panel de la plataforma de OpenAI, registre la URL de MCP alojada y los metadatos de OAuth para la conexión remota:

• Configure la URL de MCP alojada en el panel de la aplicación: https://xmemo.dev/mcp.
• Solicite memory:read y memory:write en el consentimiento.
• No añada un token de portador a la lista de aplicaciones.

Establecer la credencial

Sin clave — complete OAuth en el navegador. ChatGPT recibe la credencial a través de la concesión de OAuth; no configure XMEMO_KEY ni agregue un encabezado Authorization:

No XMEMO_KEY
Complete browser OAuth in ChatGPT

Generar / confirmar XMEMO_AGENT_INSTANCE_ID

El listado revisado de OAuth de ChatGPT no tiene encabezado de identidad del lado del cliente. No invente ni pegue XMEMO_AGENT_INSTANCE_ID en la configuración de la aplicación; confirme que la atribución se gestione mediante la concesión de OAuth para esta ruta de cliente.

Conservar el bloque de configuración existente

Utilice el bloque de configuración revisado de ChatGPT. Conserve su URL alojada, modo OAuth y ámbitos solicitados; modifique solo los valores del panel local que requiera el cliente:

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

Reiniciar el cliente

Guarde la configuración de la aplicación, cierre cualquier conexión MCP obsoleta y vuelva a abrir la aplicación o conversación de ChatGPT para que cargue los metadatos de OAuth actuales.

Probar con una llamada real de recall

Haga que la primera llamada de MCP sea de solo lectura. Esta es una invocación de recall real, no un marcador de posición de verificación de estado, y no escribe memoria.

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

Respuesta esperada (forma literal)

Una llamada exitosa devuelve la forma de texto clasificado público a continuación; la referencia y el contenido son valores reales del espacio de memoria autorizado.

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

Primera tarea útil: Ciclo de vida de memoria sintética

Ejercite la tarea completa de memoria sintética dentro de ChatGPT:

• 1. Guardar hecho sintético: Pida a ChatGPT que llame a remember con contenido "Demo project timestamps use UTC." y ruta "projects/demo-onboarding/conventions".
• 2. Transición sin estado: Abra un hilo de chat completamente nuevo en ChatGPT para asegurarse de que no se transfiera memoria de la conversación.
• 3. Recall con atribución de origen: Pida a ChatGPT que recuerde "demo project timestamp format". Confirme Reference y Location devueltos.
• 4. Corregir memoria: Pida a ChatGPT que llame a update_memory con el ID activo, actualizando la convención al formato ISO 8601.
• 5. Limpieza opcional: Pida a ChatGPT que llame a forget con el ID de memoria cuando concluyan las pruebas.

Capacidades y herramientas de perfil

ChatGPT tiene acceso a herramientas calificadas por perfil definidas en el contrato de documentación de MCP para el perfil chatgpt-public:

• Herramientas de memoria principales: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Herramientas de proyecto y contexto: get_mcp_identity, get_project_summary, project, todo, update_state, record_event, restore_memory, analyze_memory_text, memory_overview.
• Espacios de trabajo interactivos: open_project_workspace, open_todo_board, open_ledger, ledger.

Limitaciones y límites

Límites operativos y restricciones para la integración de ChatGPT:

• Límite del espacio de trabajo: El acceso a la memoria está estrictamente confinado al espacio de trabajo del usuario autorizado.
• Soporte de Skill: ChatGPT ejecuta llamadas a herramientas de forma remota y no ejecuta skills locales independientes de Node.js.
• Sesión OAuth: Las sesiones OAuth inactivas pueden caducar periódicamente, lo que requiere una reautorización del navegador con un solo clic.

Errores comunes

Los fallos de OAuth específicos de ChatGPT se corresponden con las respuestas reales de los puntos de conexión de tokens:

• invalid_grant — El código de autorización no es válido o ha caducado, o ya se ha utilizado: vuelva a conectar ChatGPT y autorice de nuevo.
• invalid_target — El recurso OAuth no coincide con este servidor MCP: reinicie la conexión utilizando https://xmemo.dev/mcp como recurso.
• 403 insufficient_scope — La concesión no incluye memory:read o memory:write: apruebe el ámbito solicitado y vuelva a conectarse.

Actualización y eliminación

Procedimientos de mantenimiento para ChatGPT:

• Actualización: Actualice el cliente ChatGPT o vuelva a autenticarse para actualizar las definiciones de herramientas.
• Eliminación: Elimine la conexión XMemo en ChatGPT Settings -> Connected Accounts / MCP.