用途：在 Next.js 项目中加入 Agentation 批注工具栏，用于在开发时对页面进行可视化反馈，并可将批注同步给 AI 编码代理。
主要能力：提供 <Agentation /> 组件；通过 MCP 服务器实现批注与 AI 代理的实时同步；MCP 服务器默认在 4747 端口运行 HTTP 服务，并暴露 agentation_get_all_pending、agentation_resolve、agentation_watch_annotations 等工具。
使用方式：先检查 package.json 是否已有 agentation 依赖，没有则运行 npm install agentation（或按 lockfile 使用 pnpm/yarn）。再检查 src/ 或 app/ 中是否已存在 <Agentation 或 import { Agentation }。Next.js App Router 在 app/layout 的 body 内、children 之后加入 {process.env.NODE_ENV === "development" && <Agentation />}；Pages Router 在 pages/_app 的 Component 之后加入同样代码。之后可配置 MCP 服务器：通用方式运行 npx add-mcp 并按提示添加 agentation-mcp；仅 Claude Code 可安装包后运行 agentation-mcp init。配置后需重启编码代理，批注即可自动同步。可用 agentation-mcp doctor 验证安装。
适用场景：Next.js 项目的开发阶段可视化批注与 AI 代理协作。
限制：需要 React 18；NODE_ENV 检查确保仅在开发环境加载；MCP 服务器默认端口为 4747。其他功能、收费与平台信息暂未提供。