用 Muse 查 HubSpot 客户记录，接 CData 做一份会前简报

01｜先定一个客户，别让它把整个 CRM 翻一遍

开会前最有用的材料，往往就是上次聊了什么、答应了什么、现在还差什么。先在 HubSpot 打开目标公司的记录，记下账号、公司记录 ID、域名和这次会议日期。同名客户、集团子公司和关联联系人都可能混在一起，单给一个公司名很容易找错。

CData 作者 Joe Karlsson 分享过 Muse 接业务数据的做法。本文按 CData 的 Muse 教程、接口文档和 HubSpot 规则整理，没有在真实客户账号里实测。这里用的是 CData Connect AI 提供的数据连接路线。先取得公司允许，再从一份不含敏感信息的测试记录开始。

02｜在 CData 里把 HubSpot 连接好

准备好有权读取目标资料的 HubSpot 账号和 CData Connect AI 账号。在 CData 的 Sources 中选择 Add Connection，再选 HubSpot，按页面的 Sign in 完成 OAuth 登录。看清授权的 HubSpot 账号；连接能登录成功，也要在 CData 的数据浏览界面确认目标记录确实读得到。

只检查本次需要的公司记录和少量活动字段。表名、关联表和字段以你这个连接实际显示的结构为准，不照抄其他人的 SQL。先查到一条已知的测试记录，核对 ID 与域名一致，再继续设置 Muse。

03｜只给这次查询需要的权限

请管理员检查这个 CData 用户对目标连接或工作区的有效权限。整理简报只需要 Select；Insert、Update、Delete 和 Execute 不属于这次任务。权限会叠加，另一个角色或直接授权仍可能给写权限，不能只看一个角色名称。工作区资产按工作区权限开放，即使没有底层数据源权限，也可能从工作区读到资料。工作区与 Toolkit 中暴露的资产都要检查。

把能访问的其他连接也列出来，移除与这次任务无关的授权。只读会限制修改，不会限制已经能读取的数据范围；查询结果仍会交给远端 Muse 处理。若要只暴露指定表、字段和查询操作，可请管理员配置 Toolkit。当前 CData 文档要求 Growth+ 套餐和管理员权限，已有连接不会自动变成这种精细范围。

04｜新增 Muse 连接器，凭据只填在专用入口

CData 的 Muse 教程采用自定义连接器与 Authorization 请求头。先请 Muse 为 CData 创建连接器，把 CData 服务地址和认证方式交给它，随后核对生成的连接卡片及工具。这是提供方公布的 Muse 接入路径；当前客户端是否能完成建连，要看实际结果。

若按该教程使用 Basic 认证，在 CData Settings 的 Personal Access Tokens 新建一个只供这次集成使用的 PAT。专用 PAT 方便单独撤销，但不会自动收窄这个用户已有的数据权限。认证值是账号邮箱与 PAT 用冒号连接后进行 Base64 编码，再加 Basic 前缀；Base64 编码仍是秘密凭据。用本机离线工具处理，只填在 Muse 的专用安全凭据框。不要交给在线编码网站或普通聊天。PAT 只在创建时显示，连接器需要重新登录或没有安全输入入口时先停下。

CData 文档给出的只读工具地址是 https://mcp.cloud.cdata.com/mcp?ops=get_catalogs,get_schemas,get_tables,get_columns,get_instructions,queryData。ops 收窄服务公布的工具清单，后台数据权限也必须限制为只读。按当前 Muse 连接流程使用并检查实际工具列表，不能把这串地址当作所有 Muse 客户端都支持原生 MCP 的证明，也不要依据旧演示固定认定会出现 12 个工具。

05｜先读一条记录，确认连接没有找错地方

第一次只做一条小查询。可以这样说，“查看我已授权的 HubSpot 连接，先说明当前能读取的表和字段。找到公司记录 ID 为〔实际 ID〕的测试公司，只返回 ID、公司名和域名。不要改记录，也不要调用执行存储过程的工具。”看到结果后，回到 HubSpot 核对这三个值。

CData 的查询需要使用实际的 Catalog、Schema 和 Table；名称可先通过元数据工具发现，查询返回 CSV。读不到记录时，先查授权账号、连接状态、表名和字段，而不是让 Muse 一遍遍扩大搜索。认证错误看 PAT 是否过期；查询成功但没有目标行时，也不能直接推断客户资料已被删除。

06｜沟通记录要看关联，不能只看名字像不像

再让 Muse 读取目标客户过去 30 天的少量邮件、电话、会议和备注。要求保留活动 ID、原记录链接或可回查标识、时间、关联公司和联系人；先按 ID 去重，再挑三条与本次会议相关的内容。没有开放活动表或关联字段时，先补最小权限或由你提供原记录，别让它补写不存在的沟通。

HubSpot 的活动可以自动关联到多个记录。出现在商机时间线里，不代表这封信只是在谈这个商机。逐条看原文中的客户和具体事项，再判断能不能写进简报。2025 年 2 月 4 日当天及以后新建的部分免费账号，时间线可能只显示最近 30 天的特定活动，较旧记录可到活动索引页核查；空白时间线不能当作“从没联系过”。

07｜让它交一页简报，事实和建议分开放

可以接着发这段要求，“只整理公司 ID〔实际 ID〕、截至〔日期和时区〕的会前简报。列三次相关沟通、尚未解决的问题、已经明确答应的事项，每项附原记录标识。另列建议在会上问的问题。缺少负责人、日期或原文就写待确认。不要改客户、创建任务或发送邮件。”

收稿时挑三项最影响会议的内容回查。报价有效期要看原报价，交付时间要看客户或团队实际确认的日期，商机阶段要看当前字段。简报里的建议可以由 Muse 提出；已经承诺的事项必须有记录支撑。业务问题需要你作决定时，保留问题和出处，不让一页摘要替你作承诺。

08｜留好查询记录，试用结束后收回入口

在 CData Logs 的 Query Log 按时间、用户和连接找到这次查询，检查状态、查询文字和 Query ID。Audit Log 另记权限等管理事件。需要排查时及时下载相关日志文件，CData 帮助说明这类日志文件只保留七天。请把内部记录留在公司的受控位置，不贴到公开文章或聊天群。

一次试用结束后，在 Muse Settings 的 Connectors 中断开，并在 CData 删除专用 PAT 或移除测试用户的授权。PAT 重生成也会使使用旧值的应用失去访问，需要逐个更新；别把团队共用的 PAT 当成此次专用项处理。已经生成的简报、聊天和记忆还要另行检查。后续可把核验过的内容交给会议跟进教程，再由你安排行动。