Muse Code

Requisito previo

Use una instalación de Muse Code que lea los servidores MCP desde ~/.config/muse/settings.json. Muse Code se conecta a XMemo como cliente OAuth, por lo que el archivo de configuración no contiene ningún token.

• Endpoint: https://xmemo.dev/mcp.
• Modo de autenticación: OAuth (PKCE en el navegador) con registro dinámico de clientes.
• Archivo de configuración: ~/.config/muse/settings.json. Debe contener "schema_version": 1.
• Ámbitos concedidos: memory:read, memory:write, knowledge:read y knowledge:write.
• Configuración automatizada: xmemo setup muse-code llegará pronto con la próxima versión de XMemo CLI. Hasta entonces, use la configuración manual que aparece a continuación.

Añadir XMemo a settings.json

Edite ~/.config/muse/settings.json desde un terminal fuera de Muse; el sandbox de Muse rechaza las modificaciones de este archivo realizadas dentro de una sesión de Muse. Añada una entrada xmemo bajo la clave camelCase de nivel superior mcpServers. Este archivo no debe contener ningún token ni encabezado Authorization.

{"schema_version": 1, "mcpServers": {"xmemo": {"type": "streamable-http", "url": "https://xmemo.dev/mcp", "mode": "optional"}}}

Conservar solo mcpServers

La documentación web pública de Muse todavía muestra una clave snake_case mcp_servers, que está obsoleta. Si settings.json contiene tanto mcpServers como mcp_servers, Muse descarta todos los servidores MCP. Cambie el nombre de un bloque mcp_servers existente a mcpServers y combine sus entradas en él, de modo que el archivo conserve solo mcpServers.

Iniciar sesión con OAuth

Ejecute el comando de inicio de sesión para el servidor xmemo y apruebe el acceso en el navegador. En una máquina sin interfaz de navegador, añada --headless.

muse mcp login xmemo
# Without a browser UI:
muse mcp login xmemo --headless

Reiniciar el cliente

Reinicie Muse después de iniciar sesión para que cargue el servidor xmemo con la nueva concesión de OAuth.

Verificar las herramientas de XMemo

Pida a Muse que enumere las herramientas de XMemo sin llamar a ninguna de ellas.

muse exec "List the names of the tools you have from the xmemo MCP server. Do not call any tools."

Probar con una llamada real a recall

Haga que la primera llamada MCP sea de sólo lectura. Es una invocación real de recall, no un marcador de verificació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 pública de texto clasificado que aparece 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>

XMemo Skill

Muse examina ~/.agents/skills, ~/.claude/skills y ~/.codex/skills, por lo que una XMemo Skill ya instalada para Claude Code o Codex funciona en Muse sin cambios.

Errores comunes

Muse Code se conecta mediante OAuth; la mayoría de los errores provienen de la clave de configuración, del paso de inicio de sesión o del sandbox.

• No aparece ninguna herramienta xmemo: settings.json contiene tanto mcpServers como mcp_servers, por lo que Muse descartó todos los servidores MCP. Conserve solo mcpServers.
• invalid_grant: la autorización no es válida, ha caducado o ya se utilizó, o la conexión seleccionada ya no es válida. Vuelva a ejecutar muse mcp login xmemo y, a continuación, reinicie Muse.
• 403 insufficient_scope: los ámbitos aprobados no cubren la llamada. Vuelva a iniciar sesión y apruebe los ámbitos de memory y knowledge.
• Se rechazan las modificaciones de settings.json: el cambio se realizó dentro de una sesión de Muse. Edite el archivo desde un terminal externo.