Skip to main content
您可以将 LangSmith Fleet 连接到远程 MCP 服务器，以使用额外的工具和集成来扩展您的智能体。本页面介绍如何添加自定义 MCP 服务器，并提供流行远程服务器的配置详情。 MCP（模型上下文协议）服务器 公开了智能体在运行时可以调用的工具。 远程 MCP 服务器：
  • 在 LangSmith 外部运行（通常通过 HTTPS）。
  • 拥有自己的身份验证和授权机制。
  • 充当您的智能体与外部系统之间的桥梁。
LangSmith Fleet 本身不执行这些工具，而是将请求转发给 MCP 服务器，并将结果返回给智能体。

​
工作原理

  • Fleet 通过标准的 MCP 协议从远程 MCP 服务器发现工具。
  • 在获取工具或调用工具时，会自动附加您在工作区中配置的请求头。请求头是随每个发送到 MCP 服务器的 HTTP 请求一起发送的键值对。它们通常用于身份验证（如 API 密钥或持有者令牌），但也可以提供配置信息、内容类型或自定义元数据。
  • 来自远程服务器的工具与 Fleet 的内置工具一起可用。
运行时：Fleet 自动连接到您的 MCP 服务器并使用其工具。

​
添加远程 MCP 服务器

您可以直接从智能体或从工作区设置中添加 MCP 服务器。
添加 MCP 服务器需要 管理员 权限。

​
添加到特定智能体

要将远程 MCP 服务器添加到特定智能体：
1

打开智能体编辑器

在 Fleet 收件箱中打开您的智能体。在智能体名称旁边，点击 编辑智能体 图标。
2

添加 MCP 服务器

在 工具箱 部分，点击 MCP。输入服务器名称和 URL，然后配置身份验证（参见 身份验证类型）。
3

保存您的智能体

点击 保存更改。Fleet 将从您的 MCP 服务器发现可用工具，并使其在此智能体中可用。

​
添加到工作区中的所有智能体

要将远程 MCP 服务器添加到工作区中的所有智能体：
1

导航到 Fleet > 集成

在 LangSmith UI 中，导航到 Fleet > 集成 标签页。
2

添加服务器

  1. 点击左侧边栏底部的 + 自定义 MCP。
  2. 为 MCP 服务器添加一个 名称。
  3. 添加 MCP URL（例如，https://api.example.com/mcp）。
  4. 选择 身份验证 类型。更多详情请参见 身份验证类型。
3

保存服务器

点击 保存服务器。Fleet 将自动从您的 MCP 服务器发现可用工具，并使其在您的智能体中可用。配置的请求头将应用于工具发现请求和工具执行请求。

​
身份验证类型

根据服务器的要求选择身份验证类型：
  • 请求头：添加随每个请求发送的键值对。最常见的模式是使用 Authorization 持有者令牌：
    • 键：Authorization
    • 值：Bearer API_KEY
    如果您的 MCP 服务器需要额外的身份验证或配置参数，您可以添加多个请求头。每个请求头键值对都会随每个发送到服务器的请求一起发送。
  • OAuth 2.1（自动）：对于支持通过动态客户端注册进行 OAuth 的服务器，请选择此项。系统将提示您使用该服务的帐户登录。
  • OAuth 2.1（手动）：对于支持 OAuth 但需要预先指定客户端 ID/密钥的服务器，请选择此项。在此流程中使用的 OAuth 提供商必须启用 PKCE。

​
更新您的 MCP 服务器 URL

更改自定义 MCP 服务器的 URL 将破坏任何使用该服务器工具的智能体。
Fleet 通过 MCP 服务器 URL 存储工具引用。如果您更新了自定义 MCP 服务器的 URL，现有智能体在尝试调用这些工具时将失败，因为存储的 URL 不再匹配。 要更新 MCP 服务器 URL：
  1. 在工作区设置中更新您的 MCP 服务器 URL。
  2. 对于每个使用该服务器工具的智能体：
    • 从智能体配置中移除受影响的工具。
    • 重新添加工具（它们现在将引用新的 URL）。
  3. 测试智能体以确认工具正常工作。

​
支持的服务器

要查看所有可用的 MCP 服务器及其配置详情，请导航到 Fleet > 集成标签页。
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.