开发者/各 Agent 平台接入
接入 AI Agent:Claude Code、Codex、WorkBuddy、CodeBuddy、Kimi Code、Trae、iFlow……
桌面端点一下就接好,官方 skills 一起装上。手动接也只要一段 MCP 配置。下面按 Agent 逐个说清楚配置写在哪、接好后要做什么。
一键接入(推荐)
打开字流「设置 → 更多 → AI Agent」
这台电脑上装了哪些 Agent,这里就摆哪些(看它们的配置目录在不在)。
点你在用的那个
字流把 MCP 配置写进它的配置文件(写之前备份成
.ziliu-bak),有个人 skills 目录的顺手装上官方 skills。按提示重开一次 Agent
有的 Agent 还要在界面上点一下信任或勾选,见下面各家的说明。
手动接:通用 MCP 配置
设置页「开发者选项」里有现成的配置(路径和令牌都填好了),直接复制。格式如下:
{
"mcpServers": {
"ziliu": {
"command": "C:\\Users\\你\\AppData\\Local\\Programs\\字流\\字流.exe",
"args": ["C:\\Users\\你\\AppData\\Roaming\\ziliu-desktop\\agent\\ziliu-mcp.cjs"],
"env": { "ELECTRON_RUN_AS_NODE": "1", "ZILIU_TOKEN": "ziliu_local_你的令牌" }
}
}
}- Mac:
command是/Applications/字流.app/Contents/MacOS/字流,脚本在~/Library/Application Support/ziliu-desktop/agent/ziliu-mcp.cjs。 - 本机装了 Node 18+ 也可以:
"command": "node",env里去掉ELECTRON_RUN_AS_NODE。 - 本机接口不在默认的 17616 端口时,
env里加"ZILIU_API_URL": "http://127.0.0.1:端口"(设置页给的配置会自动带上)。 - 有的 Agent 要求写明
"type": "stdio"(WorkBuddy、CodeBuddy),一键接入会自动加。
Claude Code
claude mcp add ziliu -s user -e ELECTRON_RUN_AS_NODE=1 -e ZILIU_TOKEN=ziliu_local_你的令牌 -- "字流.exe 的路径" "ziliu-mcp.cjs 的路径"- 官方 skills 装在
~/.claude/skills/。 - 重开一个会话,输入
/mcp能看到 ziliu 就接好了。 - 试一句:「用字流看看今天该写什么」。
Codex
[mcp_servers.ziliu]
command = "字流.exe 的路径"
args = ["ziliu-mcp.cjs 的路径"]
env = { ELECTRON_RUN_AS_NODE = "1", ZILIU_TOKEN = "ziliu_local_你的令牌" }- 官方 skills 装在
~/.codex/skills/。 - 重开 Codex 会话生效。
国产 Agent
| Agent | 配置文件 | skills 目录 | 接好后 |
|---|---|---|---|
| WorkBuddy | ~/.workbuddy/mcp.json | ~/.workbuddy/skills | 重开 WorkBuddy,到「连接器」里找到 ziliu 点「信任」 |
| CodeBuddy | ~/.codebuddy/mcp.json | ~/.codebuddy/skills | 重开就能用,MCP 列表里能看到 ziliu |
| Kimi Code | ~/.kimi-code/mcp.json(老版本 ~/.kimi) | ~/.kimi-code/skills(也读 ~/.claude/skills) | 重开 kimi 会话 |
| Trae / Trae CN | %APPDATA%/Trae/User/mcp.json(Mac 在 ~/Library/Application Support/Trae/User/) | 不支持 | 重开 Trae,在智能体的 MCP 列表里勾上 ziliu |
| iFlow CLI | ~/.iflow/settings.json 的 mcpServers | ~/.iflow/skills | 重开 iflow |
| Qoder | 设置 → MCP → 添加 | — | 粘贴上面的 JSON |
| 通义灵码 | 个人设置 → MCP 服务 → 手动添加 | — | 选 stdio,命令和参数照上面填,环境变量加两项 |
| Cherry Studio | 设置 → MCP 服务器 → 从 JSON 导入 | — | 粘贴上面的 JSON |
Cursor、Windsurf、Cline 和其它支持 MCP 的客户端
凡是支持 stdio MCP 的客户端都能接:把上面的 mcpServers JSON 粘进它的 MCP 配置(Cursor 是 ~/.cursor/mcp.json)。不支持 skills 的客户端,可以把 官方 skills 的内容当作系统提示词或项目规则贴进去。
OpenClaw、Hermes、n8n 等服务器上的自动化
它们不在你电脑上,连不到本机接口。用网页版的 API Key 调云端 API 把成稿推进来;或者在跑字流的这台电脑上,用 POST /v1/content 把做好的成稿交给字流(见本机接口)。
连不上?
| 现象 | 原因和办法 |
|---|---|
ziliu_not_running | 字流没开,或者端口改过:打开字流;改过端口的在 env 里设 ZILIU_API_URL |
unauthorized(401) | 令牌不对或重置过:回设置页再点一次接入 |
plan_required(402) | 免费版只能读;写稿、剪辑、送发布要创作者版及以上 |
public_disabled(403) | 要代点发布 / 发评论,先在 AI Agent 设置里打开「允许 AI 代点发布」 |
| Agent 里看不到 ziliu | 没重开 Agent;或 WorkBuddy 没点信任、Trae 没勾选 |