Claude Desktop

Connect MindWiki to Claude Desktop (the native macOS / Windows app) using the remote MCP / OAuth flow. The setup is the same as Claude.ai — one URL, no manual token.

What you get

Same capability set as Claude.ai. Claude Desktop can search, read, capture, write, and call all 20 MindWiki tools when granted the right scope.

Setup

  • Open Settings in Claude Desktop.
  • Find the section for Connectors, MCP servers, or Custom MCP. The exact label varies by release.
  • Choose Add remote MCP server (or equivalent).
  • Paste this URL:

`

https://api.mindwiki.io/mcp

`

  • Keep the auth method set to OAuth if prompted.
  • Claude Desktop opens a browser to the MindWiki approval page.
  • Sign in to MindWiki, click Approve, return to Claude Desktop.

After this, your active session is visible at mindwiki.io/account/connections and in the Agents → Sessions view in the MindWiki macOS app.

Verify it works

Try a prompt like:

Read my MindWiki page about agent-native memory and suggest 
one useful follow-up.

Claude Desktop calls mindwiki_read_page (or first mindwiki_search, then read), processes the content, and responds. The activity log on the MindWiki side will show the calls.

What works well in Desktop

Claude Desktop has the deepest integration of the Anthropic surfaces. It runs on your machine and supports rich, multi-step tool use. The most natural workflows:

  • Capturing insights mid-conversation. "Capture this synthesis as a new MindWiki page in capture/" — Claude calls mindwiki_capture.
  • Working from project context. "Load the onboarding-redesign context pack and brainstorm the next milestone."
  • Audit and review. "Show me my MindWiki agent activity from this week and summarize what I've been doing."

Permissions

OAuth grants both read and write scopes. To run Claude Desktop in a stricter mode (e.g. read-only browsing), use the API key path instead — but for most users, full scope is the right default for a primary AI client.

To revoke, go to mindwiki.io/account/connections and remove the Claude Desktop session.

Troubleshooting

  • Claude Desktop never opens the browser approval page. Double-check the URL is exactly https://api.mindwiki.io/mcp with no trailing characters or query parameters.
  • The approval page errors. Sign out of mindwiki.io and back in, then retry the connection from Claude Desktop.
  • The connection persists but tool calls fail. Check Sessions & Activity in the macOS Agents workspace for the specific error.

Where to go next