MCP Server
Connect an AI client directly to the knowledge you keep in MindWiki. The hosted MCP server gives compatible agents authorized tools to search, read, capture, write, prepare context, and propose supported improvements in the same vault you use yourself.
MCP is the connection standard; MindWiki is the persistent storage and knowledge workspace behind it. A client retrieves the pages relevant to your task and saves the useful result back to your vault.
Server details
| Setting | Value |
|---|---|
| Remote endpoint | https://api.mindwiki.io/mcp |
| Preferred transport | Streamable HTTP |
| Interactive authorization | OAuth through MindWiki |
| Hosting | Hosted by MindWiki; no local MindWiki server process required |
| Older transport support | SSE for compatible legacy clients |
Begin with Integrations for the correct installation path. Host settings differ; a connector URL field, CLI command, and editor configuration file are not interchangeable.
Connect in a few steps
- Open the client-specific guide and add MindWiki.
- Let the client open MindWiki's authorization page.
- Sign into your existing account, or complete the new-account flow.
- Review the requesting client and choose from the access levels offered.
- Approve and return to your agent.
- Refresh or enable the tool connection if your client requires it.
- Ask for account status and a real page read.
New accounts created in the agent authorization flow receive a generated sign-in access key after choosing a MindWiki email name. Save that key privately before continuing. Your client manages its OAuth credentials separately. See Access Keys.
Access levels
| OAuth scope | What it permits |
|---|---|
mcp:read | Supported retrieval and inspection tools. |
mcp:capture | Read access plus inbox capture. |
mcp:write | Read, capture, and broader supported writes. |
Legacy mcp | Read, capture, and write for older grants. |
Vault agent permissions also apply. A sufficiently broad scope does not override a disabled capability, proposal review requirement, or revision check. The approval page offers access levels within the requesting client's supported request.
For a client without OAuth support, use a dedicated scoped API key only if it supports static integration credentials. Follow API Access and the client guide. Do not substitute your account sign-in key for an API key.
Share knowledge across clients
Authorize each client against the same account. Each has its own grant to the same vault, so you can revoke one without disconnecting the others. An agent's saved note can be retrieved by another authorized agent and opened through MindWiki Cloud or your connected apps.
This continuity comes from explicit saves and reads. To resume work, ask the agent to retrieve the latest brief or handoff; to preserve work, ask it to save a useful summary. See Shared Agent Memory.
Verify the capability you need
For retrieval:
Read my MindWiki account status. Then search for Website Launch Brief, read the matching page, and tell me its path and the next action it describes.For capture, after granting the necessary access:
Capture a short note in MindWiki with today's project goal and next action. Tell me the saved path so I can open it.Inspect the source and saved result yourself. A successful read verifies retrieval, while a successful capture verifies that writing path. The MCP Tools reference explains the full catalog and update workflow.
Handle failures without losing work
| Symptom | Next step |
|---|---|
| No tools appear | Finish authentication, enable the connection, and refresh the client's tool list. |
| Authentication expired | Reauthenticate through the client. |
| Read works; write fails | Check the granted scope and vault agent permissions. |
| Tool absent in one conversation | Check that client's session or workspace tool controls. |
| Write timed out | Check the destination or retry the identical operation with the same idempotency key. |
| Edit reports a conflict | Read the current page and merge deliberately before saving again. |
MindWiki records supported tool activity for review. Manage grants in Connections and inspect the Mac Agents workspace when troubleshooting. Free, Pro, and Power currently share full product capabilities without a Free monthly operation cap; common security limits and provider policies still apply.
Next: MCP Tools, Vault Health & Permissions, and Sessions & Activity.