在「设置 → API 与 MCP」把 Citadex 连接到 Claude、ChatGPT、Cursor 等 AI 助手：登录授权连接、权限与每月积分上限、高级密钥、可以读取的数据和可以执行的操作、提示词库，以及常见问题。

这是什么

MCP 是让 AI 助手调用外部工具的标准。连接后，你可以在自己常用的 Claude、ChatGPT、Cursor、Claude Code 里，直接用自然语言询问 Citadex 里的数据，例如"这周我的 AI 可见度怎么样""哪些提示词竞品被提到了而我没有"。授权时可以选择只读，或允许它帮你重新检测、添加提示词、生成文章草稿，扣积分前它都会先问你。

这项功能在专业版及以上可用。免费版打开页面会看到「专业版及以上可用」和「升级到专业版」。

页面在哪里

点左下角用户菜单 →「设置」→「API 与 MCP」。页面从上到下是：

连接地址：所有 AI 助手都用这个地址，旁边有「复制」。
已连接的应用：通过登录授权连上的 AI 助手，以及它们的权限和本月积分。
连接到你的 AI 助手：Claude、ChatGPT、Cursor、「Claude Code 与其他」四个标签，各有步骤。
不知道问什么？从提示词库开始：精选的现成提示词。
密钥（高级）：给不支持登录授权的工具用。

设置 → API 与 MCP：连接地址、已连接的应用、连接步骤

设置 → API 与 MCP：连接地址、已连接的应用、连接步骤

方式一：登录授权（推荐，用于 Claude 和 ChatGPT）

不需要密钥。在 AI 助手里添加连接器，会跳转到 Citadex 登录并选择权限。

管理已连接的应用

「已连接的应用」表格列出每个应用的「权限」「访问范围」「本月积分」（显示「已用 / 上限」的积分，只读的显示「不扣积分」）和「最近使用」。

修改权限：在只读和「只读 + 操作」之间切换，修改「每月积分上限」，点「保存」。
断开：应用立刻失去访问。

方式二：密钥（高级，用于 Cursor、Claude Code 和脚本）

展开「密钥（高级）」→「生成密钥」，填「名称」（写上用在哪个工具），选「访问范围」（「全部项目」或「选定的项目」），点「生成」。

完整密钥只显示这一次，请马上复制，然后点「我已保存」。
同时会给出「私人连接地址」，它本身就包含密钥，请像密码一样保管。
Cursor：打开 Settings → MCP → Add new MCP server，把页面给出的配置粘贴到 mcp.json，替换成你的密钥。其他支持远程 MCP 的工具：用连接地址，并在请求头加 Authorization: Bearer 你的密钥。
密钥和私人连接地址只能读，不能执行操作。
每个工具用一个单独的密钥；不用了就点「作废」。

代理常用：为某个客户的汇报单独生成一个只能看这个客户项目的密钥。

能读到什么、能做什么

连接后，AI 助手可以调用下面这些工具（括号里是工具名，在 Claude、ChatGPT 的调用记录里会看到）：

分组	能读到的内容	工具名
项目与市场	项目列表、各市场和引擎	list_projects、list_markets
可见度	各引擎可见度总览、趋势、情感分析	get_visibility_overview、get_visibility_trend、get_sentiment
提示词	提示词列表、单条提示词的证据、提示词覆盖	list_prompts、get_prompt_evidence、get_prompt_coverage
竞品与推荐	竞品与声量、从提及到推荐	get_competitors、get_recommendation_share
引用来源	引用来源、缺口与机会、可争取的引用页面	get_citation_sources、get_citation_gaps、find_citation_opportunities
诊断与任务	本周任务、可见度下降排查、品牌词完整性、市场修复计划	get_opportunities、investigate_visibility_drop、check_brand_integrity、get_repair_plan
流量与收入	收入归因、智能体就绪度	get_ai_revenue、get_agent_readiness
内容与积分	文章列表与正文、积分余额	list_articles、get_article、get_credit_balance

选了「只读 + 操作」的连接，还能执行三个操作：

操作	工具名	是否扣积分
重新检测提示词	start_scan	扣积分
添加提示词到追踪	add_prompts	添加本身不扣积分，但余额要够这些提示词的第一次检测，不够时一条也不会添加；添加后不会立即检测
生成文章草稿	generate_article	按积分计费，进入待审核，不会自动发布

扣积分的操作：先报价，再确认

你让 AI 助手做一件扣积分的事时，它先拿到一份报价：要做什么、需要多少积分、当前余额、这个连接本月还剩多少额度。
AI 助手把报价告诉你，等你明确同意。
你同意后它才会真正执行。

超过这个连接的「每月积分上限」时，操作不会执行，可以在「修改权限」里调高上限。发布文章和删除数据永远不在允许范围内，只能在 Citadex 里操作。工作区的查看者即使连接了也不能执行操作。

提示词库

不知道问什么，就打开「MCP 提示词库」（设置页里的「打开提示词库」，或直接访问网站上的 /mcp/prompts，不需要登录）。里面有 35 个写好的提示词，分为简报与报告、竞品分析、引用来源、内容规划、代理与客户汇报五类，每个都标出会用到哪些数据。点「复制提示词」，粘贴到已连接的 AI 助手里，把方括号里的内容换成你自己的。设置页也会直接列出几个精选提示词。

连上后可以先试这几个问题："这周我的品牌 AI 可见度怎么样？""哪些提示词竞品被提到了而我们没有？""我所在市场 AI 最常引用哪些来源？""给日本市场写一份修复计划。"

不确定怎么连接，也可以在 Citadex 里打开 AI 助手，点顶部「在 ChatGPT / Claude 里用 Citadex」，它会一步步带你做。

常见问题

团队成员连接后能看到什么？ 按他在工作区的角色访问，看到的是工作区所有者的项目。

代理商的客户能用吗？ 只有代理商在白标设置里为客户打开「API 与 MCP」时可以，并且只能看到分配给他的项目。

为什么 ChatGPT 里看不到 Citadex？ 确认已开启开发者模式、身份验证选了 OAuth，并在新对话里从工具菜单选择 Citadex。ChatGPT 需要付费账户。

授权后想换成只读怎么办？ 在「已连接的应用」点「修改权限」，选「只读」后保存，立即生效。

在 ChatGPT / Claude 中使用 Citadex（API 与 MCP）