在 ChatGPT / Claude 中使用 Citadex(API 与 MCP)
在「设置 → 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:连接地址、已连接的应用、连接步骤
方式一:登录授权(推荐,用于 Claude 和 ChatGPT)
不需要密钥。在 AI 助手里添加连接器,会跳转到 Citadex 登录并选择权限。
- 1
在 Claude 里添加
在 Claude 打开 设置 → 连接器 → 添加自定义连接器,名称填 Citadex,地址粘贴上面的 连接地址,点 连接。
- 2
或在 ChatGPT 里添加
在 ChatGPT 打开 设置 → 应用与连接器 → 高级设置,开启 开发者模式;点 创建,名称填 Citadex,地址粘贴 连接地址,身份验证选 OAuth。需要 ChatGPT 付费账户。
- 3
在 Citadex 授权页选择权限
「只读(推荐)」:只查看数据,不修改任何数据,也不扣除积分。「只读 + 操作」:另外还能重新检测提示词、添加提示词、生成文章草稿。
- 4
设置积分上限和项目
选了「只读 + 操作」时,填「这个连接每月最多可消耗的积分」。在「可以访问的项目」里选「全部项目(含你所在的团队工作区)」或「选定的项目」。
- 5
点「允许访问」
回到 Claude 或 ChatGPT,在对话的工具菜单里打开 Citadex 后提问。连上后,这个应用会出现在「已连接的应用」里。
管理已连接的应用
「已连接的应用」表格列出每个应用的「权限」「访问范围」「本月积分」(显示「已用 / 上限」的积分,只读的显示「不扣除积分」)和「最近使用」。
- 修改权限:在只读和「只读 + 操作」之间切换,修改「每月积分上限」,点「保存」。
- 断开:应用立刻失去访问。
方式二:密钥(高级,用于 Cursor、Claude Code 和脚本)
展开「密钥(高级)」→「生成密钥」,填「名称」(写上用在哪个工具),选「访问范围」(「全部项目」或「选定的项目」),点「生成」。
- 完整密钥只显示这一次,请立即复制,然后点「我已保存」。
- 同时会给出「私人连接地址」,它本身就包含密钥,请像密码一样保管。
- Cursor:打开 Settings → MCP → Add new MCP server,把页面给出的配置粘贴到 mcp.json,替换成你的密钥。其他支持远程 MCP 的工具:用连接地址,并在请求头加 Authorization: Bearer 你的密钥。
- 密钥和私人连接地址只能读,不能执行操作。
- 每个工具用一个单独的密钥;不再使用时点击「作废」。
代理常用:为某个客户的汇报单独生成一个只能看这个客户项目的密钥。
能读到什么、能做什么
连接后,AI 助手可以调用下面这些工具(括号里是工具名,在 Claude、ChatGPT 的调用记录里会看到):
| 分组 | 能读到的内容 | 工具名 |
|---|---|---|
| 项目与市场 | 项目列表、各市场和引擎 | list_projects、list_markets |
| 可见度 | 各引擎可见度总览、趋势、情感分析、AI 回答里的商品卡(你和竞品各占多少) | get_visibility_overview、get_visibility_trend、get_sentiment、get_shopping_cards |
| 提示词 | 提示词列表(含每条的需求来源)、单条提示词的证据、单条提示词的需求证据(按渠道与市场,是否核实,是否来自其他市场)与需求热度(1–5 级或未知)、提示词覆盖(可只看一个市场;按问题类型、购买阶段、购买旅程、品牌分类,以及四档需求证据:有人在搜 / 搜索中出现过 / 没有搜索证据 / 品牌词;另附尚未追踪的 AI 引擎检索词,即引擎回答前自行执行的网页搜索,不代表用户需求)、每条提示词的品牌分类与购买旅程阶段(含分类是否为手动设定)、问的是同一件事的提示词分组(同一市场内比较,只作建议)、每条提示词的商业机会档位(高 / 中 / 低,含场景、置信度、主要原因、依据与适用条件) | list_prompts、get_prompt_evidence、get_prompt_sources、get_prompt_coverage、get_prompt_classification、get_similar_prompts、get_prompt_opportunity |
| 竞品与推荐 | 竞品与声量、从提及到推荐、提示词缺口(你尚未追踪、AI 推荐竞品却未提及你的问题) | get_competitors、get_recommendation_share、get_prompt_gaps |
| 引用来源 | 引用来源、缺口与机会、可争取的引用页面、竞品独占的来源、外联进度 | get_citation_sources、get_citation_gaps、find_citation_opportunities、get_competitor_only_sources、get_outreach_status |
| 诊断与任务 | 一键诊断(为什么不推荐、竞品为什么领先、广告与自然推荐、AI 收入)、本周任务、可见度下降排查、品牌词完整性、市场修复计划、修复审批、做过的事效果如何 | run_diagnosis、get_suggestion_outcomes、get_opportunities、investigate_visibility_drop、check_brand_integrity、get_repair_plan、get_fix_approvals |
| 流量与收入 | 收入归因、ChatGPT 广告、AI 流量、智能体就绪度 | get_ai_revenue、get_chatgpt_ads、get_ai_traffic、get_agent_readiness、get_industry_benchmark |
| 内容与积分 | 文章列表与正文、积分余额 | list_articles、get_article、get_credit_balance |
选了「只读 + 操作」的连接,还能执行下面这些操作:
| 操作 | 工具名 | 是否扣除积分 |
|---|---|---|
| 重新检测提示词 | start_scan | 扣除积分 |
| 添加提示词到追踪 | add_prompts | 添加本身不扣除积分,但余额要够这些提示词的第一次检测,不够时一条也不会添加;添加后不会立即检测 |
| 生成文章草稿 | generate_article | 按积分计费,进入待审核,不会自动发布 |
| 新建复测 | create_retest | 不扣除积分;选了「每个提示词测 3 遍」时,复测期间每轮扫描多扣除积分(报价里写明)。Business / Agency 套餐 |
| 批准或驳回修复 | review_fix | 不扣除积分;只有所有者、管理员或代理商的客户能批准,驳回要写原因 |
| 修改某个市场的对标竞品 | set_market_competitors | 不扣除积分 |
| 设置品牌信息校验 | setup_brand_check | 保存官方信息不扣除积分;第一次开启时会添加品牌防御提示词,要用积分 |
| 把网页导入品牌知识库 | import_kb_url | 不扣除积分 |
| 新建项目 | create_project | 不扣除积分;读取网站、生成起始提示词,不会自动检测。限定了项目范围的连接不能新建 |
| 暂停或恢复提示词 | set_prompts_active | 暂停不扣除积分,历史保留;恢复时余额要够下一次检测 |
| 删除提示词 | delete_prompts | 不扣除积分;进回收站,30 天内可恢复,扫描历史会清除。同一个提示词在多个市场时,可以只删某个市场的 |
| 修改检测频率 | set_scan_frequency | 每天 / 每周 / 每月;检测照常扣除积分 |
| 自动整理提示词分组 | organize_prompt_groups | 不扣除积分;把所有未分组的提示词按意思分组,优先用已有分组 |
| 把提示词移到某个分组 | move_prompts_to_group | 不扣除积分;分组不存在时会新建 |
| 修改提示词的品牌分类 | set_prompt_brand_class | 不扣除积分;修改后系统不再自动改动,可撤销,也可恢复自动判定;不改变问题类型 |
| 生成成果报告 | create_report | 不扣除积分;本月、上月或最近 30 天,返回分享链接。付费套餐 |
| 开关自动化 | set_automation | 开关本身不扣除积分;打开自动扫描后按提示词频率检测,报价里写明约每 30 天用多少积分 |
扣除积分的操作:先报价,再确认
- 你让 AI 助手执行扣除积分的操作时,它会先生成一份报价:要做什么、需要多少积分、当前余额、这个连接本月还剩多少额度。
- AI 助手把报价告诉你,等你明确同意。
- 你同意后它才会真正执行。
不扣除积分的操作也一样:先告诉你要做什么,你同意后才执行;报价之后如果数据变了(比如那条修复的内容被改过),确认码会失效,需要重新报价。
超过这个连接的「每月积分上限」时,操作不会执行,可以在「修改权限」里调高上限。发布文章不在允许范围内,只能在 Citadex 里操作;删除的提示词会移入回收站,30 天内可恢复。工作区的查看者即使连接了也不能执行操作。
提示词库
不知道问什么,就打开「MCP 提示词库」(设置页里的「打开提示词库」,或直接访问网站上的 /mcp/prompts,不需要登录)。里面有 35 个写好的提示词,分为简报与报告、竞品分析、引用来源、内容规划、代理与客户汇报五类,每个都标出会用到哪些数据。点「复制提示词」,粘贴到已连接的 AI 助手里,把方括号里的内容换成你自己的。设置页也会直接列出几个精选提示词。
连接后可先尝试以下问题:「这周我的品牌 AI 可见度怎么样?」「哪些提示词竞品被提到了而我们没有?」「我所在市场 AI 最常引用哪些来源?」「给日本市场写一份修复计划。」
如不确定连接方法,也可以在 Citadex 的 AI 助手中点击提问框的 + →「在 ChatGPT / Claude 里用 Citadex」,助手会分步骤引导。
常见问题
团队成员连接后能看到什么? 按他在工作区的角色访问,看到的是工作区所有者的项目。
代理商的客户能用吗? 只有代理商在白标设置里为客户打开「API 与 MCP」时可以,并且只能看到分配给他的项目。
为什么 ChatGPT 里看不到 Citadex? 确认已开启开发者模式、身份验证选了 OAuth,并在新对话里从工具菜单选择 Citadex。ChatGPT 需要付费账户。
授权后想换成只读怎么办? 在「已连接的应用」点「修改权限」,选「只读」后保存,立即生效。
Was this article helpful?
