Skip to content
Connect your AI

Muse Code

Use Muse Code with persistent project memory: read specifications and research before coding, capture decisions as they happen and leave handoffs for your next session or another connected agent.

Let Muse Code prepare setup

Paste this into Muse Code with its configuration-editing tools enabled. It can prepare the connection; you complete browser sign-in and any host approval.

Paste into your agent

Configure manually

Merge this entry into ~/.config/muse/settings.json, preserving existing settings and other servers:

json
{
  "mcp_servers": {
    "mindwiki": {
      "transport": "streamable_http",
      "url": "https://api.mindwiki.io/mcp",
      "enabled": true,
      "mode": "optional"
    }
  }
}

Authenticate from your terminal:

bash
muse mcp login mindwiki

Return to Muse Code and use /mcp to inspect the connection. Optional mode lets a coding session continue if the vault is temporarily unreachable. Choose required mode only for workflows that should stop without vault access.

Complete the MindWiki connection

On MindWiki's authorization page, MindWiki Email + Access Key is the recommended sign-in method. Existing email-and-password accounts can choose Legacy Sign In; Sign in with Apple remains available. All methods open the same account and vault—no replacement account is required. New users choose Create a new vault, save their generated access key and continue. Review the requested permissions and choose read-only access when that is all you need. Access Keys explains the supported methods.

Return to your agent after approving. Your sign-in key belongs on MindWiki's pages, not in chat or an MCP configuration file. The client handles its own OAuth credentials.

Check that it works

Ask your agent:

text
Use MindWiki to read my account status, then search for a note about one of my projects. Read a matching page and cite its title and path. Tell me if the vault is empty rather than making up a result.

Inspect the tool result and compare it with a page in MindWiki Cloud. For a new vault, the agent can read the operating guide and initialize the starter pages when account status permits it.

To check saving after granting write or capture access, ask “Save a new MindWiki capture titled Connection check with today's date, then read it back and give me its path.” The same file is available in your MindWiki apps.

Useful coding workflows

  • “Read the project handoff in MindWiki and summarize the remaining work before changing code.”
  • “Save the architecture decision with its rationale, alternatives and links to the relevant notes.”
  • “Capture the verified fix for this issue and explain how to reproduce the original failure.”

Muse Code and Muse are separate clients. Connect each to the same MindWiki account if you want them to share the vault.

Troubleshooting

If authentication fails, confirm the server is enabled and uses streamable_http, then run muse mcp login mindwiki again. A managed policy may control OAuth registration. To remove the local login, use muse mcp logout mindwiki; revoke the grant in MindWiki as well when you want to invalidate server-side access.

Permissions and disconnecting

Available tools depend on the scopes you approved, your MindWiki plan and vault permissions, and the tools your client exposes. Free includes one external AI connection with core vault tools. See MCP tool access.

To disconnect just this client, revoke its grant in MindWiki Connections. Other agents keep their own connections. Never send access keys or OAuth tokens to support.

More help

MCP tools · Agent permissions · All AI agents

Setup reference: Muse Code extensibility documentation, checked October 20, 2026.