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/ — 2 つのスキル。プラグインのインストール時に自動検出されます

スキルのみをインストールする（プラグインなし）

プラグイン／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 のウェブアプリケーション、Avo SDK、その他の Avo のソフトウェアやサービスに対する権利は付与しません。これらは別個の著作物であり、Avo の利用規約および Avo との契約が適用されます。