用途：为 Next.js 项目添加 Agentation 可视化反馈工具栏，并在需要时把浏览器中的标注反馈连接到用户自己的编码智能体。
主要能力：提供可见的反馈工具栏；支持通过 MCP 与智能体实时同步反馈；也支持仅手动复制粘贴、不需要运行服务器的模式。默认本地服务器地址为 http://localhost:4747，可保留项目已有的自定义端口或代理 URL。
使用方式：先阅读项目说明并识别包管理器，检查是否已有 agentation 与 <Agentation> 挂载，避免重复挂载。缺失时用现有 lockfile 对应的包管理器安装。Next.js App Router 在根布局的 body 中、children 之后渲染；Pages Router 在 pages/_app 中 Component 之后渲染，并保留已有回调与选项。示例：import { Agentation } from "agentation"; 再以 {process.env.NODE_ENV === "development" && (<Agentation endpoint="http://localhost:4747" />)} 使用。MCP 模式需配置智能体，启动命令须含子命令 npx -y agentation-mcp server；也可用 npx add-mcp "npx -y agentation-mcp server"，Claude Code 可用 claude mcp add agentation -- npx -y agentation-mcp server 或初始化向导。自定义端口需同时应用到服务命令与组件 endpoint。可用 npx agentation-mcp doctor 做诊断，自定义 URL 时用 doctor --http-url <url>。
适用场景：需要在开发阶段从浏览器页面收集可视化反馈并交给编码智能体的 Next.js 项目。
限制：需 React 18 或更高版本；开发守卫避免工具栏出现在生产环境；安装工具栏本身不会安装、配置或连接 MCP 服务器；远程项目不应假设浏览器与智能体在同一台机器；若模式不明确应先询问；浏览器或 MCP 工具不可用时应说明哪部分未经验证，不能声称实时同步可用。验证需实际创建一条标注并核对具体评论与页面。