# 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. - Canonical: https://docs.xmemo.dev/es/docs/mcp/claude - Locale: es-ES - Content-Locale: es-ES - Canonical-Content-Digest: de1a3fce819ac5cc3e4ef555fb6ba57c0ae2af9af5e91367ad4efac64a274ea3 - Edition-Digest: 71e9d89589d25171c27e57a480e049b5d0171dd671602645d920bca2c294ace4 - Source-Revision: sha256:ef049dd959bada93a714e560eece53ae72cd3ce2d2ed84bbab43191b9ae93474 ## 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. ```text 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. ```text ### XMemo Memory Results: 1. Reference: | Location: > ``` ## 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.