ConectarConectarClaude (claude.ai)

MCP Client

Claude (claude.ai)

Conecte Claude en claude.ai como conector personalizado al endpoint MCP alojado de Streamable HTTP con OAuth y los ámbitos memory:read y memory:write.

Requisito previo

Use Claude con compatibilidad con conectores personalizados y una cuenta válida de XMemo. Datos de conexión:

  • Interfaz: Claude en la web (claude.ai), conectado mediante un conector personalizado.
  • URL de conexión: https://xmemo.dev/mcp.
  • Transporte: Streamable HTTP (streamable-http).
  • Modo de autenticación: código de autorización OAuth 2.0 con PKCE y Dynamic Client Registration (registro dinámico de clientes).
  • Ámbitos: memory:read y memory:write.
  • Cuenta: cuenta válida de XMemo en https://xmemo.dev.

Añadir XMemo como conector personalizado

Añada el servidor MCP alojado en Claude. La URL de conexión es el único ajuste del servidor:

  • 1. En Claude, abra Customize > Connectors y elija Add custom connector. Enlace directo: https://claude.ai/customize/connectors?modal=add-custom-connector.
  • 2. Nombre: XMemo.
  • 3. URL del servidor MCP remoto: https://xmemo.dev/mcp.
  • 4. Añada el conector y haga clic en Connect para iniciar OAuth.

Aprobar el acceso con OAuth

Claude se registra como cliente OAuth mediante Dynamic Client Registration y abre la página de autorización de XMemo en su navegador. Inicie sesión y apruebe memory:read y memory:write en el consentimiento. Claude recibe su credencial de esta concesión OAuth.

No añada un token bearer

El conector personalizado no necesita API key. No introduzca una API key de XMemo, XMEMO_KEY ni un token bearer en el conector; la concesión OAuth proporciona la credencial y sus ámbitos.

Activar XMemo en una conversación

Vuelva a Claude y active XMemo para la conversación. Claude descubre entonces las herramientas de XMemo con sus títulos y anotaciones de seguridad.

Probar con una llamada real a recall

Haga que la primera llamada sea de solo lectura. Es una invocación real de recall, no un marcador de comprobación de estado, y no escribe en la memoria.

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

Respuesta esperada (forma literal)

Una llamada correcta devuelve la forma de texto clasificado pública que se muestra abajo; 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>

Herramientas disponibles en Claude

En el perfil claude-public, Claude ve 27 herramientas. Se agrupan a continuación por anotación de seguridad: las herramientas de lectura nunca cambian datos, las de escritura añaden, completan o restauran registros y las destructivas pueden sobrescribir, cambiar o eliminar registros existentes. Las herramientas con una página de referencia propia están enlazadas; las demás solo se describen en esta página.

Herramientas de lectura

De solo lectura e idempotentes; estas herramientas no cambian los datos almacenados:

  • get_mcp_identity (Check XMemo connection): devuelve la identidad autenticada del conector y los ámbitos de memoria concedidos.
  • [search_memory](/docs/tools/search) (Search XMemo memories): busca registros visibles de memoria con ámbito o de equipo.
  • [recall](/docs/tools/recall) (Recall XMemo memory): recupera las memorias visibles más relevantes.
  • [recall_context](/docs/tools/recall-context) (Build XMemo context): crea un paquete de contexto acotado a partir de memorias visibles.
  • memory_overview (Show XMemo memory overview): resume las memorias visibles y la actividad reciente.
  • memory_stats (Show XMemo memory statistics): devuelve estadísticas agregadas sobre las memorias visibles.
  • memory_activity (Show XMemo memory activity): muestra una cronología segura de los cambios en su propia memoria sin exponer registros de auditoría sin procesar.
  • analyze_memory_text (Analyze XMemo memory text): cuenta una palabra o frase exacta en las memorias visibles.
  • explain_memory (Explain XMemo memory): explica por qué existe una memoria visible o por qué coincidió con una consulta.
  • list_memory_todos (List XMemo memory TODOs): enumera los TODO y elementos de acción basados en memoria; así es como Claude lee los TODO.
  • list_ledger_transactions (List XMemo Ledger transactions): enumera los registros visibles de Ledger.
  • get_monthly_ledger_summary (Summarize XMemo Ledger by month): resume por mes los registros visibles de Ledger.
  • read_memory (Read Memory): lee una página acotada de una memoria exacta, o de un Document autorizado mediante su referencia de documento, tal como la devuelven recall o la búsqueda.
  • get_project_context (Get project context): lee el contexto autorizado de un proyecto que usted posee o al que puede acceder.

Herramientas de escritura

Estas herramientas añaden, completan o restauran registros y no están marcadas como destructivas:

  • add_expense (Record an XMemo Ledger transaction): crea un registro estructurado de Ledger.
  • complete_memory_todo (Complete XMemo memory TODO): marca como completado un TODO o elemento de acción existente basado en memoria.
  • create_memory_todo (Create XMemo memory TODO): crea un TODO o elemento de acción basado en memoria.
  • [remember](/docs/tools/remember) (Remember in XMemo): crea o deduplica una memoria con ámbito.
  • restore_memory (Restore XMemo memory): restaura un registro eliminado por forget en su modo predeterminado de eliminación reversible.
  • record_event (Record a milestone): añade un evento de hito o traspaso; nunca edita ni elimina registros existentes.
  • create_pending_decision (Save a pending decision): guarda una decisión no resuelta con su contexto y opciones para revisarla más tarde.
  • resolve_decision (Resolve a pending decision): registra el resultado elegido para una decisión pendiente exacta y la cierra conservando su historial.

Herramientas destructivas

Estas herramientas están marcadas como destructivas porque pueden sobrescribir, cambiar o eliminar registros existentes:

  • [forget](/docs/tools/forget) (Forget XMemo memory, TODO, or Ledger transaction): elimina una memoria, un TODO o un registro de Ledger seleccionado; consulte Eliminación y recuperación más abajo.
  • update_memory (Update XMemo memory): sobrescribe campos de una memoria seleccionada mediante su referencia exacta.
  • update_state (Save working state): guarda o reemplaza un punto de control de estado de trabajo con nombre para que una conversación posterior pueda reanudarlo.
  • [todo](/docs/tools/todos) (Manage XMemo TODOs): crea, actualiza o completa sus propios TODO; consulte TODO en Claude más abajo.
  • project (Manage XMemo project): crea un proyecto o cambia las memorias, decisiones, enlaces de documentos y conversaciones, o la configuración de un proyecto autorizado.

Eliminación y recuperación

La eliminación mediante forget es recuperable salvo que usted solicite explícitamente una eliminación permanente:

  • Predeterminado: forget realiza una eliminación reversible (soft delete).
  • Deshacer: restore_memory restaura un registro eliminado de forma reversible.
  • Permanente: forget con mode='hard' es permanente e irrecuperable. Requiere su confirmación explícita y un registro eliminado de forma permanente no se puede restaurar.

TODO en Claude

En Claude, la herramienta todo solo crea, actualiza o completa TODO. Claude lee los TODO con list_memory_todos. La página de referencia de todo describe el despachador completo; en Claude, úsela solo para estas tres acciones.

Claude Desktop

Empiece en Claude Desktop con el mismo conector personalizado y flujo OAuth. La configuración local con una API key sigue siendo una alternativa:

  • Recomendado: añada XMemo como conector personalizado con https://xmemo.dev/mcp y complete OAuth. No se necesita API key.
  • Alternativa: configure el proxy stdio de origen xmemo-mcp o mcp-remote en claude_desktop_config.json con una API key de XMemo. Consulte la [descripción general de MCP](/docs/mcp/overview) para la configuración del proxy stdio.

Claude Code

Claude Code usa una configuración independiente. Consulte [Claude Code](/docs/mcp/claude-code) para el Skill independiente y la configuración MCP directa.

Errores comunes

Los fallos de OAuth corresponden a las respuestas reales del endpoint de tokens:

  • invalid_grant — El código de autorización no es válido, ha caducado o ya se utilizó: vuelva a conectar XMemo en Claude y autorice de nuevo.
  • invalid_target — El recurso OAuth no coincide con este servidor MCP: elimine el conector y vuelva a añadirlo con https://xmemo.dev/mcp.
  • 403 insufficient_scope — La concesión no incluye memory:read o memory:write: apruebe ambos ámbitos y vuelva a conectar.

Actualización y eliminación

Procedimientos de mantenimiento del conector de Claude:

  • Reconectar: si Claude muestra un mensaje de autorización o reconexión para XMemo, vuelva a conectar el conector y complete OAuth de nuevo.
  • Eliminación: elimine el conector personalizado de XMemo de la configuración de conectores de Claude.

Fuente: Matriz de capacidades del cliente