Avo

Avo MCP

mcp-name: io.github.avohq/avo

Avo MCP 服务（https://mcp.avo.app/mcp）允许 Claude、Codex、Cursor、Gemini 和其他 MCP 客户端读取和编辑你的 Avo 埋点计划。此仓库还提供 Agent Skills 和 Claude Code 插件，帮助你有效使用该服务。

每个技能都是一个独立目录，包含一个 SKILL.md（指令和元数据）以及随附资源。Claude 会在相关时自动加载这些技能，帮助你有效使用 Avo MCP 服务的工具（search、get、save_items、workflow 和分支工具）。

安装 Avo MCP 服务

Avo MCP 服务是一个位于 https://mcp.avo.app/mcp 的远程 OAuth 保护型 HTTP 服务。将其添加到你的 MCP 客户端：

Claude Code（CLI）

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

首次使用时，你需要通过浏览器登录。首次进行更改时，还会收到一次性的只读 → 写入重新身份验证提示。

Claude.ai / Claude Desktop

添加一个指向 https://mcp.avo.app/mcp 的自定义连接器（Settings → Connectors → Add custom connector）。按提示进行身份验证。

Cursor 和其他 MCP 客户端

在客户端配置中添加一个远程（可流式传输的 HTTP）MCP 服务：

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

如果你安装了 Claude Code 插件（见下文），插件会自动为你注册此服务——这些步骤适用于直接连接服务（其他客户端，或未安装插件的 Claude Code）。

技能

data-designer — 使用现有 Avo 埋点计划

探索、搜索现有 Avo 埋点计划并基于其进行设计：按名称、ID、含义或结构筛选条件查找事件／属性／指标；审查、确定优先级并实施分支；针对新功能或 PRD，结合现有内容设计埋点；进行小规模分支编辑；并将 Avo 与已连接的数据 MCP（Amplitude、Mixpanel、PostHog、BigQuery、Snowflake、Databricks、Redshift）结合，以诊断埋点缺口。

• 路径：skills/data-designer/

data-designer-new-plan — 初始化全新的 Avo 埋点计划

从头开始，在空白或几乎空白的工作区中初始化埋点计划：召开目标会议，讨论问题、目标、指标和关键漏斗；商定命名约定；创建首批类别和 start → milestone → complete 事件及其事件／用户／系统属性和约束，然后创建分支。

• 路径：skills/data-designer-new-plan/

用作 Claude Code 插件

此仓库也是一个 Claude Code 插件市场。安装 avo 插件即可一步完成打包两个技能并注册 Avo MCP 服务（https://mcp.avo.app/mcp）：

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

插件的目录结构：

• .claude-plugin/marketplace.json — 市场清单（列出 avo 插件）
• .claude-plugin/plugin.json — avo 插件清单
• .mcp.json — 注册 Avo MCP 服务
• skills/ — 两个技能，安装插件后会自动发现

仅安装技能（不安装插件）

若要在不安装插件／注册 MCP 的情况下使用技能，请将技能目录复制到个人或项目的技能文件夹中：

cp -R skills/data-designer ~/.claude/skills/data-designer
cp -R skills/data-designer-new-plan ~/.claude/skills/data-designer-new-plan

写入模型

所有写入操作都在分支上进行，绝不会在 main 上进行；MCP 不会合并分支——将分支合并到 main 始终需要由人工在 Avo Web 应用中完成。

来源

此仓库是这些技能的事实来源。Avo 的内部工具会从此处同步技能（此仓库无需运行构建步骤）。如需查看权威且始终最新的 Avo MCP 工具列表，请参阅 Avo MCP 工具参考。

许可证

本仓库的内容——data-designer 和 data-designer-new-plan Agent Skills，以及插件清单和配置——均根据 MIT License 发布。

这仅涵盖本仓库中的文件。它不授予您使用 Avo MCP 服务（https://mcp.avo.app/mcp）、Avo Web 应用、Avo SDK 或任何其他 Avo 软件或服务的权利——这些均为独立作品，受 Avo 的服务条款及您与 Avo 达成的协议约束。