你可以将 LangSmith Fleet 连接到远程 MCP 服务器,为代理扩展更多工具和集成能力。本页面介绍如何添加自定义 MCP 服务器,并提供热门远程服务器的配置详情。 MCP(模型上下文协议)服务器会公开代理可以在运行时调用的工具。 远程 MCP 服务器:
  • 在 LangSmith 外部运行(通常通过 HTTPS)。
  • 负责自身的身份验证和授权。
  • 充当代理与外部系统之间的桥梁。
LangSmith Fleet 不会直接执行这些工具,而是将请求转发给 MCP 服务器,并将结果返回给代理。

工作原理

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

添加远程 MCP 服务器

你可以直接从代理或工作区设置中添加 MCP 服务器。
添加 MCP 服务器需要 MCP Server Create 权限。工作区管理员可以在工作区设置中向用户授予此权限。

添加到特定代理

要将远程 MCP 服务器添加到特定代理:
1

Open the Connections drawer

打开代理,然后在侧边栏中展开 Connections 抽屉。
2

Add the MCP server

  1. 点击 Add connection,然后点击 + Add custom MCP。
  2. 输入服务器名称和 URL,然后配置身份验证(请参阅身份验证类型)。
3

Discover tools

Fleet 会从你的 MCP 服务器发现可用工具,并使这些工具可供此代理使用。

添加到工作区中的所有代理

要将远程 MCP 服务器添加到工作区中的所有代理:
1

Navigate to Fleet > Integrations

在 LangSmith 界面中,导航到 Fleet > Integrations 标签页。
2

Add the server

  1. 点击左侧边栏底部的 + Custom MCP。
  2. 为 MCP 服务器添加 Name。
  3. 添加 MCP URL(例如 https://api.example.com/mcp)
  4. 选择 Authentication 类型。有关详细信息,请参阅身份验证类型。
3

Save the server

点击 Save server。Fleet 会自动从你的 MCP 服务器发现可用工具,并使这些工具可供你的代理使用。配置的标头会同时应用于工具发现请求和工具执行请求。

身份验证类型

根据服务器的要求选择身份验证类型:
  • Headers:添加随每个请求发送的键值对。最常见的模式是使用 Authorization bearer 令牌:
    • Key:Authorization
    • Value:Bearer API_KEY
    如果你的 MCP 服务器需要额外的身份验证或配置参数,可以添加多个标头。每个标头键值对都会随发送到服务器的每个请求一起发送。
  • OAuth 2.1 (Auto):对于支持通过动态客户端注册使用 OAuth 的服务器,请选择此项。系统会提示你使用该服务的账户登录。
  • OAuth 2.1 (Manual):对于支持 OAuth 但要求预先指定客户端 ID/密钥的服务器,请选择此项。此流程中使用的 OAuth 提供商必须启用 PKCE。

更新 MCP 服务器 URL

更改自定义 MCP 服务器的 URL 会导致使用该服务器工具的代理无法正常工作。
Fleet 根据 MCP 服务器 URL 存储工具引用。如果你更新自定义 MCP 服务器的 URL,现有代理在尝试调用这些工具时会失败,因为存储的 URL 不再匹配。 要更新 MCP 服务器 URL:
  1. 在工作区设置中更新 MCP 服务器 URL。
  2. 对于每个使用该服务器工具的代理:
    • 从代理配置中移除受影响的工具。
    • 重新添加这些工具(它们现在会引用新的 URL)。
  3. 测试代理,确认工具可以正常工作。

支持的服务器

要查看所有可用的 MCP 服务器及其配置详情,请导航到 Fleet > Integrations 标签页。