---
title: 自定义 MCP
description: 将你自己的 MCP 服务器接入 LobeHub——添加私有 API、内部工具和自定义集成，超越 MCP 市场的现有选项。
tags:
  - 自定义 MCP
  - LobeHub
  - MCP
  - 模型上下文协议
  - 技能
  - 自定义集成
---

# 自定义 MCP

MCP 市场提供了数以千计的现成集成，但有时你需要接入私有 API、公司内部工具，或者自己搭建的 MCP 服务器。**自定义 MCP** 让你无需经过市场，直接将任何兼容 MCP 协议的服务器添加到 LobeHub。

## 在哪里添加自定义 MCP

你可以从以下几个入口打开「添加自定义技能」对话框：

- **设置 → 技能** — 点击**技能商店**，切换到**自定义**标签页，点击**添加自定义技能**
- **助理设置** — 打开任意助理的设置，进入**技能**，点击**添加自定义技能**
- **对话输入框** — 点击输入框上方的**工具**按钮，选择**添加自定义技能**

三个入口都会打开同一个配置对话框。

## 快速导入 JSON 配置

添加自定义 MCP 最快的方式是直接粘贴 MCP 服务器文档中提供的 JSON 配置。

<Steps>
  ### 打开导入面板

  在「添加自定义技能」对话框中，点击表单顶部的**导入 JSON 配置**，此时会出现一个文本输入框。

  ### 粘贴配置

  粘贴完整的 `mcpServers` 配置块或单个服务器配置：

  ```json
  {
    "mcpServers": {
      "my-server": {
        "command": "npx",
        "args": ["-y", "my-mcp-package"],
        "type": "stdio"
      }
    }
  }
  ```

  或者 HTTP 服务器配置：

  ```json
  {
    "mcpServers": {
      "my-api": {
        "url": "https://mcp.example.com/sse",
        "type": "http"
      }
    }
  }
  ```

  ### 点击导入

  LobeHub 会自动填入标识符、连接类型、URL 或命令等参数。确认自动填入的内容无误后，即可进行连接测试。
</Steps>

<Callout type={'info'}>大多数 MCP 服务器的文档都会提供这种格式的 JSON 配置，可以直接复制使用。推荐优先使用快速导入功能。</Callout>

## 手动配置

如果你更倾向于手动填写，可以选择连接类型后逐项填入参数。

### Streamable HTTP

适用于远程 MCP 服务器 —— 云端托管的 API、SaaS 工具，或任何可通过 HTTPS 访问的服务。Web 端和桌面端均可使用。

| 字段               | 说明                                                    |
| ---------------- | ----------------------------------------------------- |
| **MCP 名称**       | 该技能的唯一标识符（仅限字母、数字、连字符）                                |
| **Endpoint URL** | MCP 服务器的完整 HTTPS 地址（例如 `https://mcp.example.com/sse`） |
| **认证类型**         | 无认证，或 API Key（以 Bearer Token 方式传递）                    |
| **API Key**      | 选择 API Key 认证时必填                                      |
| **HTTP 请求头**     | 可选的额外请求头（展开「高级」选项设置）                                  |
| **描述**           | 可选，备注该 MCP 的用途                                        |

### STDIO

适用于在本地作为进程运行的 MCP 服务器 —— 命令行工具、脚本或本地安装的包。**仅支持 LobeHub 桌面客户端，网页版不支持此连接类型。**

| 字段         | 说明                                                    |
| ---------- | ----------------------------------------------------- |
| **MCP 名称** | 该技能的唯一标识符                                             |
| **命令**     | 要运行的可执行程序（例如 `npx`、`python`、`uv`）                     |
| **参数**     | 传递给命令的参数（例如 `-y @modelcontextprotocol/server-github`） |
| **环境变量**   | 注入到进程环境中的键值对（API Key、路径等）                             |
| **描述**     | 可选，备注该 MCP 的用途                                        |

## 测试连接

保存前，点击**测试连接**以验证 LobeHub 能否正常连接到你的 MCP 服务器并获取工具列表。测试成功后，右侧预览面板将显示可用的工具列表。

如果测试失败：

- **HTTP 类型**：检查 URL 是否正确且可访问，以及 API Key 或请求头是否配置正确。
- **STDIO 类型**：确认命令已安装并存在于系统 PATH 中，可在终端运行 `which npx`（或相应命令）进行验证。

## 保存与管理

点击**安装**将自定义 MCP 作为技能添加到工作区，它将出现在**设置 → 技能**的**自定义 MCP** 列表中。

如需后续编辑：

1. 进入**设置 → 技能**
2. 在**自定义 MCP** 下找到该技能
3. 点击**配置**重新打开完整配置对话框
4. 修改参数，测试连接，点击**更新**

如需删除，打开该技能的菜单并选择**卸载**。

## 为助理启用自定义 MCP

安装自定义 MCP 后，它在整个工作区内可用，但每个助理需要单独配置才能使用：

1. 打开助理设置
2. 进入**技能**
3. 找到该自定义 MCP 并开启
4. 该助理即可使用 MCP 服务器提供的所有工具

技能的启用是按助理维度的 —— 为某个助理开启技能，不会自动为其他助理开启。

<Callout type={'info'}>请仅安装来源可信的 MCP 服务器。恶意的 MCP 服务器可能会以你的身份执行意外操作。</Callout>

<Cards>
  <Card href={'/zh/docs/usage/community/mcp-market'} title={'MCP 市场'} />

  <Card href={'/zh/docs/usage/community/skill-management'} title={'技能管理'} />

  <Card href={'/zh/docs/usage/getting-started/agent'} title={'助理'} />
</Cards>
