WireBoard

wireboard-mcp

WireBoard の公式 Model Context Protocol サーバーです。

LLM エージェント（Claude Desktop、Cursor、VS Code など）が、会話の中でリアルタイムおよび過去の分析データを照会できます。公式の @wireboard/api JavaScript SDK を基盤として構築されています。

---

インストール

インストール方法は 2 つあります。環境に合った方法を選んでください。

オプション A：デスクトップ拡張機能（Claude Desktop ユーザーにおすすめ）

GitHub リリースページから wireboard-mcp-x.y.z.mcpb をダウンロードして、ダブルクリックしてください。Windows、macOS、Linux のいずれでも同じファイルを使用できます。Claude Desktop には独自の Node ランタイムが付属しているため、システム依存関係をインストールする必要はありません。

Claude Desktop が WireBoard API トークンの入力を求め、OS のキーチェーンに安全に保存します。WireBoard のツールはすぐに利用可能になります。

ダブルクリックしてもファイルが開かない場合は、Claude Desktop → Settings → Extensions → Advanced Settings → Install Extension からインストールしてください。

オプション B：npm でインストール（Cursor、VS Code、ヘッドレス環境／CI、自動化向け）

npm install -g @wireboard/mcp

Node 18 以降が必要です。その後、使用する MCP クライアントを設定してください。

Claude Desktop の設定

claude_desktop_config.json を編集します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "wireboard": {
      "command": "wireboard-mcp",
      "env": {
        "WIREBOARD_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop を再起動してください。WireBoard のツールが自動的に表示されます。

Cursor／VS Code／その他の MCP クライアント

クライアントの MCP 設定で、同じコマンドと環境変数のパターンを使用してください。

トークンの発行

どちらのインストール方法でも、事前に WireBoard API トークンが必要です。Settings → API で、REST ツールには analytics:read 権限、ライブスナップショットツールには live:read 権限を付与してトークンを発行してください。

質問できること

設定後は、次のようなことを Claude に尋ねられます。

• 「先週、サイトの訪問者数は何人でしたか？」
• 「過去 30 日間の参照元上位 10 件を表示してください。」
• 「現在、サイトでは何が起きていますか？」
• 「今月、/checkout 配下で直帰率が最も高いページはどれですか？」
• 「昨日、utm_source=newsletter から発生した Purchase イベントは何件ですか？」
• 「過去 2 週間の日ごとの訪問者数を比較してください。」

Claude が適切なツールを選んで呼び出し、自然な言葉で回答します。

利用可能なツール

ツール	内容
list_sites	アカウント内のすべてのサイト
get_account	トークン所有者の情報と権限
get_aggregate	期間ごとの合計値：訪問者数、ページビュー数、直帰率、滞在時間
get_timeseries	時間または日単位に分割した単一指標（訪問者数またはページビュー数）
get_history	日ごとの訪問者数／リピーター数／ページビュー数／直帰率／滞在時間
get_breakdown	ディメンション別の上位 N 件（国、デバイス、ブラウザー、参照元など）
get_top_urls	プレフィックス／部分一致／完全一致のフィルターに対応した URL ごとの指標
query_events	グループ化とフィルタリングに対応したカスタムイベントのクエリ
get_live_state	リアルタイムのスナップショット（現在の訪問者数、上位ページ、アクティブなセッションなど）
list_dimensions	メタ情報：API がサポートするすべてのディメンション、指標、上限

すべてのツールで、自然な日付範囲を指定できます。「today」、「yesterday」、「last 7 days」（または省略形の「30d」）、「this week」、「last week」、「this month」、「last month」、あるいは明示的な「YYYY-MM-DD..YYYY-MM-DD」です。すべて UTC です。

レート制限

MCP は、API の上限である 1 分あたり 120 リクエストを超えないよう、1 分あたり 100 リクエスト に自主的に制限します。そのため、LLM からのリクエストが集中しても間隔が空き、429 エラーを避けられます。異なるペースが必要な場合は、WIREBOARD_MCP_RATE_PER_MINUTE 環境変数で上書きしてください。

基盤となる SDK も、最後の防御策として 429 発生時に自動で再試行します。

セキュリティ

• トークンは認証情報として扱ってください。 アカウント内のすべてのサイトで、analytics:read と live:read の完全なスコープが付与されています。
• トークンを含む MCP クライアント設定を、公開リポジトリにコミットしないでください。 環境変数またはシークレットマネージャーを使用し、設定から参照してください。
• トークンが漏えいした場合は、失効させてローテーションしてください。 ダッシュボードの「Settings → API」から操作できます。

MCP は読み取り専用です。データを取得できますが、変更することはできません。WireBoard の公開 API 自体も、v1 では読み取り専用です。

ログ

ログは stderr に出力されます（stdout 上の MCP プロトコルに干渉しないようにするためです）。

ソースとコントリビューション

• npm： @wireboard/mcp
• リポジトリ： github.com/wireboard/mcp
• リリース（.mcpb ダウンロード）： github.com/wireboard/mcp/releases
• 課題： github.com/wireboard/mcp/issues
• 基盤となる SDK： @wireboard/api (ソース)
• WireBoard のドキュメント： https://wireboard.io/docs/api-overview

ローカルでのビルド

npm install
npm test               # run vitest
npm run build          # bundle TS → dist/index.js (esbuild, ~600 KB)
npm run build:mcpb     # also pack dist/wireboard-mcp-<version>.mcpb

.mcpb は、manifest.json、icon.png、単一のバンドル済みファイル dist/index.js をまとめた zip です。実行時の依存関係はすべて esbuild によってインライン化されます。

ライセンス

MIT。