Avo MCP Server

Avo MCP Server とは？

Avo MCP Server は、Avo が https://mcp.avo.app/mcp で提供する公式のリモート MCP サーバーです。Claude、Cursor、Codex などの AI アシスタントが Avo のトラッキングプランに直接アクセスし、プランの参照、ブランチの確認、ブランチ上での変更の書き込みを行えます。

Avo はトラッキングプランとアナリティクスのデータガバナンスのためのプラットフォームです。チームは Avo でイベント、プロパティ、メトリクスを定義し、ブランチで変更をレビューし、Avo Codegen と Inspector でトラッキングを実装します。Avo MCP サーバーは 2026 年 6 月に beta を終了しました。エージェントによる書き込みはすべて Avo のブランチに入り、main へのマージは Avo の Web アプリで人が行います。

Avo MCP Server の使い方

ワークスペースにアクセスできる Avo アカウントと、HTTP トランスポートおよびブラウザでの OAuth サインインに対応した MCP クライアントが必要です。API キーは不要です。最初にツールが実行されると、クライアントがブラウザを開き、Avo にサインインして読み取りアクセスを承認します。最初の書き込み時にはもう一度ブラウザが開き、書き込み（write）スコープを付与します。

Claude Code

最も手早いのは Avo の Claude Code プラグインです。2 つのエージェントスキル（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 の ID に紐づく OAuth 2.0 + PKCE 認証。read と write のスコープ、動的クライアント登録に対応。
• Avo の Web アプリと同じワークスペースのメンバーシップと 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 でコネクタを追加できない：カスタムコネクタの追加には組織の管理者権限が必要です。