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
    • 值：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 > 集成标签页。
将这些文档 通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。