Claude · 自定义连接器

把 KOLens 接入 Claude

把一个网址粘贴到 Claude.ai 的自定义连接器对话框,点一次同意,Claude 就能用自然语言帮你搜索达人、拉取受众画像、监测广告、管理关注列表与提醒。底层使用 MCP + 带 PKCE 的 OAuth 2.1,你的凭证始终保留在 kolens.ai。

https://kolens.ai/mcp

复制粘贴到 Claude 的就是这个网址。

30 秒完成接入

  1. 1

    打开 Claude.ai,进入 设置 → Connectors

    Claude Pro、Team 与 Enterprise 套餐均可使用。在连接器列表底部找到 添加自定义连接器

  2. 2

    粘贴 https://kolens.ai/mcp,点击 连接

    Claude 会自动发现我们的 OAuth 端点(RFC 9728/8414)并以公开客户端身份动态注册自己(RFC 7591)。你不需要自己创建 API Key,也不用处理任何 Secret。

  3. 3

    在授权页面登录你的 KOLens 账号。

    你会被跳转到 https://kolens.ai/oauth/authorize。还没有账号?先注册一个

  4. 4

    确认所请求的权限范围,点击 同意

    授权页会逐项列出 Claude 申请的权限 —— 通常是 read:kolswrite:listsrun:scrape。你可以随时在 账户 → 连接 中撤销其中任何一项。

  5. 5

    完成 —— 试着提一个问题。

    打开任意一段 Claude 对话,试试这些指令:

    • “帮我搜美国地区粉丝量超过 5 万的手机壳类 KOL。”
    • “给我看 @creatorbeta 的受众画像。”
    • “把 @creatoralpha 加入我的 A-list 关注列表。”
    • “把我所有 rising_kol 类型的提醒标记为已读。”

15 个工具,即装即用

达人发现

  • list_kols按关键词、粉丝量、互动率与地区筛选 KOL。
  • get_kol_profile完整的达人档案 + 最近视频 + 联系方式。
  • search_history你(或你的团队)最近搜过什么。
  • run_scrape发起一次新的关键词抓取任务。

受众与增长

  • get_audience_snapshot国家构成、语言、活跃度、Top 垂类,附 95% 置信区间。
  • list_alertsKOLens 为你识别出的崛起达人与爆款视频。
  • mark_alert_read直接在对话里把提醒标记为已读。

广告监测

  • list_advertisers当前在某垂类投放 Facebook 广告的品牌。
  • get_ad_detail拉取单条广告的完整数据 —— 文案、创意、投放区间。
  • list_watches你保存的自动运行广告监测。

名单与关注

  • add_to_list把一位 KOL 保存到指定名单,稍后批量导出。
  • add_to_watchlist持续追踪一位 KOL 的成长曲线。
  • list_lists你的所有 KOL 名单。
  • list_watchlist你关注的 KOL 及数据变化。
  • remove_from_watchlist停止追踪某位 KOL。

安全机制

  • OAuth 2.1 + PKCE。你的密码永远不会离开 kolens.ai。Claude 拿到的是一枚不透明、可撤销的访问令牌。
  • 细粒度权限。每个工具都对应一项你明确同意过的权限。授权页会逐项展示 —— 不存在隐式访问。
  • 逐应用撤销。访问 /account/connections 即可看到所有已连接的客户端,一键撤销任意令牌(RFC 7009)。
  • 无需保管长期密钥。令牌会自动过期与续签。自定义连接器的网址即便在团队内共享也是安全的。

常见问题排查

在 Claude.ai 里看不到 “添加自定义连接器”。

自定义连接器需要付费 Claude 套餐(Pro、Team 或 Enterprise)。免费版会隐藏该选项。可前往 claude.ai/upgrade 升级。

授权页提示 “Invalid client”。

Claude 每次添加连接器时都会注册一个全新的客户端。如果你之前的注册中途被打断(例如关闭了页面),请先在 Claude.ai → 设置 → Connectors 中删除那条未完成的连接器,然后重新添加。每次注册仅一次性有效。

连接完成后,Claude 仍然找不到 KOLens 的工具。

刷新当前对话,或新开一段对话 —— Claude 只在对话开始时刷新工具列表。如果仍未出现,可前往 /account/connections 检查连接是否处于活跃状态。

网址 https://kolens.ai/mcp 在浏览器里直接访问会 404。

属于预期表现。 /mcp 仅响应携带 JSON-RPC 包体的 POST 请求 —— 浏览器里没有任何内容可渲染。Claude 会在后台 POST 它。要确认服务存活,可在新标签页打开 https://kolens.ai/.well-known/oauth-authorization-server ,你应当能看到一份 JSON 文档。

已经连接过了?

可在 账户 → 连接 中管理或撤销已连接的 Claude 客户端。

把 KOLens 接入 Claude(MCP + OAuth)— 自定义连接器 | KOLens