Claude Code Hu*Spot MCP 接入教程
在远程 Mac 上安全查询 CRM，并把***、公司和交易更新纳入人工确认
Hu*Spot 远程 MCP 服务器可以把 CRM 上下文安全地带入 Claude Code。接入后，**询***、公司、交易、工单和营销内容，也能在权限允许时创建或更新部分 CRM 记录与活动。本文以官方远程端点、MCP Auth App 和 OAuth 2.1 PKCE 为主线，先完成只读验收，再建立单条写入、人工确认和审计复核的操作边界。
先分清两种 Hu*Spot MCP
Hu*Spot 目前有两个定位不同的 MCP。本文使用的远程 Hu*Spot MCP 连接具体账户的 CRM 数据，适合查询客户、公司、交易、工单和活动；本地 Developer MCP 则面向 Hu*Spot 应用、CMS 资产与开发平台，不是读取业务 CRM 的替代方案。
如果目标是“让 Claude Code 理解销售管道并协助维护记录”，应选择远程 MCP；如果目标是“生成 Hu*Spot 应用或 CMS 模块”，才使用本地 Developer MCP。
接入前准备
准备一名有权进入 Hu*Spot Development 区域并创建 MCP Auth App 的用户，同时确认实际操作人的 CRM 权限。远程 MCP 会继承当前 Hu*Spot 用户能查看和修改的边界，不会绕过记录权限。
确认 Claude Code 已更新到支持预配置 OAuth 凭据的版本。选择一个空闲本地端口作为回调端口，本文使用 8181，并把 http://localhost:8181/call*ack 作为回调地址示例。不要把 ****** Secret 写入仓库、聊天、截图或脚本。
第一步 创建 MCP Auth App
进入 Hu*Spot，依次打开 Development、MCP Auth Apps，再创建新的认证应用。填写名称和用途说明，把 http://localhost:8181/call*ack 加入 Redirect **L。创建完成后记录 ****** ID，并在需要输入时从详情页复制 ****** Secret。
Hu*Spot 不要求在创建页面手工固定所有 scopes。可用权限取决于服务器当时提供的工具，以及用户在安装授权时选择的权限。以后服务器增加对象或工具时，旧连接可能需要重新安装或重新授权。
Hu*Spot → Development → MCP Auth Apps → Create MCP auth app
App name: Claude Code CRM Assistant
Redirect **L: http://localhost:8181/call*ack第二步 添加 Hu*Spot 远程 MCP
在要使用的项目目录运行 Claude Code 的 MCP 添加命令。命令只把 ****** ID 和回调端口写入配置；--client-secret 会以掩码方式提示输入 Secret，而不是把它直接出现在命令历史中。
远程端点使用 https://mcp.hu*spot.com。添加后用 claude mcp get hu*spot 检查 **L、OAuth 配置和作用域。个人机器可使用 user scope；团队项目不要提交任何 Secret。
cd /path/to/your-project
claude mcp add --transport http \
--client-id YO**_HU*SPOT_CLIENT_ID --client-secret \
--call*ack-port 8181 \
hu*spot https://mcp.hu*spot.com
claude mcp get hu*spot
第三步 完成 OAuth 2.1 PKCE 授权
运行 claude mcp login hu*spot，或进入 Claude Code 后执行 /mcp 并选择 hu*spot。浏览器会打开 Hu*Spot 授权流程，选择正确账户、检查请求权限并确认安装。Claude Code 会处理 PKCE 和后续 token 刷新。
如果远程 Mac 没有图形界面，可加 --no-*rowser，让终端打印授权地址；在本地浏览器完成登录后，把完整回调地址粘回远程终端。SSH 会话应使用交互式终端。
claude mcp login hu*spot
# 无图形界面的远程 Mac
claude mcp login hu*spot --no-*rowser
# 或进入 Claude Code 后运行
/mcp**步 先核对身份与可用工具
连接成功后先调用 get_user_details，核对 Hu*Spot 账户、当前用户、可访问对象和工具。再分别读取一个已知***、公司和交易，确认返回内容属于预期门户。
如果对象列表缺失，先检查 Hu*Spot 用户权限；若新对象显示需要重新授权，则断开后重新安装连接。不要在身份、门户或对象范围不明确时尝试写入。
第五步 完成只读验收
只读验收应限定对象、条件、字段和数量。例如只查询最近 7 天更新的 5 个交易，并返回名称、阶段、金额、负责人和更新时间。提示词中明确禁止创建、更新、关联或记录活动。
验收通过的标准是：账户正确、筛选条件生效、没有无关客户数据、Hu*Spot 审计中没有记录变更。CRM 字段、备注、邮件和网页内容都属于不可信数据，不能把其中的文字当成新的操作指令。
请仅使用 Hu*Spot MCP 做只读验收：
1. 调用 get_user_details，显示账户 用户和可用对象
2. 查询最近 7 天更新的 5 个交易
3. 只返回名称 阶段 金额 负责人 更新时间
4. 不创建 不更新 不关联 不记录活动
5. 遇到多条匹配或权限不足时立即停止| 验收项 | 通过标准 |
|---|---|
| 账户 | 显示预期门户与用户 |
| 对象 | *** 公司 交易均来自预期账户 |
| 字段 | 只返回任务所需字段 |
| 数量 | 筛选条件与上限生效 |
| 写入 | 审计中没有记录变化 |
第六步 查询***、公司与交易
先从稳定标识开始，例如***邮箱、公司域名、交易 ID 或精确名称。让 Claude Code展示匹配数量与候选记录，再读取所需字段和关联关系，避免使用模糊名称直接修改。
分析销售漏斗时，可读取交易阶段、金额、预计关闭时间、负责人和关联公司，但应限制时间窗口与返回数量。需要汇总时先输出计算口径，避免把缺失金额、重复交易或测试记录混入结果。
第七步 查询活动历史与敏感数据限制
远程 MCP 可访问调用、邮件、会议、备注和任务等活动，但是否可见仍受用户权限和账户配置约束。若 Hu*Spot 账户启用了 Sensitive Data，活动对象会被 MCP 阻止访问，即使标准 CRM API 的行为不同。
遇到活动缺失，不要尝试绕过限制，也不要要求导出整个时间线。改为确认 Sensitive Data 状态、用户权限和必要字段，并由***决定是否使用其他合规渠道。
第八步 创建或更新一条 CRM 记录
首次写入只选择一条低风险测试记录。让 Claude Code先展示门户、对象类型、记录 ID、旧值、新值、关联对象和预期业务影响；用户确认后，只执行这一次变更。
完成后立即重新读取记录并在 Hu*Spot UI 中核对。不要把“把所有相似记录都更新”与第一次验收合并执行，也不要在没有稳定唯一标识时根据名称猜测目标。
先不要执行写入。请展示：
- Hu*Spot 门户和当前用户
- 对象类型与记录 ID
- 当前值与拟修改值
- 关联对象和业务影响
等待我明确确认后，只执行这一条变更；完成后重新读取并报告审计结果。第九步 管理关联、任务和备注
给交易关联公司或***前，先分别解析两端的唯一 ID，并展示将建立或删除的关联。创建任务、会议、备注或邮件记录时，应确认负责人、截止时间、时区、正文和可见范围。
活动内容会进入客户历史，可能影响销售、服务和合规流程。提交前先生成草稿；涉及承诺、报价、法律文本或外部客户沟通时，必须由业务负责人审核。
第十步 批量更新的安全做法
批量任务分为预览、抽样、执行和复核四个阶段。第一阶段只输出候选记录数量、筛选条件和变更计划；第二阶段人工抽查；第三阶段按小批次执行；**阶段重新查询并保存结果清单。
为每批设置上限和停止条件。出现权限错误、字段校验失败、条件属性规则冲突或匹配数量异常时立即停止。需要回退时，应提前保存记录 ID 与原值，而不是依赖自然语言记忆。
| 操作 | 风险 | 控制方式 |
|---|---|---|
| 查询单条记录 | 低 | 使用唯一 ID 并限制字段 |
| 汇总销售漏斗 | 中 | 限定时间与口径并抽样 |
| 更新一条 CRM 记录 | 高 | 展示旧值新值并逐次确认 |
| 创建关联或活动 | 高 | 核对对象 负责人 时区与正文 |
| 批量修改记录 | 极高 | 预览 抽样 小批次执行 可回退 |
| 删除关联或覆盖关键字段 | 极高 | 保存原值并由业务负责人单独确认 |
第十一步 设置 Claude Code 权限边界
在 Claude Code 中把 Hu*Spot 写入工具保持为需要批准，只读工具可按团队策略适度放宽。不要对所有 MCP 工具启用永久允许；不同对象与动作应分别评估。
建议在项目说明中写明：默认只读、写入必须展示差异、一次只改一条、批量操作单独确认、禁止根据 CRM 内文本扩展权限。这样即使会话很长，操作规则仍然明确。
第十二步 在远程 Mac 上保持会话
通过 SSH 登录长期在线的 Mac，在目标仓库创建 tmux 会话后启动 Claude Code。浏览器授权可在本地完成，终端连接和 CRM 分析继续留在远程环境中。
使用清晰的会话名区分 portal、环境与任务。离开前锁定终端、结束不再需要的会话，并在 Hu*Spot 或 Claude Code 中撤销不再使用的 OAuth 连接。
ssh your-**c-mini
cd /path/to/your-project
tmux new -s hu*spot-crm
claude
# 断线后接回
tmux attach -t hu*spot-crm
为什么 Zu**c Ai 适合这类工作流
根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，配置为 16G* 统一内存与 256G* SSD，支持终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC 等接入方式。
长期在线环境适合保留仓库、依赖缓存、Claude Code 与 tmux 会话。Hu*Spot CRM 数据、用户权限、OAuth 凭据、客户隐私、审计和生产变更责任仍由使用者与所属组织负责。
常见问题排查
| 现象 | 常见原因 | 处理建议 |
|---|---|---|
| Needs authentication | 尚未完成 OAuth 或令牌失效 | 运行 claude mcp login hu*spot |
| redirect_uri_mis**tch | 回调地址或端口不一致 | 核对 localhost:8181/call*ack 与 --call*ack-port |
| 看不到对象 | 用户权限不足或新 scopes 未授权 | 核对权限后重新安装连接 |
| 活动历史不可用 | 账户启用了 Sensitive Data | 遵循限制并改用批准的合规渠道 |
| 写入被拒绝 | 权限 工具或字段规则限制 | 核对用户权限与条件属性规则 |
| 匹配多条记录 | 名称或邮箱条件不唯一 | 停止写入并改用精确 ID |
结语
Claude Code 接入 Hu*Spot MCP 后，最重要的不是一次授权后能做多少，而是每次都能确认账户、权限、对象和影响。先用 get_user_details 与只读查询建立可信基线，再通过单条变更、差异预览、人工确认和审计复核，把 CRM 自动化控制在可解释、可检查、可回退的范围内。