文档Agent 接入
连接 Claude Code、Codex 或 Cursor(MCP)
有了 Agent 接入,你常用的 AI Agent 可以通过 Mac 上的 SwiftSales 读取销售和评论。密钥始终留在 SwiftSales 里,每个 Agent 能做什么由你决定。
开始之前
- 一台装有 macOS 26 或以上的 Mac,并安装了 SwiftSales。
- 已连接的团队;也可以先在演示模式中试用。
- Agent 接入包含在永久高级版中,7 天免费试用期间也可以使用。
打开 Agent 接入
- 打开设置在 Mac 上的 SwiftSales 中选择“SwiftSales › 设置”,再点边栏里的“Agent 接入”。
- 打开 Agent 接入看过 Agent 能读取哪些数据后,选择“同意并打开”。之后随时可以关闭。
- 把 SwiftSales 添加到你的 Agent在“连接”中点你的 Agent 旁边的按钮,各个 Agent 的做法见下文。
添加到你的 Agent
Agent怎么做
Claude Code
点“复制安装命令”,粘贴到终端并按回车。
Codex
点“复制安装命令”,粘贴到终端。页面上也会显示路径,可填到 Codex 的 MCP 设置里。
Cursor
点“添加到 Cursor”,再在 Cursor 里点“Install”。
Claude
点“保存扩展…”,打开保存的文件,再选择“安装”。
Xcode
点“复制配置”,粘贴到 Xcode 编码助手的配置里。
SwiftSales 为 Claude Code 复制的命令是这样的,路径是 SwiftSales 在你的 Mac 上的实际位置:
claude mcp add --scope user swiftsales -- <SwiftSales 的路径>/Contents/Helpers/SwiftSalesAgent.app/Contents/MacOS/SwiftSalesAgent
SwiftSales 从不改写其他 App 的配置文件。“连接”最下面的“显示路径”可以显示并复制路径,供其他支持 MCP 的 Agent 使用。
Agent 第一次连接时
Agent 第一次使用 SwiftSales 时,Mac 上会询问“允许“Claude Code”使用 SwiftSales?”。新的 Agent 从“只读”开始,可以查看你的所有 App。你可以当场选择更少的 App 或更高的级别,也可以之后在设置里改。
不需要输入配对码,Agent 的配置里也不保存任何东西。选择“不允许”后,这个 Agent 不能使用 SwiftSales,直到你在设置里修改。
更新 Claude Code 插件
来自其他插件市场的插件,Claude Code 只在你打开自动更新后才会自动更新。想自动收到新版本,请打开 /plugin › Marketplaces › swiftsales-agent,选择 Enable auto-update。
想现在就更新,运行:
claude plugin update swiftsales@swiftsales-agent
或在 /plugin › Installed 里选择 Update now。已经打开的会话运行 /reload-plugins 后用上新版本。
在演示模式中试用
演示模式下,“设置 › Agent 接入”用示例数据展示全部功能:连接列表、一段示例会话和一张示例批准卡。不需要密钥,也不需要安装 Agent。
下一步
更新于 2026年10月21日