使用 MCP 将 HubSpot 连接到 Claude

HubSpot免费计划查询流克劳德

用通俗易懂的英语向 Claude 询问 HubSpot 帐户信息：已在您网络内部运行的 Agent 会以只读方式执行 SQL，而您的 AI 客户端永远不会持有您的登录凭据。大约只需十分钟，免费套餐即可满足需求。

免费开始

你最终会得到什么

Claude 可以实时回答关于您的 HubSpot 帐户的问题，提供只读查询，解释各列的含义，并在您提出更多问题时进行跟进——无需数据库登录，也无需更改防火墙设置：已部署在您网络中的代理程序运行 SQL 并仅返回查询结果。代理程序部署完毕后，如果您熟悉设置界面，连接 Claude 大约需要 90 秒。例如：

克劳德 ChatGPT 光标 克劳德·科德 VS Code 风帆冲浪 Gemini CLI JetBrains 法典+5只读

里面有什么 HubSpot 优惠 我的 HubSpot 账户里有什么？请显示几行数据，并告诉我每一列的含义。

qs_get_table_schema qs_run_query 模式智能

我首先查看了表结构，然后通过您的代理运行了只读查询。以下是 hubspot.deals 表中的三行数据：

交易名称	交易阶段	数量
1042	北风贸易公司	西雅图
1057	阿尔卑斯户外用品店	丹佛
1063	港湾食品	哈利法克斯

交易名称 标识行。 交易阶段 和 数量 这些内容在您的语义智能模型中有描述，因此我可以按名称进行筛选。

哪三个 数量 本季度价值类产品带来的收入最多，与上季度相比如何？我应该重点关注哪些方面？

qs_get_relationships qs_run_query qs_run_query

我加入了 HubSpot 优惠 至 命令 基于语义智能发现的关系，分别对每个季度运行一次聚合查询。这两个查询均为只读查询，且均返回 3 行数据：

数量	本季度	上个季度	改变
丹佛	184,200	133,900	+38%
西雅图	171,650	168,400	+2%
哈利法克斯	96,300	129,700	-26%

丹佛 故事是这样的：在客户数量几乎不变的情况下，收入增长了 38%，因此平均订单价值也提高了。 哈利法克斯 下降了26%，其中有两位客户上季度每月都下单，而本季度却完全没有下单——月底前值得联系一下。西雅图的业绩持平。想知道哈利法克斯那两位客户的具体姓名吗？

仅选择，由代理检查。 已登录 MCP 活动选项卡 3 个查询共返回 9 行数据 14 个 MCP 客户端中的相同连接

完全不想搭建人工智能客户端？ 关于商业计划书， 诺瓦 MCP 是 Query Streams 内置的助手。它使用与您的 AI 客户端相同的 Agent 工具集，此外还具备外部客户端所不具备的功能：它会根据您的语义智能模型生成并验证 SQL，将结果转换为图表，并将结果保存为查询，您的团队可以从 Excel、Google Sheets 或 REST API 运行该查询——无需密钥、连接器或安装任何软件。如果您的团队成员已经在使用 Claude、Cursor 或 ChatGPT，请使用 MCP；如果您希望在门户网站内获取答案，请使用 Nova。

HubSpot 将您的数据存储在其 API 之后。而 Claude 则运行在浏览器或终端中，对数据一无所知。通常的做法是将模式粘贴到聊天框中，然后祈祷成功，或者将您的 HubSpot 密码提供给开源的 MCP 服务器。Query Streams 的做法则不同：已存在于您 HubSpot 帐户中的代理以只读方式运行 Claude 编写的 SQL，而 MCP 服务器则负责检查请求者的身份、请求内容和请求频率。Claude 只获取答案，绝不会获取凭据。

你需要准备什么

查询流帐户

MCP 包含在所有套餐中，包括免费套餐。免费套餐允许使用一个钥匙或一个连接的应用程序，这足以满足本指南的需求。立即注册！ my.querystreams.com.

HubSpot 通过代理连接

在任何始终在线的计算机上安装代理，并在数据代理中添加 HubSpot 连接。还没完成吗？ 首先连接 HubSpot大约需要十分钟。

MCP 已为您开启

创建者、所有者和管理员从一开始就拥有权限。其他所有人则需要管理员来切换权限。 MCP 他们名字旁边的开关 账户 → 访问控制在此之前，MCP 页面会显示“您的帐户已禁用 MCP”。

人工智能客户

像 claude.ai、Claude Desktop 和 ChatGPT 这样的聊天应用无需密钥即可连接。Claude Code、Cursor、VS Code 以及其他大约十种工具则需要密钥；门户网站的 连接人工智能客户端 向导会逐一进行设置。

分四步完成设置

1. 在门户网站中打开 MCP。

   登录 my.querystreams.com 并开放 流媒体 → 直播 → MCP该页面共有四个标签页： 连接, 语境, 工具 对于管理员而言， 活动请查看语义智能面板。 连接 您在这里可以看到：它列出了您的 HubSpot 连接器以及语义智能是否已在其上运行。正是由于覆盖全面，Claude 才能一次性编写出正确的 HubSpot SQL。

   开放 MCP

   看到“您的帐户已禁用 MCP”提示？ 您的组织拥有 MCP，但您的用户已被禁用。管理员使用以下命令将其启用： MCP 你的名字旁边有个开关。 账户 → 访问控制创建者、所有者和管理员从一开始就在线。

2. 选择您的连接方式

   有两条路可以进去，但它们通向同一个地方：

   聊天应用 · 无密钥

   claude.ai、Claude Desktop、ChatGPT

   在 claude.ai 和 Claude Desktop 中，打开 查询流列表 在 Anthropic 的连接器目录中，点击 连接 并批准。通过URL添加。 https://mcp.querystreams.com/mcp这是备用方案。在 ChatGPT 中，您可以从应用（目前需要开发者模式）添加 Query Streams，并使用 Query Streams 登录。无论哪种方式，都会打开 Query Streams 页面：选择组织和权限，然后点击 批准连接无需复制任何内容。连接显示在…… 连接 可以在那里撤销此操作。

   开发者工具 · 关键

   Claude Code、光标、VS Code 和朋友们

   在 MCP 页面上点击 连接人工智能客户端导游问道 您的AI客户端将如何连接？： 选择 在配置文件中使用密钥选择你的工具，然后 生成密钥 它：一个 键名, 读 和 运行查询 勾选，一个 到期日 （从不、30 天、90 天或 1 年）。 设置好它 显示已填写密钥的代码片段，并且 检查连接 等待第一个电话。

   两种方式都使用相同的三个权限，您可以在同意屏幕或密钥上选择这些权限：

   读

   列出连接器，浏览表和列，读取已保存的查询和警报规则。从不返回行数据。

   运行查询

   通过您的代理运行只读 SQL 和已保存的查询，并返回相应的行。否则，您的 AI 客户端只能描述您的数据，而无法从中获取答案。

   分析

   它会分析表结构、发现关联关系并安排语义智能运行。此操作会消耗 Nova AI 积分和数据流量，因此不会在同意界面预先勾选。

   钥匙丢了？ 它列在…… 连接 标签： 显示完整密钥 再次显示并 复制完整密钥 复制它。如果笔记本电脑丢失，则撤销该权限；所有使用该权限的客户端都会在大约五分钟内导致下次调用失败。

3. 联系克劳德

   选择你使用的克劳德配方。服务器地址在所有地方都相同： https://mcp.querystreams.com/mcp.

   网页版 Claude、桌面版 Claude 和移动版 Claude 没有钥匙

   1. 打开 查询流列表 在 Anthropic 的连接器目录中，然后点击 连接在桌面版中，它位于以下位置 + → 连接器.
   2. 如果您的组织隐藏了目录连接器，则可采取以下备用方案： 设置 → 连接器 → 添加自定义连接器， 姓名 查询流网址 https://mcp.querystreams.com/mcpOAuth字段为空， 添加然后在聊天中 + → 查询流 → 连接.
   3. “查询流”选项卡随即打开。如果系统提示，请登录，选择组织，然后进行审核。 读 和 运行查询（可选） 仅限特定连接器然后点击 批准连接.
   4. 回到 Claude 界面，你会看到“已连接到查询流”。Claude 首次使用某个工具时会询问：请选择 始终允许.

   如果您在 Claude Desktop 中手动添加，请使用 设置 → 连接器 → 添加不是聊天记录 添加市场 此选项需要一个 Git 仓库。连接器会同步到您的 Claude 帐户，因此移动应用和桌面应用会自动识别。菜单名称为 Anthropologie 的，可能会更改。

   克劳德·科德 钥匙

   只需在“连接”选项卡中使用您的密钥执行一条命令：

   终端

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   这会写出当前项目的…… .mcp.json。 添加 --scope 用户 在每个项目中都包含查询流。运行 /mcp 在 Claude Code 中查看连接情况。

   光标 钥匙

   打开 光标设置 → MCP → 添加新的 MCP 服务器或编辑 .cursor/mcp.json 在工作区的根目录下：

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   重启 Cursor 或运行 MCP：重启服务器；一个 查询流 徽章会显示在 MCP 状态栏中。

   用别的办法吗？ 门户网站的 连接人工智能客户端 指导 它提供了适用于 ChatGPT、VS Code、Visual Studio、OpenAI Codex CLI、Gemini CLI、Windsurf、Zed、Cline、Continue.dev 和 JetBrains AI 的现成代码模板，此外还有 粘贴并合并 放下工具 查询流 将条目添加到您已有的配置文件中。任何支持通过 HTTP 协议使用 MCP 的客户端都可以：服务器 https://mcp.querystreams.com/mcp标题 X-MCP-Key （一个 授权方式：持有者 使用相同键的标头也有效）。

4. 问你的第一个问题

   先从你已经知道答案的问题入手，这样你就能看到克劳德如何选择合适的工具。以下三个工具与你的 HubSpot 账户配合使用效果很好：

   我的 HubSpot 帐户中有哪些数据？

   Claude 会列出它可以看到的表格，告诉你哪些表格具有语义智能，并询问你想查看什么。

   “请从 hubspot.deals 文件中选取十行数据，并解释每一列的含义。”

   Claude 首先读取表结构（读取），然后通过您的代理运行一个 SELECT 查询（运行查询），并描述交易阶段和金额的含义。

   “hubspot.deals 中每个金额有多少行数据？哪个金额的行数最多？”

   Claude 用 HubSpot 特有的方式编写了 GROUP BY 语句，运行后用一句话和一个小型表格回复。在同一个聊天窗口中继续跟进，这样可以保留上下文。

   要确认接线情况，请询问 我有哪些 Query Streams 连接器？克劳德打电话 qs_list_connectors《传送门》指南的 检查连接 步骤说 已连接以及钥匙或应用程序 连接 标签页显示了它的 上次使用 几秒钟之内即可完成。

克劳德连接后能做什么

您的AI客户端会识别查询流工具；它会根据您的问题选择合适的工具。门户网站的 工具 标签 列出所有工具和模式，以及你的套餐包含的内容。Query Streams 会让你的 AI 客户端在查询前读取每个表的列信息，这样它就会使用真实名称，而不是猜测。所有套餐（包括 Free）均可使用：

分析工具集。 付费方案中，代理程序会在您的 HubSpot 帐户所在位置完成基础工作，这样您的 AI 客户端就可以专注于思考。免费方案的功能与以往相同。

默认值存在于 语境 标签：文本单元格限制、架构视图、结果大小、分析默认值和保留结果。

为什么语义智能在这里很重要

Claude 收到的每个答案都会被标记出该结构来自哪里，Claude 会根据标记调整它对所看到内容的信任程度。

如果数据库很重要，请对其运行一次语义智能分析。 新星 → 智能。 这 连接 该选项卡显示每个连接器的覆盖范围面板。 语义智能的工作原理.

这些计划允许什么？

MCP 包含在所有套餐中，包括免费套餐，无需额外付费。每个套餐的具体规定是您可以持有的密钥或已连接应用的数量，以及您的 AI 客户端每分钟可以发起的呼叫次数：

已连接的应用算作一个键。除了每分钟的限制外，任何一个键每分钟最多可以运行 10 次查询。查询运行时间最长为 60 秒，除非您的 AI 客户端请求更长的运行时间（最长 5 分钟）。您的计划还会设置每次查询返回的行数，以及（使用分析工具集）保留结果的时长和大小； 完整的MCP指南 列出每个计划。AI 客户端接收的内容会计入您的 Data Realm 配额，与 Excel 和 Sheets 查询使用同一额度池：AI 代理 (MCP) 用量会统计发送给 AI 客户端的每一个字节，包括结果、架构读取和暂存结果页面，且统计发生在客户端协商的任何传输压缩之前；而电子表格查询统计的是 Network Agent 发送的压缩结果。从 AI 客户端启动的 Semantic Intelligence 运行会消耗 Nova AI 积分，与从 Portal 启动时完全相同。 请查看定价页面 津贴。

确保安全

下一步行动不错。

• 保存您认为规范的查询 在查询构建器中，Claude 会优先选择已保存的查询，因此“活跃客户”的含义取决于你们团队的定义。
• 使用 Claude 项目 附加查询流，并在其说明中设置您的规则：默认使用哪个 HubSpot 数据库，哪些已保存的查询是官方定义。
• 当您需要更深入的答案时，请使用 Grant Analyze。 在筛选之前先对该列进行分析，这相当于从猜测状态码到使用正确状态码之间的区别。此操作会消耗 Nova AI 积分，因此默认情况下处于关闭状态，直到您手动启用为止。
• 索取一张图表。 claude.ai 根据 Claude 返回的行绘制图表。

当某些事情不起作用时

人们提出的问题

相关指南

• 使用 MCP 将 Stripe 连接到 Claude
• 使用 MCP 将 Shopify 连接到 Claude
• 使用 MCP 将 Google Analytics 4 连接到 Claude
• 使用 MCP 将 Google Search Console 连接到 Claude
• 通过 MCP 将查询流连接到 Claude：设置、权限和故障排除
• 如何将 HubSpot 连接到 Google Sheets
• 所有 MCP 指南