| 方式 | 前提 |
|---|---|
| ① 技能包 | 平台内一键安装 无需任何配置，推荐首选 |
| ② 平台连接器 | 以平台内搜到「owlwrite / 夜猫子」为准 没搜到就用方式 ③ |
| ③ 自助配置 | 注册拿到 Key + 本机 Python 3.11+ 本页后面全在讲这条 |
只支持远程 MCP（填一个 HTTP 地址那种）的网页版 Agent——比如千问办公网页版、扣子：这类需要我们在服务端开放远程端点，目前还没开放。可以先用方式 ①，或者直接上网页版个人中心充值、跑任务、下报告。
owl_sk_ 开头）只显示一次，当场复制存好。也可以纯命令行注册（适合服务器 / 无图形界面环境）：
curl -s -X POST https://owl.skillsutra.cn/v1/auth/send-code \
-H "Content-Type: application/json" -d '{"email":"你的邮箱"}'
curl -s -X POST https://owl.skillsutra.cn/v1/auth/register \
-H "Content-Type: application/json" -d '{"email":"你的邮箱","code":"邮件里的6位码"}'第二条命令的返回里 api_key 就是凭据，只出现这一次。
MCP 服务脚本在技能包里，不用另外下软件：
解压后你会看到 owlwrite-paper/scripts/mcp_server.py —— 下面每份配置里写的路径，指的就是它。
环境要求：Python ≥ 3.11，然后装两个依赖：
pip install mcp httpxC:\\Users\\...\\scripts\\mcp_server.py（双反斜杠）或用正斜杠；如果 python 命令不认，换成 python3 或 Python 安装目录的完整路径。共同三要素：OWL_BASE 固定 https://owl.skillsutra.cn（不是官网域名 paper.skillsutra.cn）；OWL_API_KEY 填第一步的 Key；args 填 mcp_server.py 的完整路径。
{
"mcpServers": {
"owlwrite": {
"command": "python",
"args": ["/你的路径/owlwrite-paper/scripts/mcp_server.py"],
"env": {
"OWL_BASE": "https://owl.skillsutra.cn",
"OWL_API_KEY": "owl_sk_你的key"
}
}
}
}{
"mcpServers": {
"owlwrite": {
"command": "python",
"args": ["/你的路径/owlwrite-paper/scripts/mcp_server.py"],
"env": {
"OWL_BASE": "https://owl.skillsutra.cn",
"OWL_API_KEY": "owl_sk_你的key"
}
}
}
}claude mcp add owlwrite \
--env OWL_BASE=https://owl.skillsutra.cn \
--env OWL_API_KEY=owl_sk_你的key \
-- python /你的路径/owlwrite-paper/scripts/mcp_server.py[mcp_servers.owlwrite]
command = "python"
args = ["/你的路径/owlwrite-paper/scripts/mcp_server.py"]
env = { OWL_BASE = "https://owl.skillsutra.cn", OWL_API_KEY = "owl_sk_你的key" }结构与 Claude Desktop 那份完全一样，粘进去即可。
owl_wallet，免费）——能返回积分，说明计费链路也通了。OWL_BASE 是不是误填成了官网域名。env 里没写，或者 Key 前后带空格、用了中文引号。重新复制粘贴一次，引号必须用英文直引号。
先确认 python 和 mcp_server.py 两个路径都对；再确认 pip install mcp httpx 装在了同一个 Python 里（多版本 Python 环境最容易踩这个）。
Key 填错或被吊销了。去个人中心重新生成一把，替换配置里的 OWL_API_KEY，重启客户端。
把客户端的 MCP 超时调到 120000 毫秒。服务端其实已经收下了，超时只是客户端等不及。
那是通道临时状态，不是你配置的问题。让 Agent 调一次 owl_meta 看 channels.weipu_detail 的说明，或过一会儿再试。
owl_products）。