Trae MCP 接入

一、适用场景

使用 OpenViking 实现：

• 跨会话记住技术栈偏好（语言版本、框架、依赖管理工具、构建系统）

• 沉淀编码风格偏好（命名约定、注释风格、是否写单测、TDD/BDD 习惯）

• 记住常用工程上下文（monorepo 结构、构建命令、部署流程、环境差异）

• 记忆历史决策与"踩坑笔记"（为什么不用 X、上次用 Y 出过什么问题）

• 个人长期任务目标 / OKR / Roadmap 沉淀，Agent 在规划任务时自动对齐

二、前置准备：获取 API Key

所有 MCP 客户端的接入都依赖同一个 Authorization Token，即 OpenViking 控制台中的 API Key。请先按以下步骤获取并妥善保存。

2.1 操作路径

1. 在左侧菜单选择 用户管理

2. 在用户列表中找到对应用户（个人版默认为 default / admin），点击 API Key 列右侧的 复制 图标

3. 将复制得到的 ZGV\.\.\.hiMg 形式的字符串妥善保存，作为后续所有 Agent 接入的 Authorization 值

安全提示：API Key 等同于账户密钥，请勿提交到 Git 仓库或公开渠道。建议通过环境变量或加密配置注入。

三、Trae 接入指南

Trae 是字节跳动推出的 AI IDE，原生支持通过 MCP 协议加载外部工具与上下文服务。以下为 OpenViking 的标准接入流程。

3.1 接入步骤

步骤 1 · 打开设置

在 Trae 主界面右上角点击 设置（齿轮图标），进入设置面板。

步骤 2 · 进入 MCP 配置页

在左侧菜单中选择 MCP，进入 MCP Servers 管理页。

步骤 3 · 新增 MCP Server

点击右侧的 + 添加 按钮，在下拉菜单中选择 手动配置。

步骤 4 · 粘贴配置 JSON

在弹出的配置框中粘贴以下 JSON，并将 Authorization 替换为第二章中复制的 API Key：

{
  "mcpServers": {
    "ov-mcp-server": {
      "url": "https://api.vikingdb.cn-beijing.volces.com/openviking/mcp",
      "headers": {
        "Authorization": "Bearer ZGVmYXV********YzdlZjhiMg"
      }
    }
  }
}

关键说明：Authorization 的值需带上 Bearer 前缀（注意空格），完整格式为 Bearer \<API Key\>。

步骤 5 · 确认并启用

点击 确认 按钮，Trae 会自动建立 MCP 连接并加载工具列表。连接成功后，ov\-mcp\-server 将出现在已配置的 MCP Servers 列表中。配置完成后，可在 MCP 管理页看到 ov\-mcp\-server 已加载并启用，右侧开关呈绿色：

步骤 6 · MCP 连通性检查

接入后建议通过两个简单 query 快速验证 MCP 是否正常工作。在 Trae 对话框中依次输入：

**① **ov ls — 列出 OpenViking 根目录内容，确认连接畅通、可正确返回目录结构。

**② **ov health — 调用 health 工具，确认 OpenViking 服务端状态与当前用户身份。

验收标准：ov ls 能返回 agent / resources / session / user 等目录；ov health 返回 service initialized 与当前用户名，即表示接入成功。

3.2 配置参数说明

四、常见问题（FAQ）

(注：内容由 AI 生成，请谨慎参考）