PatchX Freenote Agent

Help me connect PatchX Freenote MCP and install the PatchX Freenote MCP Skill when the client supports Agent Skills. Use the production service at https://freenote.patch-x.cn/ and the setup page at https://freenote.patch-x.cn/mcp/setup/; if existing configuration explicitly points to the old test service, update the server address used for this connection to production first. First, if this is a local command-capable environment, run npx -y patchxnote-agent@latest skill install on this machine so future or long sessions remember the PatchX Freenote SOP; if the current client does not support Skill installation, do not treat that as a connection blocker and continue with MCP setup according to the client's capabilities. Identify the MCP client you are running in: if this is a local MCP client such as Codex, Cursor, VS Code, Claude Desktop, Claude Code, or Windsurf, run npx -y patchxnote-agent@latest setup --client <client-id> on this machine in the same OS/runtime that will later launch the MCP server. If this is an AI client or cloud platform that cannot run local commands but supports Remote MCP, custom connectors, custom MCP services, or tool plugins, create a custom MCP connector named PatchX Freenote MCP and connect it with this PatchX Freenote Remote MCP URL: https://freenote.patch-x.cn/mcp. If you are not sure which client ID or config format to use, local clients should first run npx -y patchxnote-agent@latest mcp config and use the printed generic stdio config, while remote clients should look for a Remote MCP Server URL, MCP Server URL, or Custom Connector setup entry. For login, open the browser and let me complete PatchX Freenote phone-code authorization there; do not ask me to paste OTP codes, OAuth codes, authorization codes, access tokens, refresh tokens, or webhook secrets into chat. After setup, call patchxnote_get_current_user and patchxnote_list_memories with {"platform":"mobile","limit":5} to verify it works. References: https://github.com/ZsTs119/patchx-freenote-agent and https://patchx2025.feishu.cn/wiki/PnVRwYT7IirFPckairGcWPnHnCd

实用的技能安装器选项：

安装器支持幂等操作。如果现有的 patchxnote-mcp 目录内容不同，且并非由此软件包管理，安装器会拒绝覆盖，除非指定 --force。受管理的安装包含 .patchxnote-agent-skill.json，其中记录了软件包版本和源哈希。

对于使用标准 skills CLI 的用户，以下 Codex 示例会从 GitHub 安装到当前项目中。它安装的是技能，而不是 MCP 连接。请选择此方式或上文通过 npm 安装的方式之一。

npx -y skills add ZsTs119/patchx-freenote-agent --skill patchxnote-mcp --agent codex --yes

本地设置支持以下客户端 ID：

vscode, cursor, codex, claude-code, claude-desktop, windsurf, trae, qoder, workbuddy

vscode、cursor、codex、claude-desktop 和 windsurf 在确认后可以写入本地配置文件。V1 中，claude-code、trae、qoder 和 workbuddy 会返回手动命令或可复制的配置。飞书 Aily、豆包企业版、腾讯 Agent 开发平台和企业版 WorkBuddy 等平台客户端需要使用托管的远程 MCP 网关，并在平台控制台中接受，而不是使用本地 npx。

实用的设置标志：

patchxnote setup --client cursor --dry-run --print-config
patchxnote setup --client cursor --yes
patchxnote setup --client cursor --no-browser
patchxnote setup --all-local-supported --dry-run
patchxnote setup --client cursor --output json

请在之后将运行 MCP 的同一操作系统／运行时中执行设置。例如，Windows 桌面编辑器需要使用 Windows 凭据管理器中的凭据，而 WSL 或远程 VS Code 会话则需要在相应的 Linux 运行时中配置凭据。

对于通用的本地 stdio MCP 主机，请使用以下命令输出的纯 JSON：

npx -y patchxnote-agent@latest mcp config

默认配置如下：

{
  "mcpServers": {
    "patchxnote": {
      "command": "npx",
      "args": ["-y", "patchxnote-agent@latest", "mcp", "serve"]
    }
  }
}

某些客户端可能要求使用包装器特有的字段，例如 type: "stdio"，或使用不同的顶层键，但 command 和 args 保持不变。如果客户端拒绝 npx、会终止较慢的冷启动进程，或要求使用已列入允许列表的绝对路径，请使用以下命令输出的备用方案：

npx -y patchxnote-agent@latest install --print-config

备用配置使用已安装的二进制文件路径：

{
  "mcpServers": {
    "patchxnote": {
      "command": "/absolute/path/to/patchxnote",
      "args": ["mcp", "serve"]
    }
  }
}

账户和记录查询

Webhook 配置和发送

AI 结果检查

记录工具需要显式指定 platform 参数：mobile 或 desktop。当服务端有模型 IO 数据时，记录列表现在会同时包含正式保存的结果和可读的模型生成输出。patchxnote model-io list 仍是较底层的 AI 处理列表，可用于查找请求 ID 并按任务或状态筛选。

Webhook MCP 工具与 CLI 共用相同的本地配置、钥匙串、模板和发送器模块。它们不会返回完整的 Webhook URL 或签名密钥；只有在 MCP 客户端显式调用发送工具时，发送调用才会执行外部网络请求。

AI 结果工具是专用的检查工具。它们可能会公开已登录用户的源文本或 AI 负载，因此只能通过可信的本地 MCP 主机使用。较大的字段应写入明确指定的本地 out 文件。

以下示例是相互独立的命令。请根据任务选择操作；它们不是需要从头到尾运行的脚本。

Browser MCP 登录和本地 MCP 服务：

patchxnote version
patchxnote mcp login
patchxnote mcp status
patchxnote mcp config
patchxnote setup --client cursor
patchxnote mcp serve

终端 CLI 登录：

patchxnote login
patchxnote auth status

列出 AI 处理任务并导出结果：

patchxnote model-io list --platform mobile
patchxnote model-io source-text --request-id <request_id> --platform mobile --out ./source.txt
patchxnote model-io provider-response --request-id <request_id> --platform mobile --out ./provider-response.json
patchxnote model-io parsed-result --request-id <request_id> --platform mobile --out ./parsed-result.json
patchxnote model-io packaged-result --request-id <request_id> --platform mobile --out ./packaged-result.json
patchxnote model-io export --request-id <request_id> --platform mobile --out ./model-io.json

需要获取较低层级 AI 处理任务的 request_id 时，请使用 patchxnote model-io list --platform mobile|desktop。MCP patchxnote_list_memories 会返回 id 和 platform，用于记录渲染、草稿、webhook 工作流和模型 IO 字段工具；对于模型生成的条目，该 id 可能与 request_id 相同。

配置并发送 webhook：

patchxnote webhook set "Product Feishu" --type feishu --url-stdin
patchxnote webhook list
patchxnote webhook test "Product Feishu"
patchxnote webhook draft --memory-id <memory_id> --platform mobile --out ./patchxnote-drafts/example
patchxnote webhook send --target "Product Feishu" --file ./message.md
patchxnote webhook send --target "Product Feishu" --draft ./patchxnote-drafts/example
patchxnote webhook remove "Product Feishu"

实用的全局标志：

--server-base-url <url>   PatchX Freenote API base URL
--profile <name>          local profile name
--output json             machine-readable output where supported
--config <path>           non-secret config file path

npm 包是一个轻量的安装器／启动器封装：

npx -y patchxnote-agent@latest mcp login
npx -y patchxnote-agent@latest mcp status
npx -y patchxnote-agent@latest mcp config
npx -y patchxnote-agent@latest mcp serve
npx -y patchxnote-agent@latest skill install
npx -y patchxnote-agent@latest login
npx -y patchxnote-agent@latest setup --client cursor
npx -y patchxnote-agent@latest install
npx -y patchxnote-agent@latest update

Webhook URL 和可选的 Feishu／DingTalk 签名密钥会存储在本地安全凭据存储中，而不是非机密配置文件中。--url-stdin 和 --secret-stdin 可避免将内容写入 shell 历史记录。CLI 和 MCP 的 webhook 发送仅支持手动操作，不会跟随重定向，并会直接显示提供方错误。

patchxnote model-io export 是首选的完整 AI 处理导出命令。patchxnote webhook export-model-io 仍可用于兼容性支持。

0.2.12 及更高版本默认使用生产环境。现有的显式 --server-base-url 标志、PATCHXNOTE_SERVER_BASE_URL／旧版 PATCHNOTE_SERVER_BASE_URL 环境变量，以及 server.base_url 配置值都会覆盖此默认设置；请同时更新或移除终端和 MCP 宿主配置中的测试服务器覆盖项。

请在启动 MCP 的同一操作系统／运行环境和配置档案中运行 mcp login，然后检查 mcp status --verify。OAuth 凭据与服务器地址绑定，因此测试环境登录不会通过生产环境的身份验证。此更新不会迁移测试账号或记录。如需保留两个环境，请使用不同的配置档案，并为每个档案明确指定基础 URL。

0.2.15 版本亮点

• 修正 MCP Registry 命名空间，以保留 GitHub 所有者名称的大小写：io.github.ZsTs119/patchxnote-agent。
• 添加 mcp serve 启动参数，并在发布前验证发布元数据。
• 保持现有运行时行为和 Skill 许可证不变。

0.2.13 版本亮点

• 统一 README、npm、内置 Skill 和市场文案中的中英文设置提示词。
• 明确列出生产服务、Remote MCP 端点、设置页面和 App 下载 URL；切换时必须更新现有测试地址覆盖项。
• 将 npm 和插件主页元数据指向生产设置页面，并在当前指南中废弃过时的域名提案。

0.2.12 版本亮点

• 默认使用生产 API https://freenote.patch-x.cn；托管 MCP 使用 https://freenote.patch-x.cn/mcp。
• 保留明确的服务器标志、环境变量和配置文件覆盖项，供测试环境使用。
• 说明生产环境重新登录以及现有测试服务器配置的迁移方法。

0.2.11 版本亮点

• 在 npm 软件包中内置规范的 PatchX Freenote MCP Skill。
• 添加 npx -y patchxnote-agent@latest skill install，以便通过 npm 安装 Skill，无需依赖单独的 skills CLI 或克隆 GitHub 仓库。
• 使 Skill 安装具备幂等性、记录托管标记，并在未明确使用 --force 时保护手动编辑过的 Skill 文件夹。
• 扩展 Skill 软件包同步和验证，确保 OpenAI、Claude 和 npm 副本与 skills/patchxnote-mcp/ 完全一致。
• 更新单行设置提示词和发现元数据，优先使用 npm 内置的 Skill 安装程序，同时保留 MCP 设置、浏览器 OAuth 和工具验证。

0.2.10 版本亮点

• 在 skills/patchxnote-mcp/ 添加可复用的 PatchX Freenote MCP Skill，使兼容的 AI 客户端在开启新会话或进行长会话时都能沿用设置和使用 SOP。
• 添加 OpenAI/Codex、Claude Code、Agent Skills、MCP Registry、Smithery 和第三方目录的草案打包与列表材料。
• 通过 server.json 和 package.json#mcpName 添加 MCP Registry 元数据，并提供本地验证和 stdio 冒烟测试脚本作为发布凭证。
• 更新单行设置提示词，使 Agent 在支持时安装 Skill，然后运行 MCP 设置、浏览器 OAuth 和工具验证，无需询问用户在聊天中粘贴代码或 token。