> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# MCP settings

> Enable MCP, pair the CLI, write permissions, and port

## Entry and prerequisites

**Settings → MCP**

* Requires [Pro](/subscribe/plan-comparison)
* A local or trusted-network [CLI](/cli/installation) reaches app capabilities through MCP

## Enable steps

<Steps>
  <Step title="Turn on the switch">Enable MCP Service.</Step>
  <Step title="Confirm the port">Default is often **5555** (follow the UI); avoid port conflicts.</Step>
  <Step title="Permission sub-switches">As needed: read private notes, local writes, batch writes, replace-style writes, etc.</Step>
  <Step title="Pair">Copy the pairing command and run it in Terminal (below).</Step>
</Steps>

## Pairing

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
starcat pair "starcat-pair://connect?..."
starcat doctor
```

* 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/installation), [CLI usage](/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.

## Related

* [Skill](/cli/skill)
* Design background (advanced): `docs/3-设计/详细设计/34-StarcatCLI与外部MCP桥接设计.md` in the repo