AthenaHQ MCP Server

什么是 AthenaHQ MCP Server？

AthenaHQ MCP Server 是 AthenaHQ 官方的远程 MCP 服务器。它让 Claude、ChatGPT 和其他 AI 助手可以用自然语言查询你的 AI 搜索可见度数据（声量占比、引用率和提及率、排名位置、被引用来源、跟踪的提示词、AI 回答和内容）。

AthenaHQ 是一个面向 AEO 和 GEO 工作的 AI 搜索优化平台。它跟踪品牌在 ChatGPT、Perplexity、Google AI Overviews、Gemini、Copilot 等模型回答中的表现，面向市场、SEO、公关和内容团队。MCP 服务器把这些数据以及一组写入操作放在同一个端点后：https://api.athenahq.ai/api/mcp。

如何使用 AthenaHQ MCP Server？

根据 AthenaHQ 文档，有两种认证方式：

• 使用 AthenaHQ 账号登录（OAuth）。Claude.ai 连接器和 ChatGPT 插件使用这种方式，无需 API key，登录时选择组织即可。
• API key，用于不支持登录流程的客户端。在 AthenaHQ 控制台的 API Keys 页面创建 key（只有组织管理员可以创建），并以 x-api-key: <key> 或 Authorization: Bearer <key> 发送。key 可以限定到特定网站。

少数工具（例如 check_public_ai_access）无需账号也能使用。

Claude Code

AthenaHQ 文档给出的命令如下（把占位符替换为你的 key）：

claude mcp add --transport http --scope user athenahq https://api.athenahq.ai/api/mcp \
  --header "x-api-key: YOUR_ATHENAHQ_API_KEY"

Claude Desktop 和 claude.ai

从 Claude 连接器目录中的 AthenaHQ 条目连接，或者打开 Customize → Connectors，添加名为 AthenaHQ、URL 为 https://api.athenahq.ai/api/mcp 的自定义连接器，然后在浏览器中用 AthenaHQ 账号登录。在 Team 和 Enterprise 套餐中，需要 Owner 先启用该连接器。

Cursor

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "athenahq": {
      "url": "https://api.athenahq.ai/api/mcp",
      "headers": {
        "x-api-key": "YOUR_ATHENAHQ_API_KEY"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "athenahq": {
      "type": "http",
      "url": "https://api.athenahq.ai/api/mcp",
      "headers": {
        "x-api-key": "YOUR_ATHENAHQ_API_KEY"
      }
    }
  }
}

AthenaHQ MCP Server 的主要功能

• 由 AthenaHQ 托管的官方远程服务器，共约 80 个工具。
• 品牌可见度指标，可按累计值或每日时间序列查看：声量占比、引用率、提及率和排名位置。
• 原始 AI 回答及其来源、情感和排名，以及基于分析数据仓库的灵活查询工具 query_metrics 和 query_rows。
• 访问 Content Hub 和 Knowledge Base，包括起草、编辑和版本管理内容。
• 用于提示词、主题、标签、保存视图、地区和品牌事实的写入工具，验证和审计日志与控制台一致。
• 访问范围取决于凭据：登录用户按其角色权限，API key 按其网站范围。
• 提供无需账号即可使用的公开爬虫检查。

AthenaHQ MCP Server 工具

可见度指标。 get_share_of_voice_cumulative、get_citation_rate_time_series、get_mention_rate_cumulative、get_position_distribution 等工具报告 AI 模型相对于竞争对手提及、引用和排名你品牌的频率。get_ai_search_value 估算主题市场价值和增长空间。

提示词和回答。 get_prompts、get_topics、get_personas 和 get_prompt_tags 列出跟踪的内容；get_responses 和 get_response_detail 返回 AI 回答本身。

来源和品牌特征。 get_sources 和 get_source_pages 显示哪些域名和 URL 被引用；get_attributes 和 get_attribute_metrics 涵盖“Affordable”等品牌认知关键词。

内容和 Knowledge Base。 list_content、get_tracked_content、create_content、edit_content 和 get_content_versions 用于 Content Hub；get_brand_facts 和 add_brand_facts 管理品牌事实。

账号和写入。 list_websites、get_credits_organization 和 get_credit_usage 涵盖账号信息。create_prompts、create_topic 和 delete_prompt 等写入和删除工具会修改你的配置，其中一些是破坏性操作。

公开检查。 check_public_ai_access 检查公开域名对 AI 爬虫 user agent 的响应及其 robots.txt 规则，无需 AthenaHQ 账号。

AthenaHQ MCP Server 的使用场景

• 每周报告：“用 AthenaHQ 比较过去 30 天我们和竞争对手的声量占比。”
• 回答审查：“在我们跟踪的回答中，ChatGPT 是怎么评价我们品牌的？”
• 引用策略：“哪些页面被引用了？接下来应该重点做什么？”
• 竞争跟踪：“上个月哪些竞争对手的声量占比上升了？”
• 上线前技术检查：“检查 AI 爬虫能否访问 example.com。”

AthenaHQ MCP Server 常见问题排查

• 部分工具返回权限错误。 访问取决于你的角色或 key 范围。群组、用户查询和额度用量工具需要全局组织 API key，或具有账单权限的组织管理员。
• 结果中缺少 Claude 的回答。 出于服务商政策，Claude 连接器会排除单条 Claude 生成的回答；汇总数据仍可能包含它们。请使用控制台或 REST API 查看。
• 日期筛选失败。 使用 YYYY-MM-DD 或写出月份名称；“yesterday”这类相对日期和 03/04/2026 这类有歧义的日期会被拒绝。
• 公开扫描被限流。 公开扫描限制为每个 IP 每分钟 5 次，匿名请求限制为每分钟 60 次。