1. 从 Excel 到 Gitee我为什么要折腾 Trae AgentTrae Agent 是 Trae 编辑器里可以自定义的智能体它能通过 MCPModel Context Protocol挂载外部工具把「对话」变成「真的去操作某个系统」。Gitee 是国内常用的代码托管平台Issue、Pull Request、仓库管理都能通过 API 完成。把这两者接起来就能做出一个「读 Excel 指令 → 调 Gitee 接口 → 把结果写回 Excel」的自动化助手适合经常要批量处理合并请求、同步仓库状态、又不想写一堆脚本的开发者。我最初的痛点很具体每天早上要手动拉取、合并几个仓库的 PR下班前再提交一次重复且容易漏。Excel 是最顺手的数据管理工具但 Excel 本身没法直接调 Gitee。于是我想能不能让 Trae Agent 当「中间人」——Excel 里写命令Agent 解析后通过 MCP 调 Gitee再把执行结果回写到表格里。这样非程序员也能用改一行命令就能触发一次操作。这篇分享会给出可复制的 MCP 配置骨架settings.json / config.toml 片段、TaoToken 统一 Key 的接入方式以及一次从触发到回写的完整验证动作。你跟着做能快速复现一个自定义 Agent 流程。需要说明的是Gitee MCP Server 目前提供的工具集中在 Pull Request 相关操作list_repo_pulls、merge_pull、create_pull、update_pull、get_pull_detail、comment_pull、list_pull_comments并没有 push_files 这类提交工具所以「自动提交代码」这一步暂时要绕开本文聚焦在 PR 合并与 Issue 创建这些能跑通的链路上。2. TaoToken 前置统一 Key 接入 Trae AgentTrae Agent 要调用模型来理解 Excel 指令、决定调哪个 MCP 工具这一步需要模型服务。TaoToken 提供统一的 API Key兼容常见的模型调用格式省去在多个平台之间切换账号的麻烦。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。接入分两步先在控制台创建 Key再把 Key 填进 Trae 的模型配置里。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建时建议按用途命名比如trae-agent-gitee方便后面排查是哪个 Key 在调用。注意Key 只显示一次复制后立刻存到本地密码管理器或环境变量里不要直接写进会提交到仓库的配置文件。如果你打算长期跑编码类 Agent可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用场景。只是想先验证模型能不能正确理解指令用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试几句就行。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置字段对不上时以文档为准。3. 可复制配置MCP 骨架与 Gitee 工具挂载Trae 的 MCP 配置通常放在用户目录下的 settings.json 或项目内的 config.toml。下面给一份能直接改的骨架重点是三块模型走 TaoToken、Gitee MCP Server 的启动命令、以及环境变量里的 Gitee 私人令牌。先看 settings.json 片段{ mcpServers: { gitee: { command: npx, args: [-y, gitee/mcp-server-gitee], env: { GITEE_ACCESS_TOKEN: 你的_gitee_私人令牌, GITEE_API_BASE: https://gitee.com/api/v5 } }, excel: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, ./data], env: {} } }, model: { provider: openai-compatible, baseURL: https://taotoken.net/api, apiKey: 你的_taotoken_key, model: gpt-4o-mini } }如果你用的是 config.toml 风格等价写法如下[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的_taotoken_key model gpt-4o-mini [mcp_servers.gitee] command npx args [-y, gitee/mcp-server-gitee] [mcp_servers.gitee.env] GITEE_ACCESS_TOKEN 你的_gitee_私人令牌 GITEE_API_BASE https://gitee.com/api/v5 [mcp_servers.excel] command npx args [-y, modelcontextprotocol/server-filesystem, ./data]Gitee 私人令牌在 Gitee 的「设置 → 私人令牌」里生成勾选projects、pull_requests、issues权限即可不要勾选无关的高危权限。生成后填到GITEE_ACCESS_TOKEN。Excel 这块要特别说明官方 filesystem MCP Server 只能读写文本类文件直接操作 .xlsx 会失败。我实测下来比较稳的做法是让 Agent 把 Excel 另存为 CSV用 filesystem 读写 CSV处理完再让用户手动转回 Excel或者单独挂一个支持 xlsx 的 MCP Server。下面验证流程用 CSV 演示避免卡在文件格式上。配置里几个参数的作用对照参数作用常见取值baseURL模型请求地址https://taotoken.net/apiapiKey统一鉴权 Key控制台创建的 KeyGITEE_ACCESS_TOKEN调 Gitee API 的凭证私人令牌GITEE_API_BASEGitee API 根地址https://gitee.com/api/v5args 里的路径MCP 可访问目录./data改完配置后重启 Trae让 MCP Server 重新加载。如果 Trae 里有 MCP 状态面板确认 gitee 和 excel 两个服务都是绿色运行状态。4. 验证请求从触发到回写的完整动作配置好之后先做一次最小验证读一条 CSV 命令调 Gitee 创建一个 Issue再把结果写回 CSV。这样能同时验证模型理解、MCP 工具调用、结果回写三个环节。准备./data/commands.csv内容如下命令ID,命令内容,仓库,执行时间,状态,时间戳,错误信息,返回数据 1,创建Issue,owner/repo,08:30:00,,,,然后在 Trae Agent 对话框里输入指令读取 ./data/commands.csv对每一行命令 如果命令内容是「创建Issue」调用 Gitee MCP 的创建 Issue 工具 仓库用「仓库」列的值标题用「命令内容」列的值。 执行完成后把状态、时间戳、返回数据写回同一行。Agent 会先调用 filesystem 读取 CSV再调用 Gitee MCP 的 Issue 创建工具。Gitee MCP Server 暴露的工具名以实际加载为准常见的是create_issue一类。调用成功后Gitee 仓库的 Issue 列表里会出现新条目。回写后的 CSV 大致长这样命令ID,命令内容,仓库,执行时间,状态,时间戳,错误信息,返回数据 1,创建Issue,owner/repo,08:30:00,成功,2025-06-10T08:31:00Z,,{code:0,msg:执行成功}如果这一步跑通说明整条链路是活的。接着可以换成 PR 合并命令把「命令内容」改成「合并拉取请求」Agent 会去调merge_pull。Gitee MCP 的 PR 工具列表包括 list_repo_pulls、merge_pull、create_pull、update_pull、get_pull_detail、comment_pull、list_pull_comments你可以按需在指令里点名用哪个。想先确认模型对指令的理解是否正确可以到模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 把同样的指令贴进去看它是否会规划出「读文件 → 调 Gitee → 写文件」的步骤。这一步能提前暴露 Prompt 歧义。5. 本篇常见错排查报错一MCP Server 启动失败提示 command not found。多半是 npx 不在 PATH 里或者 Node.js 版本太低。在终端执行node -v确认版本建议 18 以上再执行npx -y gitee/mcp-server-gitee --help看能否手动拉起。如果手动能跑、Trae 里不能检查 settings.json 的路径是不是绝对路径。报错二Gitee 返回 401 或 403。私人令牌没填对或者权限不够。重新生成令牌确认勾选了 pull_requests 和 issues 权限。注意令牌不要带多余空格复制时容易带上换行。报错三Excel 文件创建后打不开或 MCP 读得到写不进。这是 Excel MCP Server 的常见问题和本地 Excel 版本、文件锁都有关。我踩过的坑是Agent 创建的新 xlsx 用低版本 Excel 打开会报格式错误而自己手动建的 xlsx 又写不进去。解决办法是改用 CSV 中转或者换一个明确支持 xlsx 读写的 MCP Server。如果必须用 xlsx先关掉本地 Excel 进程避免文件被占用。报错四模型不调用 Gitee 工具只回复文字。说明 Prompt 里没把工具名和参数说清楚。在指令里明确写「调用 Gitee MCP 的 merge_pull 工具参数 owner、repo、pull_number」比笼统说「合并 PR」成功率高很多。报错五想自动提交代码但找不到工具。Gitee MCP Server 目前没有 push_files 类工具只有 PR 相关操作。自动提交这一步暂时要另想办法比如用本地 git 命令配合 Agent 执行或者等 Gitee MCP 后续补充。别在配置里硬找不存在的工具名。报错六TaoToken 请求返回 404 或鉴权失败。检查 baseURL 是不是https://taotoken.net/api注意结尾不要多加/v1之类的路径除非接入文档明确要求。Key 是否复制完整、是否过期都可以在 API Keys 页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 核对。6. 继续往下走把 Agent 用顺手的几个建议链路跑通后真正影响体验的是 Prompt 的稳定性和错误处理。我建议在指令里加一段「失败重试」逻辑某条命令调用失败时把错误信息写回 CSV 的错误信息列不要中断整个批次。这样你第二天看表格就知道哪条没执行成功而不是面对一个静默失败的 Agent。另外Gitee MCP 的工具是围绕 PR 设计的所以把自动化重点放在「批量合并 PR」「自动评论 PR」「定时拉取 PR 列表并回写状态」这几类场景收益最明显。仓库创建和 Issue 创建也能做但要注意 API 频率别在循环里无节制调用。如果你打算把这个 Agent 长期挂在日常流程里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 比按次调用更划算。配置字段有疑问时接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里有完整的参数说明。Claude Code 相关的接入方式可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 思路和 Trae 这边是相通的。最后提醒一句MCP 工具能直接操作你的 Gitee 仓库权限给到「够用」就行别图省事勾全量权限。私人令牌和 TaoToken Key 都不要写进会提交到 Git 的文件里用环境变量或本地配置隔离。