1. 为什么要把 xiaohongshu-mcp 接到统一 AI 通道上
xiaohongshu-mcp 是一个基于 Model Context Protocol 的开源项目,它把小红书的图文发布、搜索、点赞收藏、评论互动这些动作封装成标准 MCP 工具,让 Claude Code、Cursor、Cline 这类支持 MCP 的 AI 客户端可以直接用自然语言调用。简单说,你对着 AI 说「帮我发一篇带三张图的笔记,标题写周末露营」,它就能通过 MCP 协议把这条指令翻译成浏览器自动化操作,落到小红书平台上。适合谁?内容创作者想批量管理笔记、营销团队要做多账号互动、开发者想把小红书能力嵌进自己的 LLM 工作流,都能用得上。
但真正跑起来你会发现一个绕不开的问题:MCP 客户端本身要接大模型,而模型调用需要 Key、Base URL、Model ID 三样东西。如果你同时用 Claude Code 写代码、用 Cline 做 Agent、又想让 xiaohongshu-mcp 在后台跑自动化,每个客户端各配一套 Key,管理起来非常碎。我试过在三个工具里分别填不同的供应商配置,结果某天一个 Key 额度用完,排查了半天才定位到是哪个客户端在报 401。
TaoToken 在这里的角色就是统一通道:一个 Base URL、一个 Key,兼容 Anthropic 和 OpenAI 两种协议格式,MCP 客户端和背后的模型调用都走同一个入口。这样 xiaohongshu-mcp 负责「操作小红书」,TaoToken 负责「让 AI 理解你的指令」,两边解耦,配置量直接砍半。下面我会从环境准备、MCP 服务配置、TaoToken 接入、启动验证到报错排查,一步步带你跑通。
2. 前置准备:xiaohongshu-mcp 本地部署与 TaoToken Key 获取
2.1 部署 xiaohongshu-mcp 服务
先拿到可执行文件。macOS Apple Silicon 可以直接下载 release 二进制,Linux 和 Windows 同理换对应后缀:
# macOS Apple Silicon 示例 wget https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-arm64 chmod +x xiaohongshu-mcp-darwin-arm64 # 先跑登录工具,扫码登录小红书 ./xiaohongshu-login-darwin-arm64 # 登录成功后启动 MCP 服务 ./xiaohongshu-mcp-darwin-arm64如果你更习惯 Docker,用官方 compose 文件更省事:
docker pull xpzouying/xiaohongshu-mcp wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml docker compose up -d源码编译路线适合要改代码的开发者:
git clone https://github.com/xpzouying/xiaohongshu-mcp.git cd xiaohongshu-mcp go mod download go build -o xiaohongshu-mcp . go run cmd/login/main.go # 登录 go run . # 启动服务默认监听本地端口,登录态以 Cookie 形式存在本地,不会上传到任何第三方。这一步的关键是先登录再启动,否则 MCP 工具列表里发布类工具会直接报未认证。
2.2 获取 TaoToken 的 Base URL 与 Key
打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,注册后在控制台创建 API Key。你会拿到两样东西:
- Base URL:
https://taotoken.net/api(注意 API 地址不带 UTM 参数) - API Key:形如
sk-xxxx的一串字符
TaoToken 同时兼容 Anthropic 协议和 OpenAI 协议,所以 Claude Code 走 Anthropic 格式、Cline 走 OpenAI 格式都能对接同一个 Key。控制台里还能看到额度消耗和调用日志,方便你确认 xiaohongshu-mcp 触发的模型请求到底走没走通。Key 创建入口在 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,建议单独建一个给 MCP 用的 Key,方便按项目隔离额度。
3. 可复制配置:MCP 客户端接入 TaoToken 统一通道
3.1 Claude Code 的 settings.json 配置
Claude Code 读取~/.claude/settings.json,把模型通道指向 TaoToken:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }这里三件套齐全:Base URL 是https://taotoken.net/api,Key 填在ANTHROPIC_AUTH_TOKEN,Model ID 按你实际可用的模型名填。改完重启 Claude Code,它就会通过 TaoToken 发请求。
3.2 Cline / Cursor 的 MCP 配置
Cline 和 Cursor 都支持在设置里加 MCP Server。以 Cline 为例,在 MCP 配置面板填入:
{ "mcpServers": { "xiaohongshu": { "command": "/path/to/xiaohongshu-mcp-darwin-arm64", "args": [], "env": { "HEADLESS": "true" } } } }同时 Cline 的模型供应商选 OpenAI Compatible,Base URL 填https://taotoken.net/api,API Key 填 TaoToken 的 Key,Model ID 填你用的模型。这样 Cline 一边通过 TaoToken 调模型,一边通过 MCP 协议调 xiaohongshu-mcp 的工具,两条链路互不干扰。
3.3 Codex 的 auth.json 配置
如果你用 Codex CLI,配置写在~/.codex/auth.json:
{ "OPENAI_BASE_URL": "https://taotoken.net/api", "OPENAI_API_KEY": "sk-你的TaoToken密钥", "OPENAI_MODEL": "gpt-4o" }同样三件套:Base URL、Key、Model ID。Codex 走 OpenAI 协议,TaoToken 的/api端点会自动适配。
3.4 CC Switch 多客户端切换
如果你在 Claude Code、Cline、Codex 之间来回切,可以用 CC Switch 统一管理配置。在 CC Switch 里新增一个供应商,Base URL 填https://taotoken.net/api,Key 填 TaoToken 的 Key,然后给每个客户端指定不同的 Model ID。切换时一键生效,不用手动改每个配置文件。这一步能省掉大量「改了 A 忘了改 B」的排查时间。
4. 启动验证:检查 MCP 工具列表与一次自动化发布
4.1 确认 MCP 服务已注册工具
启动 xiaohongshu-mcp 后,在 Claude Code 或 Cline 里输入查看 MCP 工具的指令,正常应该看到类似这样的工具列表:
xiaohongshu_publish_content 发布图文/视频内容 xiaohongshu_search_notes 搜索笔记 xiaohongshu_like_note 点赞 xiaohongshu_favorite_note 收藏 xiaohongshu_post_comment 评论 xiaohongshu_get_user_profile 获取用户资料如果列表为空,说明 MCP Server 没连上,先检查command路径是否写对、二进制是否有执行权限。如果工具在但调用报未认证,回到 2.1 重新扫码登录。
4.2 验证 TaoToken 通道是否通
在客户端里发一句简单指令,比如「用一句话介绍你自己」,观察是否正常返回。如果返回正常,说明 TaoToken 的 Base URL 和 Key 配置生效。你也可以直接 curl 验证:
curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的TaoToken密钥" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 100, "messages": [{"role": "user", "content": "ping"}] }'返回带content字段的 JSON 就说明通道正常。
4.3 跑一次自动化发布动作
确认两条链路都通后,在客户端里下一条完整指令:
帮我发布一篇小红书笔记,标题「周末露营装备清单」, 内容「这周末去了郊外露营,整理了一份轻量化装备清单, 帐篷、睡袋、炉具都在这了」,配图用 /Users/me/Pictures/camping1.jpg 和 /Users/me/Pictures/camping2.jpgAI 会先通过 TaoToken 理解你的意图,再调用xiaohongshu_publish_content工具,把标题、正文、图片路径传进去。你可以在 xiaohongshu-mcp 的日志里看到工具调用记录,发布成功后小红书账号会收到新笔记。注意标题最多 20 字符、正文最多 1000 字符,超了会被工具侧拦截。
5. 常见报错排查:401、local proxy failed、reading choices、OAuth
5.1 401 Unauthorized
最常见的是 Key 填错或没生效。检查三处:TaoToken 控制台里 Key 是否被禁用、配置文件里ANTHROPIC_AUTH_TOKEN或OPENAI_API_KEY是否有多余空格、Base URL 是否写成了带 UTM 的完整链接。Base URL 必须是https://taotoken.net/api,不要带查询参数。
5.2 local proxy failed
这个报错通常出现在 MCP 客户端启动时,说明客户端尝试连本地代理但失败了。检查 xiaohongshu-mcp 的command路径是否是绝对路径、二进制是否有执行权限(chmod +x)、端口是否被占用。如果是 Docker 部署,确认容器内服务端口和宿主机映射一致。
5.3 reading choices 报错
这个错误一般来自模型返回格式不符合预期,常见于 Model ID 填错。比如你填了一个 TaoToken 通道不支持的模型名,返回体里没有choices字段。解决方法是回到 TaoToken 控制台确认可用模型列表,把 Model ID 改成实际支持的名称。Claude 系列走 Anthropic 格式,GPT 系列走 OpenAI 格式,别混用。
5.4 OAuth 相关报错
如果客户端提示 OAuth 失败,多半是登录态过期。xiaohongshu-mcp 的登录 Cookie 有有效期,过期后需要重新跑登录工具扫码。TaoToken 侧不需要 OAuth,它用的是 API Key 认证,所以 OAuth 报错基本都出在小红书登录态上,重新登录即可。
5.5 工具调用成功但发布失败
这种情况通常是内容校验没过。标题超 20 字符、正文超 1000 字符、图片路径不存在,都会导致发布工具返回错误。建议先在客户端里让 AI 帮你检查一遍内容长度,再执行发布。
6. 把统一通道用顺手的几个实践建议
跑通之后,我习惯把 TaoToken 的 Key 按用途拆开:一个给 Claude Code 写代码用,一个给 xiaohongshu-mcp 的自动化流程用,一个给 Cline 做 Agent 实验用。这样哪个环节额度异常,看控制台日志就能定位,不用在多个客户端之间猜。
另外 xiaohongshu-mcp 的HEADLESS环境变量建议设成true,服务在后台跑不弹浏览器窗口,适合长期挂机。如果你要批量操作多个账号,每个账号单独跑一个 MCP 实例、配不同的登录 Cookie 目录,避免串号。
模型选择上,发布类任务用响应快的小模型就够,搜索和内容分析类任务再切到能力更强的模型。TaoToken 的模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,可以先去那里确认你要用的 Model ID 是否在列。长期跑编码和 Agent 任务的话,Coding Plan 在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,按套餐走比按量计费更可控。
最后提醒一句:自动化工具再方便,发布前也建议人工过一眼内容。AI 生成的标题和正文偶尔会跑偏,尤其是带话题标签的时候。把 xiaohongshu-mcp 当成效率放大器而不是全自动黑盒,用起来会更踏实。