MCP Server 与 Skill

将 GenTrack 连接到你的 AI 编程助手，在编辑器中直接查询品牌分析数据、运行 Agent 任务。

GenTrack MCP Server 让你的 AI 助手（Claude Code、Claude Desktop、Cursor 等）直接访问 GEO 分析数据 — 品牌提及、Prompt 追踪、引用分析、Agent 运行和计费信息，无需离开编辑器或终端。

前提条件

已注册 GenTrack 账号并配置了至少一个品牌
从 GenTrack 控制台生成的 API Key

获取 API Key

登录 GenTrack 控制台
进入设置（侧边栏齿轮图标）
滚动到 API Keys 区域
点击 创建 API Key
选择名称和权限范围：
- read — 查看品牌、分析、提及、计费（默认）
- write — 创建品牌、添加 Prompt、触发研究（写操作需要）
复制生成的 Key（以 gt_live_ 开头），妥善保存

安装

Claude Code（推荐）

一键复制安装命令：

Claude Code

claude mcp add --transport http gentrack https://mcp.gentrack.ai/mcp --header "Authorization: Bearer gt_live_YOUR_KEY_HERE"

安装后验证连接：

/mcp

在列表中选择 gentrack，即可看到所有可用工具。

Cursor

在 Cursor 中添加 MCP Server：

Cursor

cursor mcp add --transport http gentrack https://mcp.gentrack.ai/mcp --header "Authorization: Bearer gt_live_YOUR_KEY_HERE"

其他 MCP 客户端

任何兼容 MCP 的客户端可通过 Streamable HTTP 连接：

端点: https://mcp.gentrack.ai/mcp
认证: 每个请求携带 Authorization: Bearer gt_live_YOUR_KEY_HERE 请求头
协议: Streamable HTTP (MCP spec 2025-03-26)

可用工具

品牌管理

工具	描述
`list_brands`	列出组织内所有品牌，调用此工具获取品牌 ID
`get_brand`	获取品牌详情（名称、域名、分类、网站信息）
`create_brand`	创建新品牌进行追踪（需要 write 权限）
`list_competitors`	列出品牌配置的竞争对手
`add_competitor`	添加竞争对手进行对比（需要 write 权限）

数据分析

工具	描述
`get_overview`	仪表盘 KPI：提及率、声量份额、Prompt 评分、引擎分布、Top 引用页面。支持 7d/30d/90d
`list_mentions`	浏览品牌提及，可按引擎、情感、日期范围、全文搜索过滤
`get_mention_detail`	单条提及详情：AI 原始回答、引用、竞品提及
`list_prompts`	列出追踪的 Prompt，可按 `all`/`high_opp`/`not_ranking` 过滤
`get_top_opportunities`	按机会评分排序的 Top Prompt — 优化空间最大的方向
`get_leaderboard`	引擎表现排名：各 AI 引擎提及率和趋势
`get_citations_overview`	引用分析：引用份额、排名、位置、趋势、Top 被引域名
`get_word_cloud`	提及你品牌的 AI 回答中最高频的关键词

操作

工具	描述
`create_prompt`	添加新 Prompt 在所有引擎上追踪（需要 write 权限）
`start_research`	立即触发某 Prompt 在所有引擎上的研究，返回 `task_id`（需要 write 权限）
`poll_task`	查询后台任务状态：queued/running/done/failed

Agent 运行

工具	描述
`list_agent_templates`	列出可用的 Agent 模板（如 Community Insights、Content Optimizer），包含所需输入字段和配额消耗
`create_agent_run`	对品牌执行 Agent 模板任务，返回 `run_id`（消耗月度 Agent 额度，需要 write 权限）
`list_agent_runs`	列出品牌的历史 Agent 运行记录，支持按模板过滤和分页
`get_agent_run`	获取 Agent 运行详情，包含完成后的报告 Markdown

工具	描述
`get_billing_balance`	当前订阅方案和配额使用情况
`get_billing_usage`	本月各资源使用明细
`get_pricing`	各方案的功能和配额对比

常用场景

查看品牌表现

"我的品牌这个月表现怎么样？"

助手会先调用 list_brands 获取品牌 ID，再用 get_overview 查看提及率、声量份额、引擎分布和 Top 被引页面。

研究新 Prompt

"研究'最好用的项目管理工具'在所有 AI 引擎上的表现"

助手会调用 start_research 提交 Prompt，用 poll_task 等待结果，最后通过 list_mentions 展示各引擎的品牌提及情况。

发现优化机会

"我应该把优化精力放在哪里？"

助手会调用 get_top_opportunities 找到机会评分最高的 Prompt，再用 get_citations_overview 分析引用趋势。

运行 Agent 任务

"帮我跑一个社区洞察分析"

助手会先调用 list_agent_templates 查看可用模板，然后用 create_agent_run 提交任务（如 community_insights），再用 get_agent_run 轮询直到完成，最后展示生成的分析报告。

GenTrack Skill

除了 MCP Server，你还可以将 GenTrack Skill 文件添加到你的 AI 助手中。Skill 文件包含完整的工具说明和使用指南，让助手自动了解如何调用 GenTrack 的全部功能。

将以下内容复制并保存为 SKILL.md，放到你的 AI 助手的技能目录中（如 Claude Code 的 .claude/skills/ 目录）：

GenTrack Skill (SKILL.md)

---
name: gentrack
description: |
  Guide for installing and using the GenTrack MCP server — connects AI agents
  (Claude Code, Claude Desktop, Cursor) to GenTrack's GEO analytics platform.
  Use this skill whenever the user asks about setting up GenTrack MCP, connecting
  to GenTrack, querying brand analytics via MCP, managing tracked prompts through
  an AI agent, or troubleshooting GenTrack MCP connection issues. Also use when
...

故障排除

401 认证失败

确认 API Key 以 gt_live_ 开头
检查 --header 配置
确认 Key 未在控制台中被撤销

403 权限不足

API Key 仅有 read 权限。要使用写操作工具，需在控制台生成具有 write 权限的新 Key。

连接被拒绝

确认 GenTrack 服务可访问：curl https://mcp.gentrack.ai/mcp

MCP Server 与 Skill

On this page