Avo MCP Server

什么是 Avo MCP Server？

Avo MCP Server 是 Avo 官方的远程 MCP 服务器，地址为 https://mcp.avo.app/mcp。它让 Claude、Cursor、Codex 等 AI 助手直接访问你的 Avo 埋点方案（tracking plan），可以读取方案、浏览分支，并在分支上写入修改。

Avo 是一个埋点方案与分析数据治理平台：团队在 Avo 中定义事件、属性和指标，在分支上评审变更，并通过 Avo Codegen 和 Inspector 落地埋点。Avo MCP 服务器于 2026 年 6 月结束 beta。智能体的所有写入都会落在 Avo 分支上，合并到 main 仍需人工在 Avo 网页端完成。

如何使用 Avo MCP Server？

你需要一个能访问工作区的 Avo 账号，以及一个支持 HTTP 传输和浏览器 OAuth 登录的 MCP 客户端。不需要 API 密钥。第一次调用工具时，客户端会打开浏览器，让你登录 Avo 并授予读取权限；第一次写入时会再弹出一次，用于授予写入（write）权限。

Claude Code

最快的方式是使用 Avo 的 Claude Code 插件。它会安装两个智能体技能（data-designer 和 data-designer-new-plan），并注册 MCP 服务器：

claude plugin marketplace add avohq/avo-mcp
claude plugin install avo@avo-mcp

然后运行 /reload-plugins 或重启 Claude Code。如果只想添加服务器、不需要技能：

claude mcp add --transport http avo https://mcp.avo.app/mcp

Claude Desktop 和 claude.ai

进入 Settings → Connectors → Add custom connector，名称填 Avo，粘贴 https://mcp.avo.app/mcp。登录会在浏览器中完成。Avo 提示，在 Claude Desktop 中添加连接器需要组织的管理员权限。

Cursor

在 ~/.cursor/mcp.json（或项目内的 mcp.json）中添加：

{
  "mcpServers": {
    "Avo": {
      "url": "https://mcp.avo.app/mcp"
    }
  }
}

VS Code

在 .vscode/mcp.json 中添加：

{
  "servers": {
    "avo": {
      "type": "http",
      "url": "https://mcp.avo.app/mcp"
    }
  }
}

Avo MCP Server 的主要功能

• 官方出品，由 Avo 托管：无需在本地安装或编译任何东西。
• 基于你的 Avo 身份的 OAuth 2.0 + PKCE 认证，提供 read 和 write 两种权限范围，并支持动态客户端注册。
• 与 Avo 网页端相同的工作区成员资格和 Editor/Admin 角色校验。
• 对事件、属性和指标进行语义搜索，例如“checkout started”也能找到名称不同的事件。
• 只写入分支：服务器从不合并到 main。
• 按智能体意图划分的文档化工具：list_workspaces（获取工作区 ID）、search（发现）、get（获取事件、属性、旅程、分支或数据源的完整信息）、save_items（在分支上创建、更新、归档或恢复条目）、workflow（创建分支、拉取 main、批量导入方案）以及 give_feedback。
• 根据分支差异生成实现指南和按数据源划分的代码片段。

Avo MCP Server 的使用场景

• 检查现有覆盖：“我们在 Avo 中已经有哪些注册相关的事件？”
• 根据需求设计：“这是新结账流程的 PRD，帮我设计在 Avo 中需要的事件和属性。”然后：“创建一个分支，把这些事件和属性加进去。”
• 实现分支：“显示 checkout-redesign 分支的差异，并为新事件生成 Avo Codegen 调用。”
• 阅读用户旅程：“带我过一遍结账旅程，每个页面会触发什么事件？”
• 从零开始：“我们还没有埋点方案，帮我为移动应用搭建一个。”
• 将 Avo 的指标定义与 Amplitude、Mixpanel、BigQuery 等数据 MCP 结合，正确地查询分析数据。

Avo MCP Server 常见问题排查

• 在 CI 或容器中无法完成登录：无头环境无法完成浏览器 OAuth 流程，请在交互式客户端中使用。
• 写入时再次要求登录：这是正常的。写入工具需要 write 权限，客户端会在第一次写入时提升一次权限。
• 工具没有返回工作区数据：先调用 list_workspaces。其他工具都以 workspaceId 为范围，并会校验你的工作区成员资格。
• 无法在 Claude Desktop 中添加连接器：在那里添加自定义连接器需要组织管理员权限。