> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 远程 MCP 服务器

> 将 Fleet 连接到流行的远程 MCP 服务器

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

[MCP（模型上下文协议）服务器](https://modelcontextprotocol.io/docs/getting-started/intro) 暴露了代理在运行时可以调用的工具。

远程 MCP 服务器：

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

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

### 工作原理

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

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

```mermaid theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
sequenceDiagram
    participant Agent as Fleet
    participant MCP as 远程 MCP 服务器

    Agent->>MCP: 发现可用工具<br/>（附带配置的标头）
    MCP-->>Agent: 返回工具列表

    Note over Agent,MCP: 后来，当代理需要工具时...

    Agent->>MCP: 调用工具<br/>（附带配置的标头）
    MCP-->>Agent: 返回结果
```

## 添加远程 MCP 服务器

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

<Note>
  添加 MCP 服务器需要 **管理员** 权限。
</Note>

### 添加到特定代理

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

<Steps>
  <Step title="打开代理编辑器">
    在 [Fleet](https://smith.langchain.com/agents) 收件箱中打开您的代理。在代理名称旁边，点击 <Icon icon="pencil" /> **编辑代理** 图标。
  </Step>

  <Step title="添加 MCP 服务器">
    在 **工具箱** 部分，点击 **MCP**。输入服务器名称和 URL，然后配置身份验证（参见 [身份验证类型](#身份验证类型)）。
  </Step>

  <Step title="保存您的代理">
    点击 **保存更改**。Fleet 将从您的 MCP 服务器发现可用工具，并使其在此代理中可用。
  </Step>
</Steps>

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

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

<Tabs>
  <Tab title="从 Fleet > 集成">
    <Steps>
      <Step title="导航到 Fleet > 集成">
        在 LangSmith UI 中，导航到 [**Fleet** > **集成**](https://smith.langchain.com/agents/tools) 标签页。
      </Step>

      <Step title="添加服务器">
        1. 点击左侧边栏底部的 **+ 自定义 MCP**。
        2. 为 MCP 服务器添加一个 **名称**。
        3. 添加 MCP **URL**（例如，`https://api.example.com/mcp`）
        4. 选择 **身份验证** 类型。有关更多详细信息，请参见 [身份验证类型](#身份验证类型)。
      </Step>

      <Step title="保存服务器">
        点击 **保存服务器**。Fleet 将自动从您的 MCP 服务器发现可用工具，并使其在您的代理中可用。配置的标头将应用于工具发现请求和工具执行请求。
      </Step>
    </Steps>
  </Tab>

  <Tab title="从工作区设置">
    <Steps>
      <Step title="导航到 MCP 服务器设置">
        在 LangSmith UI 中，导航到 [设置 > MCP 服务器](https://smith.langchain.com/settings/workspaces/mcp-servers) 标签页。
      </Step>

      <Step title="添加服务器">
        点击 **添加服务器**，输入服务器名称和 URL，然后配置身份验证（参见 [身份验证类型](#身份验证类型)）。
      </Step>

      <Step title="保存服务器">
        点击 **保存服务器**。Fleet 将自动从您的 MCP 服务器发现可用工具，并使其在您的代理中可用。配置的标头将应用于工具发现请求和工具执行请求。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 身份验证类型

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

* **标头**：添加随每个请求发送的键值对。最常见的模式是使用授权承载令牌：

  * **键**：`Authorization`
  * **值**：`Bearer API_KEY`

  <Info>
    如果您的 MCP 服务器需要额外的身份验证或配置参数，您可以添加多个标头。每个标头键值对都会随发送到服务器的每个请求一起发送。
  </Info>

* **OAuth 2.1（自动）**：为支持通过动态客户端注册进行 OAuth 的服务器选择此项。系统将提示您使用该服务的账户登录。

* **OAuth 2.1（手动）**：为支持 OAuth 但需要预先指定客户端 ID/密钥的服务器选择此项。此流程中使用的 OAuth 提供商必须启用 **PKCE**。

## 更新您的 MCP 服务器 URL

<Warning>
  更改自定义 MCP 服务器的 URL 将会破坏使用该服务器工具的任何代理。
</Warning>

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

要更新 MCP 服务器 URL：

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

## 支持的服务器

要查看所有可用的 MCP 服务器和配置详情，请导航到 [Fleet > 集成标签页](https://smith.langchain.com/agents/tools)。

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs) 通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/fleet/remote-mcp-servers.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>