把 KOLens 接进 Claude：MCP + OAuth 2.1 自定义连接器配置教程

为什么 MCP 改变了集成的玩法

此前要在 AI 里用 KOLens，只有两条路：要么在 Claude Desktop 里装一个 stdio MCP 插件（能用，但单机单用户），要么把 API key 粘进 Continue 的配置文件（能用，但每次 prompt 都得提醒它调 哪个 API）。

自定义连接器把这两条路压成了网络协议。KOLens 在一个 URL 上 发布它的工具面；Claude.ai（或任意 MCP 客户端）自动发现；用户 通过 OAuth 一次登录，连接就常驻。从用户角度看就是「我给 Claude 加了一样东西」——和给 Slack 接一个集成的体验完全一样。

60 秒接入

1. 1

   在 Claude.ai → Settings → Connectors → Add custom connector。

   （不同 Claude 客户端路径可能略有差别；在任意 Connectors / MCP 设置面板里找「Custom connector」。）
2. 2

   粘 https://kolens.ai/mcp 然后点 Connect。

   Claude 会拉我们的发现文档 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource，识别到 我们走 OAuth 2.1，并通过 POST /oauth/register（RFC 7591 动态客户端注册） 自行登记。
3. 3

   跳到 KOLens 的同意页。

   页面会展示 Claude 申请了哪些 scope——默认请求里是 read:kols + write:lists——并列出 每个 scope 解锁的工具。点 Approve。
4. 4

   Claude 拿到一个 1 小时 access token + 可刷新的 refresh token。

   回到 Claude，连接已生效。Access token 每小时过期；Claude 用 refresh token 自动轮换，不会再来打扰你。

连上之后 Claude 能做什么

3 个 scope，13 个工具：

read:kols——研究

• list_kols——查 KOL 数据库（按关键词、角色、粉丝量等过滤）
• get_kol_profile——拿单个 TikTok handle 的完整 KOLens profile
• list_recent_jobs + get_job_status——你最近的抓取任务
• list_discovery_plans——你已排班的关键词抓取
• list_alerts——最近增长预警（rising_kol、trending_video、audience_drift）
• get_audience_snapshot——最新一份抽样粉丝快照
• list_kol_lists + get_list_members——你已整理的线索名单
• list_watchlist——你正在监控的 KOL

write:lists——小变更

• add_to_watchlist / remove_from_watchlist——管理监控
• mark_alert_read——清理通知

run:scrape——付费动作（默认不申请）

专门保留给会扣 credits 的工具（发起一次新关键词抓取、跑一次 handle 查询、生成新的 Audience Snapshot）。Claude 在默认同意 请求里不申请这个 scope——你必须在以后重新授权时显式给出—— 所以一条随手的 prompt 不可能不小心烧掉 $20。

安全模型

• 强制 PKCE——public client 没法跳过 verifier 交换。只接受 code_challenge_method=S256；不允许 RFC 7636 那个 plain 兜底。
• 不透明 token，不是 JWT——撤销便宜（一行 flag），不会把 claim 泄露给抓包的人。kolens_at_… 前缀让 token 在日志里不解码也能识别。
• 静态存储 hash——只有 SHA-256 hash 进 DB。单靠数据库泄露没法被重放打到 API。
• auth code 一次性——重放会写一个 used_at 标记，code 当场作废。
• 按用户撤销——在 /account/connections Disconnect，会批量作废该 (user, client) 对的所有活 token。从 refresh → 配对 access token 级联，体验上是原子的。

几句好用的 prompt

• 「帮我找 5 个 phonecase TikTok 达人，有邮箱、至少 5 万粉。」→ Claude 用合适的筛选条件调 list_kols。
• 「@minicaseco 的受众国家分布是什么？」→ get_audience_snapshot 返回最新快照，或 { snapshot: null } 时 Claude 会建议你跑一次。
• 「把关于 @uglycaseguy 的 rising_kol 预警都标已读。」→ list + filter + 批量 mark_alert_read。

接下来要做的

长任务的流式响应、基于 Supabase cookie 的同意（同意页不再 要求 API key）、每工具预算上限、refresh token 轮换。今天都 不阻塞使用；连接器端到端已经可用。