请注意：：本文仅为方便您阅读而提供。

将 NetSuite 连接到 Breeze Assistant

上次更新时间： 2026年10月21日

可与以下任何订阅一起使用，除非另有说明：

所有产品和计划

将 NetSuite 与 Breeze Assistant 连接，即可在不离开 HubSpot 的情况下访问和处理 NetSuite 记录。连接 NetSuite 后，您可以要求 Breeze Assistant 从 NetSuite 检索信息，并在 NetSuite 记录上执行受支持的操作。

例如，您可以要求 Breeze Assistant 汇总某个客户的 NetSuite 历史记录、使用 NetSuite 数据生成摘要和报告，以及从 NetSuite 获取财务信息（如付款记录和未结发票）。

开始之前

在将 NetSuite 连接到 Breeze Assistant 之前，请仔细阅读以下要求和注意事项。

了解要求

在将 NetSuite 连接到 Breeze Assistant 之前，NetSuite 管理员必须在 NetSuite 中完成以下步骤。
请查阅使用 Breeze Assistant 的要求。

了解限制与注意事项

NetSuite 是一项第三方服务。使用该连接器时，适用 Oracle 的数据和隐私政策。请查阅 Oracle 的《相关风险、控制措施和缓解策略》以获取更多信息。
NetSuite AI 连接器服务尚未经过 HIPAA 合规性评估，不应用于存储、处理或传输电子受保护健康信息 (ePHI)。如果您在 HubSpot 账户中启用了“敏感数据”功能，建议不要使用该连接器。了解有关NetSuite 和 HIPAA 的更多信息。
在确认更改之前，请审查 Breeze Assistant 建议的更改。
您无法通过该连接器删除 NetSuite 数据。
默认情况下，身份验证令牌的有效期为 48 小时。在 NetSuite 中，您可以将此有效期延长至最多 30 天。当令牌过期时，您必须重新验证连接。

NetSuite 中的管理员操作步骤

在将 NetSuite 连接到 Breeze Assistant 之前，NetSuite 管理员必须在 NetSuite 中完成以下步骤。

1. 启用所需的 NetSuite 功能

在 Breeze Assistant 中使用 NetSuite 连接器之前，NetSuite 管理员必须启用所需的 SuiteCloud 功能。

在 NetSuite 中，请导航至“设置”>“公司”>“启用功能”。
点击“SuiteCloud”子选项卡。
在“SuiteScript”部分：

选中“客户端 SuiteScript”复选框 。若出现提示，请点击“我同意”以接受 SuiteCloud 服务条款。
选中“服务器 SuiteScript”复选框 。如果系统提示，请点击“我同意”以 接受 SuiteCloud 服务条款。

在“管理身份验证”部分，选中“OAuth 2.0”复选框。如果系统提示，请点击“我同意”以接受 SuiteCloud 服务条款。
在“SuiteTalk（Web 服务）”部分，选中“REST Web 服务”复选框。

点击“保存”。

2. 为连接器配置 NetSuite 角色

每位需要访问连接器的用户都必须拥有一个具备所需权限的 NetSuite 角色。建议为连接器创建一个专用角色，而不是将这些权限添加到具有更广泛访问权限的现有角色中。

配置角色权限

在 NetSuite 中，导航至“设置”>“用户/角色”>“管理角色”。
要配置现有角色，请点击该角色旁边的“编辑”。要创建角色，请点击“新建”。
单击“权限”子选项卡，然后单击“设置”。
添加以下权限：
- MCP 服务器连接：选择“完全访问”。此权限允许用户连接到 AI 连接器服务。
- 使用 OAuth 2.0 访问令牌登录：选择“完全访问”。此权限允许进行 OAuth 2.0 身份验证。
- REST Web 服务：如果用户将通过 MCP 标准工具套件 App 创建、检索或更新记录，请选择“完全访问”。

点击“保存”。

请注意： 创建 NetSuite 角色后，该角色可能需要一段时间才能生效。请等待角色生效后再继续进行设置。

为角色添加记录权限

为需要由 Breeze Assistant 检索的 NetSuite 对象（例如销售订单、发票和客户付款）添加记录权限。

在 NetSuite 中，切换到“管理员”角色。
导航至“设置”>“用户/角色”>“管理角色”。
打开您为 NetSuite 连接器创建的角色。
导航至“权限”>“交易”。
为希望 Breeze Assistant 检索的 NetSuite 对象添加权限，然后将每个权限的访问级别设置为“完全”。例如，您可以为销售订单、发票、客户付款或其他 NetSuite 对象添加权限。
点击“保存”。

将角色分配给用户

在 NetSuite 中，导航至“列表”>“员工”>“员工”。
点击要为其分配角色的用户旁边的“编辑”。
导航至“访问”选项卡。
在“角色”下，搜索并选择您在上一步骤中配置的角色。
点击“添加”。
然后点击“保存”。

请注意：NetSuite AI 连接器服务不能在“管理员”角色或任何对 NetSuite 功能具有完全访问权限的角色下运行。此安全防护措施有助于防止外部 AI 客户端的安全性遭到破坏时产生意外后果。

3. 安装 MCP Standard Tools SuiteApp

若要将 NetSuite 连接器与 Breeze Assistant 配合使用，请安装 MCP Standard Tools SuiteApp。该 SuiteApp 允许您在 Breeze Assistant 中使用自然语言查询 NetSuite 数据。

该 SuiteApp 会根据用户现有的 NetSuite 角色和权限，确定其可访问的数据和操作。

以NetSuite 管理员身份登录 NetSuite。
点击 “SuiteApps”选项卡。
在“搜索 SuiteApps”字段中，输入“MCP Standard Tools”。
点击“MCP Standard Tools”图标。
在SuiteApp 页面的右上角，点击“安装”。
请等待安装完成。

4. 创建 OAuth 2.0 集成记录

在 NetSuite 中创建一个集成记录，以配置 NetSuite 与 HubSpot 之间的 OAuth 2.0 身份验证。更多详情请参阅NetSuite 文档。

在 NetSuite 中，导航至“设置”>“集成”>“管理集成”>“新建”。
为集成输入一个名称。
将“状态”字段设置为“已启用”。
在“OAuth 2.0 范围”部分：

- 选中“授权码授予”复选框。

- 取消选中“公共客户端”复选框。连接 NetSuite 与 HubSpot 需要“客户端密钥”。
- 在“重定向 URI”字段中，输入HubSpot 的重定向 URI。该 URI 必须使用https://oauth-redirect.hubspot.com/callback/netsuite_mcp。

- 选中“NetSuite AI 连接器服务”复选框。
- 取消选中其他OAuth 范围复选框，包括RESTlets、REST Web Services 和SuiteAnalytics Connect。

清除“基于令牌的身份验证”和“客户端凭据”部分中的所有复选框，包括“客户端凭据（机器对机器）授权”复选框。
点击“保存”。
复制并安全保存生成的“客户端 ID”和“客户端密钥”。

请注意：只有在首次保存集成记录后，才会显示“客户端 ID”和“客户端密钥”。如果您未保存这些值，则需要在集成记录中重置它们以生成新的凭据。

本节中的 REST Web 服务 OAuth范围与之前配置的 REST Web 服务角色权限不同。角色权限决定用户对 REST API 的访问权限，而 OAuth 范围则将 OAuth 令牌的适用范围限制在 NetSuite AI 连接器服务内。

5. 查找 NetSuite MCP 服务器 URL

MCP 服务器 URL 与您的 NetSuite 账户相关联，并决定通过该连接可用的工具。

查找您的账户 ID

在 NetSuite 中，导航至“设置”>“公司”>“公司信息”。
在页面顶部找到账户 ID。
单击“公司 URL”选项卡，查看该账户专用的 SuiteTalk URL。

设置正确的 MCP 服务器 URL

要使用 MCP 标准工具 SuiteApp，请使用：
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
若要显示所有可用的 SuiteApps 和账户自定义项目，请使用：
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
若要显示特定的 SuiteApp，请使用：
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<publisherid>.<projectid>
请将<accountid>替换为您自己的NetSuite 账户 ID。