> ## 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 设置

> 启用 MCP、配对 CLI、写权限与端口

## 入口与前提

**设置 → MCP**

* 需要 [Pro](/zh-Hans/subscribe/plan-comparison)
* 本机或可信任网络上的 [CLI](/zh-Hans/cli/installation) 通过 MCP 访问 App 能力

## 启用步骤

<Steps>
  <Step title="打开开关">启用 MCP Service。</Step>
  <Step title="确认端口">常见默认 **5555**（以界面为准）；避免端口冲突。</Step>
  <Step title="权限子开关">按需允许：读私有笔记、本地写入、批量写入、替换式写入等。</Step>
  <Step title="配对">复制配对命令，在终端执行（见下）。</Step>
</Steps>

## 配对

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

* URI 约 **5 分钟**有效、单次兑换
* 必须在 App 内**确认设备**
* 长期凭据存系统钥匙串 / Credential Manager

完整说明：[CLI 安装](/zh-Hans/cli/installation)、[CLI 使用](/zh-Hans/cli/usage)。

## 安全要点

* 写命令默认 dry-run，需 `--apply`
* 远程连接要求 TLS 与证书指纹约束（见 CLI 安全模型）
* 权限与审计由 App 执行，CLI 不直读数据库

## Agent 安装片段

设置页可复制 Claude / Codex 等 MCP 配置片段，将 `starcat mcp` 注册为 MCP server。

## 相关

* [Skill](/zh-Hans/cli/skill)
* 设计背景（高级）：仓库内 `docs/3-设计/详细设计/34-StarcatCLI与外部MCP桥接设计.md`