Kochava for Advertisers — Official MCP Server

Kochava 广告主版 — MCP 服务

Kochava for Advertisers 是 Kochava 提供的全渠道衡量与归因平台，面向品牌及其代理机构，提供末次点击归因、增量分析和 MMM 工具。

此 MCP 服务可让任何 AI 工具查询实时 Kochava 归因数据、管理广告系列并创建报告——无需现有账户。连接后，可在会话中创建免费账户并立即开始查询。

没有账户？没问题。

开始使用无需 Kochava 账户。此服务包含两个无需身份验证的公共工具：

1. kochava_free_app_analytics_get_tos — 查看 Free App Analytics 服务条款
2. kochava_free_app_analytics_create_acc_and_get_auth_key — 创建免费账户并立即获取 API 密钥，就在对话中完成

获取 API 密钥后，将其设为 authentication-key 标头，即可使用完整的 30 个工具。

连接

端点：https://analytics.mcp.kochava.com/mcp 传输方式：Streamable HTTP 身份验证：authentication-key 标头（注册时可选，使用数据工具时必需）

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 ~/.config/claude/claude_desktop_config.json（Linux），也可以在应用中通过“设置”→“开发者”→“编辑配置”添加：

{
  "mcpServers": {
    "kochava": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://analytics.mcp.kochava.com/mcp",
        "--header", "authentication-key:YOUR_API_KEY"
      ]
    }
  }
}

需要 Node.js（用于 npx）。将 authentication-key 留空或完全省略 --header 参数，即可仅使用 FAA 注册工具。保存后，请完全退出并重新打开 Claude Desktop，使更改生效。

Claude Code

claude mcp add kochava --transport streamable-http https://analytics.mcp.kochava.com/mcp --header "authentication-key: YOUR_API_KEY"

完全省略 --header 参数，即可仅使用 FAA 注册工具。

Cursor

“设置”→“工具与 MCP”→“添加自定义 MCP”，随后会打开 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）供编辑：

{
  "mcpServers": {
    "kochava": {
      "url": "https://analytics.mcp.kochava.com/mcp",
      "headers": {
        "authentication-key": "YOUR_API_KEY"
      }
    }
  }
}

将 authentication-key 留空或完全省略 headers 配置块，即可仅使用 FAA 注册工具。

VS Code / GitHub Copilot

添加到 .vscode/mcp.json：

{
  "servers": {
    "kochava": {
      "type": "streamable-http",
      "url": "https://analytics.mcp.kochava.com/mcp",
      "headers": {
        "authentication-key": "YOUR_API_KEY"
      }
    }
  }
}

工具

Free App Analytics（无需身份验证）

工具	说明
kochava_free_app_analytics_get_tos	获取 FAA 服务条款链接
kochava_free_app_analytics_create_acc_and_get_auth_key	创建免费账户，并在会话中获取 API 密钥

分析与报告

工具	说明
get_all_apps	列出账户中的所有应用
get_app_dimensions	获取应用可用的维度
run_search_query	执行分析搜索查询
get_event_detail	获取事件级别的详细数据
get_explorer_data	查询分析探索器
get_funnel_data	获取漏斗分析数据
get_LTV_details	获取生命周期价值详情
get_retention_overlay	获取留存叠加数据
get_currencies	列出支持的货币

报告查询

工具	说明
search_tables	搜索可用的报告表
get_saved_queries	列出已保存的报告查询
execute_report_query	执行报告查询
get_query_results	获取已执行查询的结果

广告系列管理

工具	说明
kochava_list_campaigns	列出所有广告系列
kochava_get_campaign	获取广告系列详情
kochava_create_campaign	创建新的广告系列
kochava_update_campaign	更新现有广告系列

跟踪器管理

工具	描述
kochava_list_trackers	列出所有跟踪器
kochava_create_tracker	创建新的跟踪器
kochava_update_tracker	更新现有跟踪器
kochava_delete_tracker	删除跟踪器
kochava_get_tracker_metrics	获取跟踪器性能指标
kochava_get_all_media_partners	列出可用的媒体合作伙伴
kochava_get_agency_networks	列出代理商网络
kochava_list_events_for_tracker_creation	列出可用于设置跟踪器的事件

细分管理

工具	描述
kochava_list_segments	列出所有细分
kochava_create_segment	创建新的细分
kochava_update_segment	更新现有细分

身份验证

无密钥：你可以连接并使用两个 FAA 注册工具创建免费账户。API 密钥会立即在对话中返回。

使用密钥：将 authentication-key 标头设置为你的 Kochava API 密钥。全部 30 个工具均可使用。

Free App Analytics 提供 30 天的数据保留期。升级到 Enterprise 即可享受无限保留期——使用相同的 API 密钥和 MCP 连接，无需迁移。

故障排除

错误	原因	解决方法
401 Unauthorized	缺少 authentication-key 标头	将你的 API 密钥添加为 authentication-key 标头
403 Invalid token	无法识别 API 密钥	在 console.kochava.com 验证你的密钥
503 Service unavailable	身份验证服务暂时不可用	几秒后重试
account_exists	公司名称已注册	使用其他公司名称，或在 console.kochava.com 登录

支持

• 电子邮件：[email protected]
• 控制台：console.kochava.com