内容
# Avo MCP
mcp-name: io.github.avohq/avo
**Avo MCP 服务器** (`https://mcp.avo.app/mcp`) 允许 Claude、Codex、Cursor、Gemini 等 MCP 客户端读取和编辑您的 [Avo](https://www.avo.app) 跟踪计划。此仓库还提供了 [Agent Skills](https://docs.claude.com/en/docs/claude-code/skills) 和 Claude Code 插件，以指导有效使用服务器。
每个技能都是一个独立的目录，包含 `SKILL.md`（说明 + 元数据）和捆绑的资源。Claude 会在相关时自动加载它们，以指导有效使用 Avo MCP 服务器的工具（`search`、`get`、`save_items`、`workflow` 和分支工具）。
## 安装 Avo MCP 服务器
Avo MCP 服务器是一个远程的、受 OAuth 保护的 HTTP 服务器，位于 `https://mcp.avo.app/mcp`。将其添加到您的 MCP 客户端：
**Claude Code（CLI）**
```bash
claude mcp add --transport http avo https://mcp.avo.app/mcp
```
您将在首次使用时通过浏览器登录。第一次进行更改时，您还将获得一次读取 → 写入重新身份验证提示。
**Claude.ai / Claude Desktop**
添加一个自定义连接器，指向 `https://mcp.avo.app/mcp`（设置 → 连接器 → 添加自定义连接器）。在提示时进行身份验证。
**Cursor 和其他 MCP 客户端**
在客户端配置中添加一个远程（可流式 HTTP）MCP 服务器：
```json
{
"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/`](skills/data-designer/)
### `data-designer-new-plan` — 启动全新的 Avo 跟踪计划
在空或近空的工作区中，从头开始引导跟踪计划：运行目标会议（问题、目标、指标、关键漏斗），约定命名约定，并播种第一个类别和 `start → milestone → complete` 事件，包含事件/用户/系统属性和约束 — 然后创建分支。
- 路径：[`skills/data-designer-new-plan/`](skills/data-designer-new-plan/)
## 作为 Claude Code 插件使用
此仓库也是 Claude Code 插件市场。安装 `avo` 插件会同时绑定两个技能 **和** 注册 Avo MCP 服务器 (`https://mcp.avo.app/mcp`)：
```bash
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 注册，请将技能目录复制到您的个人或项目技能文件夹中：
```bash
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 网页应用中的人为步骤。
## 源
此仓库是这些技能的源代码。Avo 的内部工具会从此处同步它们（此仓库中无需运行构建步骤）。有关规范的、始终最新的 Avo MCP 工具列表，请参阅 [Avo MCP 工具参考](https://www.avo.app/docs/reference/avo-mcp/tools)。
