KanseiLink MCP Server 是一个本地优先的 MCP 导航器，用于减少 AI 智能体在 SaaS 集成研究中的 token 浪费。官方将其定位为通过集体智能降低 token 消耗的工具。
用途 AI 智能体常在三个方面消耗 token：查找本可本地查询的 SaaS 文档、重试其他智能体已解决的错误、重复读取已处理过的上下文。KanseiLink 主要解决前两项，并对三项进行测量，让用户了解 token 去向。官方给出的实测节省为：在 7 项服务的 SaaS 集成研究上节省 89–97%（平均约 16,800 token 降至约 950）。
主要能力
- 测量：自动安装的钩子跟踪每次会话，统计总 token、缓存拆分、错误循环、卡住时间，数据不离开本机。
- 减少：SaaS 查询可消除 API 集成中的试错；错误解决智能（即将推出）用于防止社区内重复失败。
- 比较：可选的月度 Wrapped 报告展示 token 去向及在已测量用户中的排名。
- SaaS 集成智能：核心原因是智能体每次都要搜索文档、猜测认证流程并从错误中恢复。KanseiLink 提供本地 SQLite 数据库，让智能体首次尝试即可获得答案。所有数据随 npm 包以本地 SQLite 数据库形式分发，无需 API 调用、无服务器依赖、无需注册。
- 工具整合：v1.0 将工具面从 25 个独立工具整合为 5 个统一工具，并支持模式自动检测。标准流程 3 个工具，管理工具 2 个。
- 分类：覆盖 23 个类别，包括 CRM、项目管理、通信、会计、HR、电商、法律、营销、群件、生产力、存储、支持、支付、物流、预订、数据集成、BI/分析、安全、开发者工具、AI/ML、数据库、设计、DevOps。
使用方式 支持 Claude Code、Cursor、Cline、Zed、Windsurf 等任意 MCP 客户端。可添加到配置文件（如 claude_desktop_config.json、.cursor/mcp.json 等），或使用 Claude Code CLI 添加。
Claude Code 技能安装：仅安装 MCP 不会让 Claude Code 知道何时调用 KanseiLink，需安装随附技能。该命令将 SKILL.md 复制到 ~/.claude/skills/kansei-link/，Claude Code 会自动发现，并在“connect to Stripe”“Slack MCPある？”“send invoice via freee”等短语触发时调用技能，无需明确说“use KanseiLink”。
测量钩子安装：一条命令、幂等、先备份设置。添加 Stop / SessionEnd 钩子，解析每次会话记录并将 token 总量与 KanseiLink 调用统计写入 ~/.kansei-link/usage/，不上传任何内容。可随时查看报告。报告区分实测数字（来自用户自身记录的总 token、KanseiLink 调用次数与响应大小）与估算数字（基于 2026-04-16 freee/kintone/smarthr 基准的避免网络研究成本），每个界面均有标注。报告还显示智能体卡住的位置：失败的工具调用、重试链（同一工具连续 2 次以上失败）、卡住时消耗的 token、失败最多的工具。--share 仅提交标量月度聚合（匿名 id + token 计数，绝不包含内容），并返回在已测量用户中的排名（“top X% saver”）。当月已测量用户少于 20 时，返回队列规模而非排名。可随时禁用测量：export KANSEI_USAGE_HOOK=off，或 kansei-link-install-hooks --remove。
可选 PostToolUse 钩子：在每次 MCP 调用后自动捕获成功/失败（智能体常忘记报告）。
同意机制（v1.2，破坏性变更）：仅安装钩子不再传输任何内容。所有中心传输由一个同意门（~/.kansei-link/consent.json）管理，优先级为：DO_NOT_TRACK=1 / 显式 OFF → 显式 ON（KANSEI_REPORT_HOOK=on）→ Live Updates 同意（npx -y -p @kansei-link/mcp-server kansei-link-live-updates --enable）→ 默认 OFF（本地模式，零传输）。现有钩子用户在重新同意前为 OFF。管理命令：kansei-link-live-updates --status|--enable|--disable，kansei-link-privacy --status|--reset-id。
启用时钩子发送的内容：每次 MCP 工具调用后向 KanseiLink 托管端点发送一个小型假名事件。载荷为固定 7 字段集，由快照测试（scripts/smoke-hook-payload.mjs）冻结：发送服务 slug（或 MCP 服务器名）、成功/失败、工具名、错误类别（如 auth_error）、固定上下文字符串；绝不发送提示词、工具输入/输出、页面/客户/记录名称、API 密钥、文件路径、任何自由文本。不附带账户或机器标识符。安装钩子不等于选择加入——传输需要上述同意门（Live Updates 同意或显式 KANSEI_REPORT_HOOK=on）。可随时禁用：kansei-link-live-updates --disable 或 export KANSEI_REPORT_HOOK=off。
示例工作流：查找并集成服务；多服务工作流；分享真实意见。
面向 SaaS 公司 KanseiLink 同时作为 Agent Readiness Index（ARI）评估平台。真实智能体使用真实 API 产生客观遥测——成功率、延迟、错误模式与解决路径——这是任何调查或基准无法复制的。可展示：你的 API 随时间变化的智能体成功率、错误模式及智能体如何绕过、Agent Voice（智能体为何选择或避开你的服务）、与竞争对手的类别排名、API 变更影响（前后分析）。这些数据来自同一个为个人开发者节省 token 的 MCP——帮助智能体的集体智能与评估服务的信号相同。
隐私与数据处理 默认隐私保护：本地优先，完整服务数据库随 npm 包分发，无需 API 调用；测量保持本地，用量钩子写入本机 ~/.kansei-link/usage/，除非用 --share 选择加入（仅发送标量聚合 token 计数，绝不发送内容），否则不上传；PII 自动脱敏，每次报告调用在存储前清除邮箱、电话号码、IP 地址和日文姓名；智能体身份匿名化，仅保留智能体类型（claude / gpt / gemini），绝不保留用户 ID；默认无遥测，本地 stdio 服务器不向外通信。详见 SECURITY.md。
故障排除 验证技能已安装：ls ~/.claude/skills/kansei-link/SKILL.md，若缺失运行 npx -y -p @kansei-link/mcp-server kansei-link-install-skill；重启 Claude Code，技能在会话启动时索引；检查 MCP 是否以 kansei-link 名称注册：claude mcp add -s user kansei-link -- npx -y @kansei-link/mcp-server；尝试类别过滤：search_services({ intent: "...", category: "accounting" })；尝试英文等价词——大多数条目双语索引，但部分仅英文；若服务确实不存在，提交反馈：report({ subject: "Missing: ServiceX", body: "..." })；从 lookup({ service_id: "..." }) 开始——返回已知 OAuth 陷阱和刷新令牌变通方法；报告失败：report({ service_id: "...", success: false, error_type: "auth_error", workaround: "..." })——你的修复帮助下一个智能体。
其他信息 欢迎 PR。若发现缺失或信息错误的服务，最快路径是提交 PR。MCP Registry：io.github.kansei-link/kansei-mcp-server。许可证 MIT — Synapse Arrows PTE. LTD.。
