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

  1. Open "Settings → MCP services" and switch it on — effective immediately, no restart;
  2. 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

  1. Open "Settings → MCP services" and confirm the service is on;
  2. 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;
  3. 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.