以编程方式使用文档

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

An MCP（模型上下文协议）服务器 在运行时公开代理可以调用的工具。

远程 MCP 服务器：

  • - 在 LangSmith 外部运行（通常通过 HTTPS）。
  • - 拥有自己的身份验证和授权。
  • - 作为您的代理与外部系统之间的桥梁。

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

工作原理

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

您可以直接从您的代理或从工作区设置添加 MCP 服务器。

添加到特定代理

要向特定代理添加远程 MCP 服务器：

Open the agent editor

在 Fleet 收件箱中打开您的代理。在代理名称旁边，点击 **编辑代理** icon.

Add the MCP server

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

Save your agent

点击 **保存更改**。Fleet 将从您的 MCP 服务器发现可用的工具，并让它们在此代理中可用。

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

要向工作区中的所有代理添加远程 MCP 服务器：

集成">
集成"> 在 LangSmith UI 中，导航到 [**Fleet** > **集成**](https://smith.langchain.com/agents/tools) tab.

Add the server

1. 点击 **+ 自定义 MCP** 在左侧边栏底部。 1. 添加 **名称** 用于 MCP 服务器。 1. 添加 MCP **URL** (e.g., https://api.example.com/mcp) 1. 选择 **身份验证** 类型。请参阅 身份验证类型 了解更多详情。

Save the server

点击 **保存服务器**。Fleet 将自动发现 MCP 服务器中的可用工具，并将其提供给您的代理。配置的请求头将应用于工具发现请求和工具执行请求。

From workspace settings

Navigate to MCP server settings

在 LangSmith UI 中，导航至 设置 > MCP 服务器 tab.

Add the server

点击 **添加服务器** 并输入服务器名称和 URL，然后配置身份验证（请参阅 身份验证类型).

Save the server

点击 **保存服务器**。Fleet 将自动发现 MCP 服务器中的可用工具，并将其提供给您的代理。配置的请求头将应用于工具发现请求和工具执行请求。

身份验证类型

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

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

  • OAuth 2.1（自动）：对于支持通过动态客户端注册进行 OAuth 的服务器，请选择此选项。系统将提示您登录该服务的账户。
  • OAuth 2.1（手动）: Select this for servers that support OAuth, but require specifying the client ID/secret beforehand. OAuth providers used in this flow must have **PKCE** enabled.

更新 MCP 服务器 URL

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

要更新 MCP 服务器 URL：

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

支持的服务器

要查看所有可用的 MCP 服务器和配置详情，请导航至 Fleet > 集成标签页.