从零开发智慧农业预约系统：蔬菜成熟预测与采摘预约实战
2026/10/17 18:38:39
1. 为什么要在 Claude Code 里给 Kimi K2 挂上 MCP
Kimi K2 是月之暗面推出的 MoE 架构基础模型，代码和 Agent 能力都很能打，尤其是高速版 Kimi-K2-Turbo-Preview，输出速度能到 60~100 Token/s，上下文拉到 256K。把它接进 Claude Code 之后，你相当于用一个熟悉的终端 Agent 外壳，驱动一个响应很快的国产模型，日常写代码、跑自动化、做本地测试都挺顺手。
但光有模型还不够。Claude Code 真正的威力在于 MCP（Model Context Protocol）——它是一套让模型调用外部工具的协议。你可以把 MCP 理解成给 Agent 装的「插件」：装了 Playwright MCP，它就能自己开浏览器点页面；装了 EdgeOne Pages MCP，它就能把生成的 HTML 直接发布成公网链接；装了小红书 MCP，它就能帮你操作账号发帖、抓数据。模型负责思考，MCP 负责动手，两者一结合，才叫丝滑。
这篇面向的是本地开发和自动化测试场景：你手头有 Node.js 环境，想让 Kimi K2 + Claude Code 真正能操作浏览器、能跑 Node 脚本、能把产物发布出去。我会给出可复制的 MCP 配置片段、依赖安装命令，以及连通性验证动作，照着做基本能复现。核心检索词就三个：Kimi K2、Claude Code、MCP，全文围绕它们展开。
先说清楚适合谁：如果你只是想聊天，那没必要折腾；但如果你想在终端里让 AI 帮你跑 Playwright 自动化、执行 Node.js 脚本、做端到端测试，这套组合值得花半小时配好。下面从环境准备开始，一步步来。
2. 前置准备：Node.js、Claude Code 与 Kimi K2 接入
这一章把地基打好。MCP 服务大多是基于 Node.js 的，所以 Node 环境是硬前提；Claude Code 是宿主；Kimi K2 是驱动模型。三者缺一不可。
2.1 安装 Node.js 并验证版本
macOS 用户最省事的方式是用 Homebrew。先装命令行工具，再装 Node：
# macOS 安装命令行工具 sudo xcode-select --install # 安装 Homebrew（已装可跳过） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装 Node.js brew install node # 验证 node --version npm --versionWindows 用户建议先装 git-for-windows，然后在 git-bash 里操作，用 pnpm 安装会更顺。验证标准很简单：node --version能打印出版本号（比如 v20.x）就说明 OK。如果提示 command not found，多半是 PATH 没生效，重开一个终端窗口再试。
2.2 安装 Claude Code
Node 就绪后，用 npm 全局安装 Claude Code：
npm install -g @anthropic-ai/claude-code # 验证 claude --version能显示版本号就进入下一步。如果安装卡住，检查一下 npm 源，或者换 pnpm：pnpm install -g @anthropic-ai/claude-code。
2.3 接入 Kimi K2 Turbo
这里用环境变量把 Claude Code 的请求指向 Kimi K2 高速版。先拿到 API Key，然后设置三个关键变量：
# Linux/macOS 启动 kimi-k2-turbo-preview export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY} export ANTHROPIC_MODEL=kimi-k2-turbo-preview export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview claudeANTHROPIC_AUTH_TOKEN填你刚复制的 Key，别泄露。启动后输入/status，看 API Configuration 和 Model 是不是指向 Kimi K2 高速版。确认无误，模型层就通了。
如果你希望统一管理多家模型的 Key 和 Base URL，也可以走 TaoToken 这类聚合入口，把不同模型的凭证集中配置，切换时不用反复改环境变量。它的 API 地址是https://taotoken.net/api，控制台在https://taotoken.net/console，API Key 在https://taotoken.net/api-keys管理。对需要频繁在 Kimi K2 和其他模型之间切换的开发者来说，这种集中管理能省不少事。
2.4 MCP 配置文件的落点
Claude Code 的 MCP 配置通常写在项目级或用户级配置里。项目级一般在项目根目录的.mcp.json，用户级在~/.claude.json或~/.config/claude/下。不同版本路径略有差异，用/mcp命令能看到当前加载了哪些服务。记住这个位置，下一章要往里写配置。
3. 可复制配置：Playwright、Node.js 与发布类 MCP
这一章是重点，给出能直接抄的配置片段。MCP 服务本质是一个可执行进程，Claude Code 通过 stdio 或 HTTP 跟它通信。配置里要写清楚 command、args 和环境变量。
3.1 Playwright MCP 配置片段
Playwright MCP 让 Agent 能操作浏览器。最省事的装法是直接在 Claude Code 里说「帮我安装并配置 Playwright MCP」，它会自己查、自己装。但如果你想手动控制，配置长这样：
{ "mcpServers": { "playwright": { "command": "npx", "args": [ "-y", "@playwright/mcp@latest" ], "env": { "PLAYWRIGHT_BROWSERS_PATH": "0" } } } }把这段写进.mcp.json的mcpServers字段。npx -y会自动拉取最新版，不用手动npm install。PLAYWRIGHT_BROWSERS_PATH=0表示浏览器装在项目本地，避免污染全局。
3.2 Node.js 执行类 MCP 配置
自动化测试经常要让 Agent 跑 Node 脚本。可以用一个通用的文件系统 + 命令执行 MCP，或者直接用官方的 filesystem server 配合 shell 能力。下面是一个能读写文件、执行命令的配置示例：
{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/projects" ] }, "shell": { "command": "npx", "args": [ "-y", "mcp-server-shell" ], "env": { "ALLOWED_COMMANDS": "node,npm,npx,pnpm" } } } }filesystem的最后一个参数是允许访问的目录，改成你自己的项目路径。shell的ALLOWED_COMMANDS做白名单，只放行 node 相关命令，安全一些。注意别把生产库路径或敏感目录塞进去。
3.3 发布类 MCP（EdgeOne Pages）配置
生成的 HTML 想发布成公网链接，可以用 EdgeOne Pages MCP：
{ "mcpServers": { "edgeone-pages": { "command": "npx", "args": [ "-y", "edgeone-pages-mcp" ] } } }同样写进mcpServers。装好后让 Claude Code 生成一个页面并发布，它会返回一个可访问的 URL。
3.4 三件套对照表
不管配哪个 MCP，核心就三样：Base URL、Key、Model ID。下面这张表帮你对照：
| 项目 | 值 | 说明 |
|---|---|---|
| Base URL | https://api.moonshot.cn/anthropic | Kimi K2 的 Anthropic 兼容端点 |
| API Key | 你的 Moonshot Key | 从控制台创建，勿泄露 |
| Model ID | kimi-k2-turbo-preview | 高速版，256K 上下文 |
| Small/Fast Model | kimi-k2-turbo-preview | 小任务也走同一模型 |
注意：配置里的路径、Key、Model ID 必须和实际一致，任何一处写错都会导致连接失败。改完配置后重启 Claude Code 让配置生效。
4. 验证请求：确认 MCP 真的连上了
配置写完不代表能用，必须验证。这一章给出具体的验证动作和成功标志。
4.1 用 /mcp 查看服务状态
在 Claude Code 里输入：
/mcp你会看到当前加载的 MCP 服务列表。每个服务后面会显示状态：connected是绿色对号表示连上了；如果是空的或者报错，说明配置有问题。Playwright 应该显示playwright且状态为 connected。
4.2 实测 Playwright：让它开浏览器搜天气
最直观的验证是下一条指令：
你打开浏览器，访问百度，搜索一下今天最新的天气如果配置正确，你会看到它自己启动一个浏览器窗口，输入百度域名，搜索天气，然后把结果读回来。整个过程你能肉眼看到浏览器在动。这一步成功，说明 Playwright MCP 完全通了。
4.3 实测 Node.js：跑一个脚本
让它执行一段 Node 代码验证 shell 能力：
帮我写一个 Node.js 脚本，打印当前时间和 Node 版本，然后运行它正常的话它会生成.js文件，调用 node 执行，把输出贴回来。如果报「command not allowed」，检查ALLOWED_COMMANDS白名单有没有放行 node。
4.4 实测发布：生成页面并拿链接
帮我写一个美观的 Kimi K2 介绍网页，并且发布出去谁都能访问成功后它会返回一个公网 URL，复制到浏览器能打开。这一步验证了发布类 MCP 的连通性。
4.5 验证成功的判断标准
三个测试都通过，说明 Kimi K2 + Claude Code + MCP 这条链路完全打通。如果某个环节失败，先看/mcp状态，再对照下一章的报错排查。
5. 常见报错排查：401、local proxy failed 与 OAuth
配 MCP 的过程里，报错基本集中在几类。这一章对照真实错误给出排查路径。
5.1 401 Unauthorized
最常见。原因通常是 API Key 写错、过期，或者环境变量没生效。
Error: 401 Unauthorized - invalid api key排查步骤：先echo $ANTHROPIC_AUTH_TOKEN看变量有没有值；再确认 Key 没有多余空格；最后检查 Base URL 是不是https://api.moonshot.cn/anthropic。如果用的是聚合入口，确认 Key 是在对应控制台创建的，别拿错平台的 Key。
5.2 local proxy failed / connection refused
Error: local proxy failed to connect这通常是 MCP 服务进程没起来。原因可能是npx拉包失败、Node 版本太低、或者网络问题。先手动在终端跑一遍配置里的 command，看能不能启动：
npx -y @playwright/mcp@latest如果手动能跑，说明是 Claude Code 加载配置的路径不对；如果手动也报错，就是包本身或环境问题。检查 Node 版本是否 ≥18。
5.3 reading 'choices' of undefined
TypeError: Cannot read properties of undefined (reading 'choices')这个报错一般出现在模型返回格式不符合预期时，多半是 Base URL 或 Model ID 配错，导致请求打到了不兼容的端点。确认ANTHROPIC_BASE_URL指向的是 Anthropic 兼容接口，ANTHROPIC_MODEL填的是kimi-k2-turbo-preview这种有效 ID。改完重启 Claude Code。
5.4 OAuth 相关报错
有些 MCP 服务需要 OAuth 授权（比如发布类、账号类）。报错通常提示 token 缺失或过期：
Error: OAuth token expired, please re-authenticate按提示重新走一遍授权流程即可。如果是小红书这类需要扫码登录的 MCP，确保在浏览器窗口里完成扫码，别中途关掉。
5.5 配置不生效
改完.mcp.json后没反应，八成是没重启。Claude Code 启动时加载配置，运行中改文件不会热更新。退出重进，再用/mcp确认。
提示：排查时优先看
/mcp的状态输出，它比日志更直观。状态为 connected 才说明服务真正可用。
6. 把 Kimi K2 + Claude Code 用顺手的几个建议
配好只是开始，用顺手还需要一点技巧。这一章给几条实战经验。
第一，模型选择上，日常编码和 Agent 任务优先用kimi-k2-turbo-preview，速度快、上下文长，跑自动化测试时等待时间明显更短。如果遇到复杂推理，再考虑切换其他版本。
第二，MCP 不要一次装太多。每个 MCP 都是一个常驻进程，装太多会拖慢启动、增加排查难度。按需装，用完可以临时禁用。Playwright、filesystem、发布类这三个覆盖了大部分本地开发和自动化测试场景，够用了。
第三，凭证管理要规范。如果你同时用多家模型，建议用统一的聚合入口管理 Key 和 Base URL，避免环境变量里堆一堆。TaoToken 的 API 地址是https://taotoken.net/api，控制台https://taotoken.net/console，Key 在https://taotoken.net/api-keys，模型对话入口在https://taotoken.net/models，需要长期跑编码和 Agent 任务的可以看 Coding Plan：https://taotoken.net/coding-plan。接入文档在https://taotoken.net/doc，Claude Code 相关配置参考https://taotoken.net/claude-code。
第四，自动化测试场景里，让 Agent 先跑通一条最小用例，再逐步加复杂度。比如先让它打开一个页面截图，成功后再加点击、填表单、断言。一步到位容易在某个环节卡住，不好定位。
第五，安全边界要守住。filesystem MCP 的目录别指向生产环境或含敏感数据的路径；shell MCP 的命令白名单只放行必要命令。Agent 能力越强，越要限制它的活动范围。
最后，遇到问题先看/mcp状态，再手动复现 command，最后查环境变量。这套排查顺序能解决八成以上的接入问题。把这三步养成习惯，后面换任何 MCP 都能快速上手。