KanseiLink

KanseiLink MCP 服务

借助集体智慧，减少 AI Agent 的 Token 浪费。

你的 Agent 会在三件事上浪费 Token：搜索本可在本地查询的 SaaS 文档、重试其他 Agent 已解决的错误，以及重新阅读已处理过的上下文。KanseiLink 解决前两项，并衡量这三项，让你准确了解 Token 用在了哪里。

实测节省：SaaS 集成调研可节省 89–97%（在 7 项服务中，平均约从 16,800 个 Token 降至 950 个）。

工作原理

Install MCP → agent wastes fewer tokens (lookup + collective intelligence)
                    ↓
            usage data stays local (opt-in: anonymous scalars only)
                    ↓
            collective intelligence grows → everyone's agent gets smarter

1. 衡量 — 自动安装的钩子会跟踪每次会话：Token 总数、缓存占比、错误循环、卡住时长。任何数据都不会离开你的设备。
2. 减少 — SaaS 查询可避免 API 集成中的反复试错。错误解决情报（即将推出）将帮助社区避免重复失败。
3. 对比 — 可选择加入的月度“Wrapped”报告会展示 Token 的去向，以及你在参与测量的用户中的排名。

如果 KanseiLink 为你的 Agent 节省了 Token，请点个星 ⭐ — 每月有 700 多名开发者从 npm 安装它，而星标能帮助更多人发现它。

快速开始

通过 URL 添加 — 使用托管服务，始终获取最新数据。无需密钥，也无需注册。

claude mcp add --transport http kansei-link https://mcp.kansei-link.com/mcp

Cursor、Windsurf、Cline、Zed — 任何支持 URL 的客户端（例如 .cursor/mcp.json）：

{
  "mcpServers": {
    "kansei-link": { "url": "https://mcp.kansei-link.com/mcp" }
  }
}

Claude Desktop：设置 → 连接器 → 添加自定义连接器 → https://mcp.kansei-link.com/mcp。

托管服务会为每次调用保留一行统计信息——工具名称、服务 ID、结果——绝不会记录你的文本。完整列表请参见 SECURITY.md → 服务端可见内容。

离线使用，或完全不发送网络请求 — npm 包会在本地运行，使用精简的公开目录副本（每项服务一张卡片、操作指南、API 指南），不会发送任何内容：

claude mcp add -s user kansei-link -- npx -y @kansei-link/mcp-server

{
  "mcpServers": {
    "kansei-link": {
      "command": "npx",
      "args": ["-y", "@kansei-link/mcp-server"]
    }
  }
}

适用于 Claude Code、Claude Desktop、Cursor、Cline、Zed、Windsurf — 任何 MCP 客户端。

Wrapped：每月 Agent 燃效报告

KanseiLink 会在你的设备上本地衡量 Agent 会话消耗的 Token 数量，以及 KanseiLink 为你节省的 Token 数量，然后生成每月“Wrapped”分享卡片。

1. 安装测量钩子（只需一条命令，可重复运行，会先备份你的设置）：

npx -y -p @kansei-link/mcp-server kansei-link-install-hooks

这会添加一个 Stop/SessionEnd 钩子，用于解析每个会话记录，并将 Token 总数及 KanseiLink 调用统计信息写入 ~/.kansei-link/usage/。不会上传任何内容。

2. 随时查看报告：

npx -y -p @kansei-link/mcp-server kansei-link-wrapped            # current month (JA)
npx -y -p @kansei-link/mcp-server kansei-link-wrapped --lang en  # English
npx -y -p @kansei-link/mcp-server kansei-link-wrapped --share    # opt-in: get your rank

报告会区分实测数据（你的 Token 总数、KanseiLink 调用次数及响应大小，均从你自己的会话记录中解析得出）和估算数据（基于 2026-04-16 freee/kintone/smarthr 基准测试的避免网页调研成本）——所有展示界面都会标明数据类型。

报告还会显示 Agent 卡住的情况：失败的工具调用、重试链（同一工具连续失败 2 次或以上）、卡住期间消耗的 Token，以及失败次数最多的工具。

--share 只会提交月度汇总数值（匿名 ID + Token 数量，绝不包含内容），并显示你在参与测量的用户中的排名（“节省者中排名前 X%”）。当月参与测量的用户少于 20 人时，系统会显示群组人数而不是排名。

你可以随时关闭测量：export KANSEI_USAGE_HOOK=off，或运行 kansei-link-install-hooks --remove。

SaaS 集成智能

Agent 在使用 SaaS API 时浪费令牌的核心原因：它们每次都要搜索文档、猜测身份验证流程，并从错误中恢复。KanseiLink 提供本地 SQLite 数据库，该数据库基于其目录的公开副本构建，让你的 Agent 首次尝试就能获得答案；完整信息（评分、探测结果、历史记录）则存放在托管服务和网站上。

	数量	说明
服务	11,293	涵盖 49 个类别的 MCP 服务和 SaaS API（截至 2026-06-09，有 2,257 个端点通过了我们的 MCP 握手探测）
配方	200	多服务工作流组合（站会、PR 审查、事件响应、入职培训……）
API 指南	199	身份验证设置、端点、速率限制、注意事项和解决方法
信任评分	每周	根据自动化健康探测和真实 Agent 使用数据得出

npm 包包含数据的公开副本（每项服务一张卡片、配方、API 指南，以及最近 90 天的变更日志——自 1.3.0 起），并据此构建本地 SQLite 数据库。搜索或查询服务无需 API 调用，无需依赖服务，也无需注册。副本中不包含的内容——内部评分、探测结果、Agent 反馈、原始注册表转储——保留在托管服务上；查询无结果时，工具会引导你访问 https://kansei-link.com/services/<id>/ 并使用 ask。

不使用与使用 KanseiLink

不使用 KanseiLink	使用 KanseiLink
web_search "freee API auth"	search_services({ intent: "send invoice" })
web_fetch 文档首页（SPA，主要是导航内容）	lookup({ service_id: "freee" })
web_fetch 端点参考文档	Agent 仅用 约 950 个令牌
web_fetch 身份验证指南	即可获得身份验证流程、注意事项和解决方法
为错误参数反复试错	首次尝试即成功
浪费约 16,800 个令牌	节省 89–97%

Claude Code：安装技能（自动调用）

仅安装 MCP 并不会教会 Claude Code 何时调用 KanseiLink。捆绑的技能可以解决这个问题：

npx -y -p @kansei-link/mcp-server kansei-link-install-skill

这会将 SKILL.md 复制到 ~/.claude/skills/kansei-link/。Claude Code 会自动发现该技能，并在出现“连接到 Stripe”“有 Slack MCP 吗？”“通过 freee 发送发票”等说法时调用它——无需说“使用 KanseiLink”。

可选：PostToolUse 挂钩

在每次 MCP 调用后自动捕获成功或失败情况（Agent 往往会忘记报告）。

同意（v1.2，重大变更）。 单独安装挂钩不再传输任何内容。所有集中式传输均受同一个同意开关控制 （~/.kansei-link/consent.json），优先级如下： DO_NOT_TRACK=1 / 明确关闭 → 明确开启（KANSEI_REPORT_HOOK=on）→ Live Updates 同意（npx -y -p @kansei-link/mcp-server kansei-link-live-updates --enable）→ 默认关闭（本地模式，不进行任何传输）。现有挂钩用户在重新同意前均处于关闭状态。管理方式：kansei-link-live-updates --status|--enable|--disable、 kansei-link-privacy --status|--reset-id。

启用后挂钩会发送的内容，以及绝不会发送的内容。 每次 MCP 工具调用后，向 KanseiLink 托管端点发送一条小型化名事件。负载包含固定的 7 个字段，并由快照测试锁定（scripts/smoke-hook-payload.mjs）：

• 发送：服务标识名（或 MCP 服务名称）、成功/失败状态、工具名称、 错误类别（例如 auth_error）、固定上下文字符串
• 绝不发送：提示词、工具输入/输出、页面/客户/记录名称、 API 密钥、文件路径、任何类型的自由文本。不会附带账户或设备标识符。

安装挂钩并不代表你已选择加入——传输需要通过上述同意开关（Live Updates 同意，或明确设置 KANSEI_REPORT_HOOK=on）。可随时禁用：kansei-link-live-updates --disable 或 export KANSEI_REPORT_HOOK=off。

添加到 ~/.claude/settings.json：

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "mcp__.*",
      "hooks": [{ "type": "command", "command": "npx -y -p @kansei-link/mcp-server kansei-link-report-hook" }]
    }]
  }
}

可随时禁用：export KANSEI_REPORT_HOOK=off

工具（5 个）

v1.0 将工具集从 25 个独立工具整合为 5 个统一工具，并自动检测模式。

标准流程（3 个工具——满足所有需求）

search_services --> lookup --> (execute your API call) --> report

工具	模式	描述
search_services	--	按意图查找服务（FTS5 + trigram + 类别加权）
lookup	8 种模式	获取提示、详情、洞察、方案、组合、历史记录、反馈和声音
report	4 种模式	报告结果、提交反馈、记录事件、分享你的声音

管理工具（另外 2 个）

工具	模式	描述
inspect	8 种模式	Colony 健康状况：检查队列、异常验证、更新提案、快照
analyze	4 种模式	分析：令牌节省量、成本审计、AEO 报告和文章

Lookup 模式

模式	触发条件	示例
tips（默认）	仅提供 service_id	lookup({ service_id: "freee" })
detail	detail: true	lookup({ service_id: "freee", detail: true })
insights	insights: true	lookup({ service_id: "freee", insights: true })
recipe	goal	lookup({ goal: "onboard employee" })
combinations	service（模糊名称）	lookup({ service: "freee" })
history	period	lookup({ service_id: "freee", period: "30d" })
feedback	feedback_status	lookup({ feedback_status: "open" })
voices	mode: "voices"	lookup({ mode: "voices", service_id: "freee" })

Report 模式

模式	触发条件	示例
outcome	success（布尔值）	report({ service_id: "freee", success: true })
feedback	subject + body	report({ subject: "...", body: "..." })
event	event_type	report({ event_type: "api_change", event_date: "2025-01-15", title: "..." })
voice	question_id	report({ question_id: "best_feature", response_text: "...", service_id: "freee" })

示例工作流

查找并集成服务：

search_services({ intent: "send invoice to clients", compact: true })
--> lookup({ service_id: "freee" })        // tips: auth, pitfalls, workarounds
--> lookup({ service_id: "freee", detail: true })  // full connection guide
--> (execute your API call)
--> report({ service_id: "freee", success: true, task_type: "create_invoice" })

多服务工作流：

lookup({ goal: "create invoice and notify via slack", services: ["freee", "slack"] })
--> Step-by-step recipe with coverage scoring

分享你的真实看法：

report({
  service_id: "stripe",
  question_id: "biggest_frustration",
  response_text: "Webhook signature verification docs are unclear for non-Node runtimes"
})

类别（23）

CRM、项目管理、通信、会计、人力资源、电子商务、法律、营销、群件、效率、存储、支持、支付、物流、预约、数据集成、BI/分析、安全、开发者工具、AI/ML、数据库、设计、DevOps

架构

Agent <-> KanseiLink MCP Server <-> SQLite (local, zero-config)
              |
              +-- search_services  -> FTS5 + trigram (CJK) + LIKE + category detection
              +-- lookup           -> tips / detail / insights / recipe / combinations /
              |                       history / feedback / voices (auto-detected)
              +-- report           -> outcome / feedback / event / voice (auto-detected)
              +-- inspect          -> queue / submit / propose / review / snapshot / evaluate
              +-- analyze          -> token_savings / cost / aeo_report / aeo_article

面向 SaaS 公司

KanseiLink 同时也是一个 Agent Readiness Index（ARI） 评估平台。使用真实 API 的真实 Agent 会生成客观遥测数据——成功率、延迟、错误模式和解决路径——这些数据无法通过调查或基准测试复制。

我们可以向你展示：

• 你的 API 的 Agent 成功率随时间的变化
• 错误模式以及 Agent 如何应对这些问题
• Agent Voice：Agent 选择（或避开）你的服务的原因
• 与竞争对手相比的类别排名
• API 变更的影响（变更前后分析）

这些数据来自同一个 MCP，它能为个体开发者节省令牌——帮助 Agent 的集体智慧，也是评估服务的依据。

请访问 kansei-link.com 或联系我们。

隐私与数据处理

KanseiLink 默认保护隐私：

• 本地优先：目录的公开副本随 npm 软件包一同发布（自 1.3.0 起；此前包含完整种子数据）。搜索／查询无需调用 API。
• 测量数据保留在本地：使用情况钩子会将数据写入你计算机上的 ~/.kansei-link/usage/。除非你选择使用 --share 分享，否则不会上传任何内容；分享时仅发送标量汇总数据（令牌数量），绝不发送内容。
• 自动屏蔽个人身份信息：每次 report 调用都会在存储前清除电子邮件、电话号码、IP 地址和日文姓名。
• Agent 身份已匿名化：仅保留 Agent 类型（claude / gpt / gemini），绝不保留用户 ID。
• 默认不收集遥测数据：本地 stdio 服务不会向外发送数据。

完整详情请参阅 SECURITY.md。

故障排除

技能未触发——我询问 SaaS 时，Claude Code 没有调用 KanseiLink。

1. 确认技能已安装：

   ls ~/.claude/skills/kansei-link/SKILL.md
   

   如果未安装，请运行 npx -y -p @kansei-link/mcp-server kansei-link-install-skill。
2. 重启 Claude Code。技能会在会话启动时建立索引。
3. 检查 MCP 是否以 kansei-link 为名称注册：

   claude mcp add --transport http kansei-link https://mcp.kansei-link.com/mcp
   

   （或者，离线副本可使用上面的 npx 形式）

对于我知道存在的服务，search_services 没有返回任何结果。

1. 尝试使用类别筛选：search_services({ intent: "...", category: "accounting" })。
2. 尝试使用对应的英文词语——大多数条目都建立了双语索引，但有些只有英文索引。
3. 如果确实没有该服务，请提交反馈：report({ subject: "Missing: ServiceX", body: "..." })。

KanseiLink 提供建议后，调用 SaaS 端点时出现身份验证错误。

1. 先使用 lookup({ service_id: "..." })——它会返回已知的 OAuth 问题和刷新令牌的解决方法。
2. 报告故障：report({ service_id: "...", success: false, error_type: "auth_error", workaround: "..." })——你的解决方法可以帮助下一个 Agent。

贡献

git clone https://github.com/kansei-link/kansei-mcp-server.git
cd kansei-mcp-server
npm install
npm run build
npm start       # start stdio server

欢迎提交 PR。如果你发现某项服务缺失或信息有误，最快的处理方式是：

report({ subject: "Fix: ServiceX auth is OAuth2 not API key", body: "..." })

链接

• npm
• 网站
• MCP Registry：io.github.kansei-link/kansei-mcp-server
• Glama

许可证

MIT — Synapse Arrows PTE. LTD.