企业官网建设流程全解析

在 Trae 里配飞书 MCP，很多人卡住的地方其实不在飞书那一侧。权限勾了、版本发了、App ID 和 App Secret 也复制了，mcp.json 里的三个变量一个不差，结果 MCP 列表还是转圈加载不出来，群聊建不了、文档传不上去。问题往往出在更前面一层：Trae 里的模型通道没打通。MCP 只是给 Trae 装了一双手，真正发起调用、消耗 Token 的是 Trae 里的模型，模型通道不通，工具再全也调不动。这篇就把顺序理一遍，先解决模型通道，再回到飞书 MCP 的配置，最后用一个上传加读回的闭环验证整条链路。模型通道这一步用 TaoToken 来做，打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建一个 Key，后面在 Trae 的模型设置里填上 Base URL 和 Key 就行。

一、先搞清楚 Trae、模型通道、飞书 MCP 三者的关系

Trae 是一个带 Agent 能力的编辑器，它能调用外部工具，靠的是 MCP 协议。飞书 MCP 就是其中一个工具服务，通过 npx 拉起 @larksuiteoapi/lark-mcp，把飞书的群聊、云文档、多维表格这些能力暴露给 Trae。

但这里有个容易被忽略的点：MCP 服务本身不产生智能。它只是把「创建群聊」「上传文档」「读取文档」这些动作包装成 Trae 可以调用的函数。真正决定「要不要调这个函数」「传什么参数」的，是 Trae 背后的模型。模型要能正常响应，Trae 才会去读 mcp.json、才会去拉起 MCP 进程、才会把工具列表加载出来。

所以当模型通道不通的时候，表现就是 MCP 一直加载中，或者加载出来了但一调用就报错。很多人以为是飞书权限没配对，反复回去勾权限、重新发版本，其实方向反了。正确的顺序是：先把 Trae 的模型通道配通，确认模型能正常对话，再去配飞书 MCP。

TaoToken 在这里的角色很单一，就是提供模型通道需要的 Base URL 和 Key。它不碰飞书开放平台的任何权限设置，也不碰 mcp.json 里的 APP_ID、APP_SECRET、user_access_token 这三个变量。这两件事是分开的，别混在一起排查。

二、TaoToken 前置：先把模型通道配好

打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，注册账号，进入控制台创建一个 API Key。这个 Key 就是后面要填进 Trae 的东西。

创建 Key 的入口在控制台的 API Keys 页面，进去之后新建一个，复制出来保存好。这个 Key 只在创建的时候完整显示一次，后面再想看只能重新生成，所以先存到顺手的地方。

然后回到 Trae，找到模型设置的地方。不同版本的 Trae 入口位置略有差异，一般在设置里的模型或 AI 配置区域。把两样东西填进去：

• Base URL 填https://taotoken.net/api
• API Key 填刚才创建的那串YOUR_API_KEY

这里有两个细节要注意。第一，Base URL 不要带/v1，就填到/api为止。第二，不要填成官网首页https://taotoken.net/，首页是给人看的页面，不是接口地址，填错了请求会直接失败。第三，这个地址后面不加任何 UTM 参数，保持干净。

填完之后，先在 Trae 里发一句普通对话，确认模型能正常回。这一步过了，说明模型通道通了，再往下走飞书 MCP 才有意义。如果这一步就不通，先别碰 mcp.json，回头检查 Base URL 和 Key 有没有填错。

三、回到飞书侧：建应用、开权限、拿三个变量

模型通道确认没问题之后，再回到飞书开放平台这一侧。这部分和常规流程一样，按顺序走。

第一步，打开飞书开放平台，创建一个企业自建应用。虽然写的是企业，但个人也可以建，不会卡审核。

第二步，添加权限。这一步是重灾区，很多人在这里反复报没权限。要点是：不只要添加「能力」，还要在「权限管理」里勾选权限。飞书是企业级应用，权限分应用身份权限和用户身份权限两类，两边都要处理。

在应用身份权限里，把「消息与群组」「云文档」「多维表格」这几组全部勾上。云文档这组尤其重要，因为 Trae 上传的文档都落在云文档里，后面要让 Trae 读回文档生成代码，也依赖这组权限。用户身份权限同样全部勾选，然后点右下角确定开通权限。

第三步，创建版本并发布。勾完权限后，顶部会出现「创建版本」的提示，点进去填应用版本号和更新说明。版本号要符合0.0.0这种格式，更新说明随便写，滑到底保存并申请发布。

第四步，拿 App ID 和 App Secret。回到应用页面，点「凭证和基础信息」，这里能看到 App ID 和 App Secret，复制保存。这两个后面要填进 mcp.json。

第五步，拿 user_access_token。从应用后台打开一个权限，点详情进入飞书说明文档，点右上角的 API 调试台。进去之后先确认当前应用是不是你要操作 MCP 的那个应用，不是的话手动切换。然后点「获取 Token」，点授权，就能看到 user_access_token 了，复制保存。

到这里，三个变量就齐了：App ID、App Secret、user_access_token。

四、可复制配置：把三个变量填进 mcp.json

Trae 管理多个 MCP，靠的就是 mcp.json 文件，里面可以放多个 MCP 配置。飞书官方文档里给了现成的 JSON，复制过来，把三个变量替换掉就行。

对象式配置长这样：

{ "mcpServers": { "feishu-mcp": { "command": "npx", "args": [ "-y", "@larksuiteoapi/lark-mcp", "mcp" ], "env": { "APP_ID": "你的", "APP_SECRET": "你的", "user_access_token": "你的" } } } }

把APP_ID、APP_SECRET、user_access_token三个值换成上一步拿到的真实值。注意引号别丢，值直接替换引号里的内容。

还有一种是命令式配置，把参数直接写在 args 里：

{ "mcpServers": { "feishu": { "command": "npx", "args": [ "-y", "@larksuiteoapi/lark-mcp", "mcp", "-a", "你的APP_ID", "-s", "你的APP_SECRET", "-u", "你的user_access_token" ] } } }

两种写法选一种就行，不要同时配两个飞书 MCP，容易冲突。改完保存 mcp.json，回到 Trae 稍等一会儿，等 MCP 加载。

这里再强调一次：mcp.json 里只放飞书相关的三个变量，不要往里塞 TaoToken 的 Key 或 Base URL。TaoToken 的东西在 Trae 的模型设置里，两者不在一个地方。

五、验证请求：上传文档再读回，跑通才算数

MCP 加载出来之后，别急着说成功了，用一个闭环验证一下。

先准备一个本地项目文件，比如一个日志系统的代码文件。在 Trae 里让它把这个文件上传到飞书云文档。如果模型通道和飞书 MCP 都通了，Trae 会调用飞书的文档创建接口，把文件内容写进去。

然后去飞书云文档里确认一下，文件是不是真的出现了。这一步验证的是「写」的方向。

接着做「读」的方向。把刚才那份云文档的链接复制出来，回到 Trae，让它读取这个链接里的内容，并基于内容生成代码。如果 Trae 能读到文档内容并正常生成，说明读的方向也通了。

两个方向都跑通，才说明模型通道和飞书 MCP 这条链路是完整的。只加载出 MCP 列表不算数，列表加载出来但一调用就报错的情况很常见，必须用实际动作验证。

六、本篇常见错排查

MCP 一直加载不出来。先回去确认 Trae 的模型通道是不是通的，发一句普通对话试试。模型不通，MCP 不会正常加载。再检查 Base URL 是不是填成了https://taotoken.net/首页，正确写法是https://taotoken.net/api，不带/v1。

调用时报没权限。大概率是飞书权限没勾全。回去检查应用身份权限和用户身份权限两边，消息与群组、云文档、多维表格这几组是不是都勾了，勾完有没有创建版本并发布。权限改了不重新发版本，是不生效的。

user_access_token 失效。这个 token 有有效期，过期之后调用会失败。回飞书 API 调试台重新获取一次，替换 mcp.json 里的值，保存后等 MCP 重新加载。

mcp.json 改了没反应。确认文件保存了，然后重启一下 Trae 或者手动触发 MCP 重新加载。有时候进程还挂着旧的配置，需要让它重新拉一次。

两个飞书 MCP 同时配了。对象式和命令式选一种，同时配两个会导致工具重复或冲突，删掉一个再试。

Base URL 和 Key 填串了位置。Base URL 填地址，Key 填密钥，别把 Key 填到 Base URL 那一栏。填完先在 Trae 里发一句对话验证，通过了再往下走。

排查的顺序建议是：先确认模型通道通不通，再确认飞书权限全不全，最后确认 mcp.json 里的三个变量对不对。按这个顺序走，大部分问题都能定位到。

七、把 Key 和文档入口收好

整条链路里，TaoToken 负责的是模型通道这一段，给你一个 Base URL 和一个 Key，让 Trae 里的模型能正常跑起来。飞书那一侧的权限、应用、token，还是按飞书开放平台的流程走，两边各管各的。

如果你在配 Key 或者填 Base URL 的时候遇到问题，可以直接去 API Keys 页面重新生成一个 Key，或者翻一下接入文档对照着填。文档里对 Base URL 的写法和 Key 的用法有说明，照着来不容易出错。

模型通道配通之后，想验证模型本身是否正常，可以去模型对话页面发几条消息试试，确认响应没问题再回到 Trae 里配 MCP。如果你打算长期用 Trae 做编码和 Agent 类的任务，可以考虑 Coding Plan，把模型通道这块固定下来，省得每次都要重新配。

把 Key 存好，把云文档入口记好，后面 Trae 上传和读取文档都会用到。整条链路跑通一次之后，后面就是重复使用的事了。