远程 MCP 服务器

将 Fleet 连接到常用的远程 MCP 服务器

你可以将 LangSmith Fleet 连接到远程 MCP 服务器，以使用额外工具和集成扩展 agent。本页介绍如何添加自定义 MCP 服务器，并提供常用远程服务器的配置详情。

MCP（Model Context Protocol）服务器公开 agent 可在运行时调用的工具。

远程 MCP 服务器：

• 在 LangSmith 之外运行（通常通过 HTTPS）。
• 拥有自己的身份验证和授权。
• 充当 agent 与外部系统之间的桥梁。

LangSmith Fleet 本身不执行这些工具，而是将请求转发到 MCP 服务器并将结果返回给 agent。

工作原理

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

运行时：Fleet 自动连接到你的 MCP 服务器并使用其工具。

sequenceDiagram
    participant Agent as Fleet
    participant MCP as Remote MCP Server

    Agent->>MCP: Discover available tools<br/>(with configured headers)
    MCP-->>Agent: Return tool list

    Note over Agent,MCP: Later, when agent needs a tool...

    Agent->>MCP: Call tool<br/>(with configured headers)
    MCP-->>Agent: Return result

添加远程 MCP 服务器

你可以直接从 agent 或从工作区设置添加 MCP 服务器。

NOTE

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

添加到特定 agent

要将远程 MCP 服务器添加到特定 agent：

Open the Connections drawer

打开你的 agent，然后在侧边栏中展开 Connections 抽屉。

Add the MCP server

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

Discover tools

Fleet 会从你的 MCP 服务器发现可用工具，并使其在此 agent 中可用。

添加到工作区中的所有 agent

要将远程 MCP 服务器添加到工作区中的所有 agent：

导航到 Fleet > Integrations

在 LangSmith UI 中，导航到 Fleet > Integrations 选项卡。

添加服务器

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

保存服务器

点击 Save server。Fleet 会自动从你的 MCP 服务器发现可用工具，并使其在你的 agent 中可用。配置的 header 会应用于工具发现请求和工具执行请求。

身份验证类型

根据服务器的要求选择身份验证类型：

• Headers：添加随每个请求发送的键值对。最常见的模式是使用 Authorization bearer token：

  • Key：Authorization
  • Value：Bearer API_KEY

INFO

如果你的 MCP 服务器需要额外的身份验证或配置参数，你可以添加多个 header。每个 header 键值对都会随每个请求发送到服务器。

• OAuth 2.1 (Auto)：对于支持通过动态客户端注册进行 OAuth 的服务器，请选择此项。系统会提示你使用该服务的账户登录。

• OAuth 2.1 (Manual)：对于支持 OAuth 但需要事先指定客户端 ID/secret 的服务器，请选择此项。此流程中使用的 OAuth 提供程序必须启用 PKCE。

更新 MCP 服务器 URL

WARNING

更改自定义 MCP 服务器的 URL 会破坏任何使用该服务器工具的 agent。

Fleet 按 MCP 服务器 URL 存储工具引用。如果你更新自定义 MCP 服务器的 URL，现有 agent 在尝试调用这些工具时会失败，因为存储的 URL 不再匹配。

要更新 MCP 服务器 URL：

1. 在工作区设置中更新你的 MCP 服务器 URL。
2. 对于每个使用该服务器工具的 agent：
   • 从 agent 配置中移除受影响的工具。
   • 重新添加这些工具（它们现在将引用新的 URL）。
3. 测试 agent 以确认工具正常工作。

支持的服务器

要查看所有可用的 MCP 服务器和配置详情，请导航到 Fleet > Integrations 选项卡。

---