Skip to main content

​
Entry and prerequisites

Settings → MCP
  • Requires Pro
  • A local or trusted-network CLI reaches app capabilities through MCP

​
Enable steps

1

Turn on the switch

Enable MCP Service.
2

Confirm the port

Default is often 5555 (follow the UI); avoid port conflicts.
3

Permission sub-switches

As needed: read private notes, local writes, batch writes, replace-style writes, etc.
4

Pair

Copy the pairing command and run it in Terminal (below).

​
Pairing

  • The URI is valid for about 5 minutes and is single-use
  • You must confirm the device in the app
  • Long-lived credentials live in Keychain / Credential Manager
Full details: CLI installation, CLI usage.

​
Security notes

  • Write commands default to dry-run; use --apply to commit
  • Remote connections require TLS and certificate fingerprint constraints (see the CLI security model)
  • Permissions and audit run in the app; the CLI does not read the database directly

​
Agent install snippets

Settings can copy MCP config snippets for Claude, Codex, etc., registering starcat mcp as an MCP server.
  • Skill
  • Design background (advanced): docs/3-设计/详细设计/34-StarcatCLI与外部MCP桥接设计.md in the repo
Last modified on July 22, 2026