MCP for Agentforce 的注意事项

MCP 服务器和注册

• Agentforce 的 MCP 支持使用可流 HTTP 传输协议的服务器。不支持 HTTP+SSE 和其他协议。
• MCP for Agentforce 不支持身份验证和 OAuth 2.0 客户端凭据。不支持其他 OAuth 流，包括授权代码、CIMD、DCR、JWT 不记名和 PKCE。一些高级身份验证模式适用于其他配置，包括 OAuth 2.1 客户端凭据。
• 不支持用户级身份验证。我们目前不支持需要个人用户 ID 或个性化回复的用例。例如，您不能使用 MCP for Agentforce 向单个用户退款，但您可以使用它来获取所有客户的发票。
• MCP for Agentforce 仅支持服务器工具。不支持 MCP 服务器应用程序、提示和资源。
• 工具名称最多可以有 128 个字符，并支持以下字符：^a-zA-Z0-9./-{1,128}$
• 当 MCP 服务器不同步或不可用时，注册列表视图和服务器记录页面当前显示服务器已连接。修复正在路上。
• 对服务器注册或服务器本身所做的更改可能会破坏客服人员中关联的 MCP 工具操作。在进行任何更改（包括删除注册）之前，请从客服人员中删除任何关联的操作，从资产库中删除关联的客服人员操作，然后删除服务器注册。然后，您可以重新注册服务器，并将新的 MCP 工具操作添加到客服人员。

打包和部署

为了确保安全性，Salesforce 支持打包或部署包含 MCP 工具操作的客服人员，但 MCP 服务器注册元数据未打包。添加到客服人员的任何 MCP 工具操作都不能立即使用。

在部署软件包之前，请在新环境中注册 MCP 服务器，并将客服人员使用的工具列入允许列表。然后，在部署后，从客服人员中删除任何现有的 MCP 工具操作，并使用资产库中的新操作进行替换。

客服人员元数据可以为草稿或提交的客服人员打包。如果客服人员在新环境中处于草稿状态，您可以编辑它。如果客服人员处于已提交状态，请创建新草稿进行更改。

Agentforce 平台和生成器支持

• 引用 MCP 服务器操作的客服人员操作（MCP 工具操作）的计费率与其他客服人员操作相同。Digital Wallet 中提供了使用情况报告。见Agentforce 和生成式 AI 使用情况和计费。
• Agentforce Builder 对原始值和浅层字段访问权限的支持最强，因此选择具有简单结构 JSON 响应的 MCP 服务器工具，或者尽可能调整您的响应。支持顶级对象、顶级对象属性和顶级对象数组。目前，不支持更复杂的形状，包括嵌套属性、对象数组和动态对象负载。了解更多信息。
• Agentforce Builder 使用 Lightning 类型来呈现操作输入和输出。并非所有 MCP 工具输入和输出模式都映射到 Lightning 类型。当 MCP 工具操作的数据无法解析为 Lightning 类型时，您仍然可以与客服人员使用该操作，但输入或输出不能存储在变量中。了解更多信息。
• 当您将 MCP 工具操作添加到客服人员时：
  • 一些数据类型（例如数字）的输入和输出标签可以用标签“字符串”替换。这不会影响客服人员的逻辑或推理，但为了便于使用，我们建议使用资产库中的 MCP 工具操作或 MCP 工具输入或输出模式中的原始值替换标签。修复正在路上。
  • 引用操作类型字段显示为空。该操作可以在没有引用操作类型的情况下运行，即使它被标识为必填字段，因为引用操作被填充。如果您单击引用操作类型字段或更改该字段，引用操作将被重置，且无法手动重置为 MCP 工具。在这种情况下，从客服人员中删除操作，并将其从资产库中重新添加。修复正在路上。
  • 对于 MCP 服务器和工具，属性必须小于或等于 255 个字符。当前不支持超过 255 个字符的属性。
• MCP 服务器响应受这些超时窗口的制约。尽可能调整响应，以适应这些限制。
  • MCP 客户端超时限制为 60 秒。例如，当服务器不可用或响应时间超过 60 秒时。
  • Atlas 推理引擎超时为 120 秒。例如，当调用多个服务器并且响应时间总共超过 120 秒时。