Cited

cited-mcp

适用于 Cited 的 MCP 服务：当买家询问您销售的产品时，查看 ChatGPT、Gemini、Claude 和 Google AI Mode 是否引用了您的网站，并获取提升引用率的改进建议。通过 Model Context Protocol 提供 21 个工具：包括 19 个 Cited 工具（与托管服务 mcp.youcited.com 提供的工具相同），以及本地 login 和 logout。

安装

pip install cited-mcp

也可以直接运行，无需安装：

uvx cited-mcp

用法

托管服务地址为 https://mcp.youcited.com/mcp（可流式传输的 HTTP；首次使用时，浏览器会打开登录页面）。无需登录即可使用 free_audit、account_status、agent_signup 和 search_docs 工具。

**快速设置：**安装 cited-cli 后，运行 cited agent setup，即可为 Claude Code、Cursor 和 Codex 配置，并显示 Claude Desktop 连接器的设置步骤（使用 --dry-run 可预览）。该命令会合并现有配置，并在修改文件前创建备份。

Claude Desktop（自定义连接器——推荐）

无需本地安装。Claude 会直接连接 Cited 的托管 MCP 服务：

1. 打开 Claude Desktop → Settings → Customize > Connectors
2. 点击 "+" → "Add custom connector"
3. 输入 URL：https://mcp.youcited.com/mcp
4. 点击 Add

首次使用时，浏览器会打开进行身份验证。详情请参阅 Anthropic 的连接器指南。

**要求：**Claude Pro、Max、Team 或 Enterprise 计划。

Claude Desktop（开发者配置——替代方案）

如果无法使用自定义连接器，请通过 mcp-remote 使用开发者配置：

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.youcited.com/mcp"]
    }
  }
}

将配置添加到 Settings → Developer → Edit Config，然后重启 Claude Desktop。

**前置条件：**必须安装 Node.js，以便使用 npx。

Claude Desktop（本地 stdio 服务）

如果您希望在本地运行服务：

{
  "mcpServers": {
    "cited": {
      "command": "uvx",
      "args": ["cited-mcp"],
      "env": {
        "CITED_TOKEN": "your-jwt-token"
      }
    }
  }
}

使用 cited-cli 运行 cited login，然后运行 cited auth token 获取令牌。

Claude Code

claude mcp add --transport http --scope user cited https://mcp.youcited.com/mcp

然后在 Claude Code 中运行 /mcp 并选择 Authenticate。如需使用 Cited 斜杠命令、技能和 geo-analyst Agent，还需运行 /plugin marketplace add YouCited/cited-plugins 和 /plugin install cited@youcited-cited-plugins 安装插件。

Cursor

将配置添加到 ~/.cursor/mcp.json（全局配置），或添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "cited": {
      "url": "https://mcp.youcited.com/mcp"
    }
  }
}

然后在 Cursor 中打开 Settings（Cmd+,）→ MCP，点击 cited 旁边的 Login，并确认显示绿色状态指示灯。在 Agent 模式下使用 Cited 工具。

备用方案（不支持远程服务的旧版 Cursor）——通过 mcp-remote 代理运行，该工具需要 Node.js（运行 node --version 应显示 v18+）：

{
  "mcpServers": {
    "cited": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.youcited.com/mcp"]
    }
  }
}

Codex

codex mcp add cited --url https://mcp.youcited.com/mcp
codex mcp login cited

或者，将 [mcp_servers.cited] 和 url = "https://mcp.youcited.com/mcp" 添加到 ~/.codex/config.toml。

独立运行

cited-mcp                          # stdio; uses `cited login`, CITED_TOKEN or an agent key
CITED_ENV=dev cited-mcp            # another environment

工具只在 Cited API 中定义一次。服务启动时，会通过 GET https://api.youcited.com/agent/tools 获取当前工具列表（如果失败，则使用 cited-core 随附的列表），并通过 POST /agent/tools/{name} 执行每次调用，因此其行为始终与托管服务一致。

更新以使用 Cited 的新功能

客户端会缓存工具列表。Cited 发布新版本后，请重新连接连接器（或重启本地 cited-mcp），以获取新工具。

工具

从 account_status 开始：它会显示当前登录的用户、信用余额、商家和下一步操作。

工具	功能	登录
free_audit	免费检查 AI 如何回答关于某网站的 5 个买家问题；使用 report_token 轮询	否
agent_signup	无需登录即可为用户创建账户；密钥会保存在本地，并返回认领链接和代码	否
account_status	当前登录的用户、余额、商家、价格、下一步操作	否
search_docs	搜索 Cited 文档，或通过 path 阅读其中一篇	否
buy_credits	获取信用点数套餐或单次审核的结账链接，或兑换代金券	是
setup_business	根据网站添加商家，或更新商家、买家画像和产品与服务	是
get_business	列出商家，或查看某个商家的资料、问题、计划和近期审核	是
get_agent_brief	查看某个商家下一步应重点关注的事项	是
draft_questions	起草、扩展或替换审核提出的买家问题	是
quote_audit	查看审核费用、余额和模型	是
run_audit	执行付费审核；会先返回价格，只有在 confirm=true 时才会扣费	是
get_audit	列出审核，或查看某次审核的状态和报告	是
compare_audits	与较早的审核相比，查看赢得和失去的引用	是
schedule_recheck	每隔 N 天重新执行审核，并通过电子邮件和 webhook 发送提醒	是
get_recommendations	查看要更改的内容、条目键、证据、状态和修复方案	是
update_recommendation	将条目标记为已完成或已忽略，或重新打开	是
generate_fixes	为条目（或全部条目）编写修复文件和步骤；扣费前会询问	是
get_fixes	列出修复，或查看某项修复的文件、目标和步骤	是
update_fix	在在线网站上将修复标记为 done、undo 或 verify	是
login	通过浏览器登录，并在此机器上保存会话（仅限本地服务）	否
logout	清除会话或已保存的 Agent 密钥（仅限本地服务）	否

示例工作流

1. 先调用 account_status，然后通过 free_audit 输入网站，免费进行初步检查。
2. 调用 agent_signup（或 login），然后通过 setup_business 输入网站。
3. 调用 draft_questions，与用户一起审核问题，然后调用 quote_audit。
4. 调用 run_audit（由用户确认价格），然后持续调用 get_audit，直到审核完成。
5. 调用 get_recommendations、generate_fixes，再调用 get_fixes 查看文件，最后通过 update_fix 执行 done 和 verify。

定价：按需付费信用点数

没有套餐或订阅。1 个信用点数 = 1 美元；account_status 和 quote_audit 会显示当前价格。购买工具只会返回供用户打开的 Stripe 结账链接：只有当 account_status 显示新余额时，才表示购买成功。余额不足时会返回错误，包含 status_code 402 和 credits_needed。

Agent 注册和密钥

agent_signup 会为 AI Agent 创建一个尚未认领的账户。API 密钥会保存在此机器上（操作系统密钥链，或 ~/.cited/credentials.json），并用于每次调用；该密钥绝不会显示给模型。请将认领链接和 6 位数代码提供给用户，以便其保留账户。logout 会清除密钥。

环境变量

变量	描述
CITED_TOKEN	Cited 会话令牌（先运行 cited login，再运行 cited auth token）。可选。
CITED_AGENT_API_KEY	Cited Agent 密钥（cak_...）。可选；agent_signup 会为你保存密钥。
CITED_ENV	prod（默认）、dev 或 local。

开发

pip install -e ../core -e ".[dev]"
pytest
ruff check src/ && mypy src/ --ignore-missing-imports

隐私政策

请参阅 youcited.com/privacy。

许可证

专有软件 — 条款请参阅 youcited.com。