MCP Server 安装链接 - TraeCode入门教程 - AI教程

你可以通过 TraeCode 的 Schema 链接将 MCP Server 安装至 TraeCode。

安装链接说明

链接的格式如下：

trae-cn://trae.ai-ide/mcp-import?type=${TYPE}&name=${NAME}&config=${BASE64_ENCODED_CONFIG}

链接中各组成部分的说明如下：

组成部分	是否必填	描述
`trae-cn://`	是	协议方案，需使用 `trae-cn://`。
`trae.ai-ide`	是	固定部分，Schema 链接处理程序。
`/mcp-import`	是	固定部分，Schema 路径。
`type`	是	MCP Server 的类型。可选值：`stdio`、`http`。
`name`	否	MCP Server 的自定义名称。
`config`	是	Base64 编码的 JSON 配置。

生成安装链接

你可以通过自动生成或手动生成两种方式来生成 MCP Server 的安装链接。

自动生成

打开 TRAE MCP 安装链接生成工具。
在 JSON 配置 处，输入 MCP Server 的 JSON 配置。 安装链接 处自动生成该 MCP Server 的安装链接。
点击 复制链接 按钮，复制该 MCP Server 的安装链接。

手动生成

以下述 GitHub MCP Server 为例，说明手动生成安装链接的步骤。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

步骤如下：

获取 MCP Server 的类型、自定义名称、以及 JSON 配置。在本示例中：

type：stdio
name：github

config：

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-github"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
  }
}

依次对 config JSON 对象进行 JSON.stringify() 序列化、Base64 编码，以及 URL 编码。在本示例中：
- JSON.stringify() 序列化结果：{"command":"npx","args":["-y","@modelcontextprotocol/server-github"],"env":{"GITHUB_PERSONAL_ACCESS_TOKEN":"<YOUR_TOKEN>"}}
- Base64 编码结果：eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb2RlbGNvbnRleHRwcm90b2NvbC9zZXJ2ZXItZ2l0aHViIl0sImVudiI6eyJHSVRIVUJfUEVSU09OQUxfQUNDRVNTX1RPS0VOIjoiPFlPVVJfVE9LRU4+In19
- URL 编码结果：eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb2RlbGNvbnRleHRwcm90b2NvbC9zZXJ2ZXItZ2l0aHViIl0sImVudiI6eyJHSVRIVUJfUEVSU09OQUxfQUNDRVNTX1RPS0VOIjoiPFlPVVJfVE9LRU4%2BIn19
将链接模板中的 ${TYPE}、${NAME} 和 ${BASE64_ENCODED_CONFIG} 替换为 MCP Server 的实际类型、名称和 URL 编码后的 JSON 配置。在本示例中，最终安装链接为 trae-cn://trae.ai-ide/mcp-import?type=stdio&name=github&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb2RlbGNvbnRleHRwcm90b2NvbC9zZXJ2ZXItZ2l0aHViIl0sImVudiI6eyJHSVRIVUJfUEVSU09OQUxfQUNDRVNTX1RPS0VOIjoiPFlPVVJfVE9LRU4%2BIn19