MCP & External AI
2026-11-15
MCP (Model Context Protocol) is an open protocol that lets AI clients drive software. The desktop app ships a built-in MCP service: once enabled, external AI such as Codex and Claude Code can create chapters, edit body text, and operate mind maps and canvases — 51 tools in total, all running locally.
Enable the service
- Open "Settings → MCP services" and switch it on — effective immediately, no restart;
- The service listens only on the local loopback (random port); the token regenerates on every launch, so other devices cannot reach it.
The 51 tools
The tool list in settings lets you untick anything you don't need — effective immediately — with "all on / read-only / all off" shortcuts. Nine groups:
- Guidance & context (8): read the usage guide and current context, capture creation views, locate resource files — how external AI gets to know your workspace;
- Content & chapters (16): list, read and create chapters and collections, write body text per revision, patch articles, full-text search, bulk import, tagging;
- Creative artifacts (4): manage mind maps and other artifact files;
- Mind maps (3): create from outline text, edit nodes incrementally, import
.xmind; - Flow canvases (4): create and update flow canvases;
- Whiteboards (3): read snapshots, batch add / edit / delete elements, connect, align, distribute, group;
- Images (5): list, read, import and update images;
- Themes (5): list, validate, install and delete themes — external AI can write and install themes for you, see Themes & Appearance;
- Tasks & records (3): check operation status, cancel running operations, view recent writes.
Attach a client
- Open "Settings → MCP services" and confirm the service is on;
- Click "Detect" to find installed clients (Claude Code, Codex CLI, OpenCode, Gemini CLI), then "One-click write" to register BigLazyCat — the original config file is backed up first;
- For other clients, copy the ready-made snippets under "Manual configuration".
How it works in one line: the client launches the app's bundled bridge with --mcp-stdio, and the bridge forwards requests to the running app. No app running, no tools.
After connecting, have the AI call get_app_guide first to learn the ropes. Step-by-step setup for Claude Desktop, Qoder, WorkBuddy and more: MCP Client Setup.
Write safety
- Every write returns a receipt — which file changed, the version, the content hash — taken from the actual disk result; submitting the same operation twice writes once;
- Before an external edit lands, the previous chapter version is kept automatically and can be rolled back in Version History;
- Call logs keep 30 days and record identities only, never body text;
- Quitting from the system tray stops the service immediately; closing the window alone does not quit — the service stays available.
Caveats
Cancelling a running operation does not roll back what was already submitted. After a mind map or canvas accepts external changes, its old undo history is cleared.