Matomo

Matomo MCP

Matomo の Reporting API から、ウェブサイトの集客、コンテンツ、コンバージョン、エンゲージメントに関する分析データを取得します。

Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• matomo_visit_summary — トラフィックとエンゲージメントの集計
• matomo_referrer_breakdown — 集客チャネルと参照元
• matomo_page_performance — ページビュー、流入、離脱、滞在時間
• matomo_goal_performance — 目標別のコンバージョンと収益

認証

Matomo のインストール URL を _baseUrl として、読み取り専用の認証トークンを _apiKey として渡します。リクエストには HTTPS が必要で、トークンは POST 本文で送信されます。このパックは読み取り専用です。

データソース

• Matomo Reporting API
• Reporting API のクエリ

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "matomo": {
      "url": "https://gateway.pipeworx.io/matomo/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/matomo/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールも返します。ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツールが含まれます。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共有ツールが約 30 個表示されます。接続時の initialize 応答に正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、ask_pipeworx を介してカタログ全体にルーティングできるため、このパックでは対応できない質問にも、MCP サーバーをもう 1 つ追加せずに回答できます。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキストコストがルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、各パックのすべてのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続してください。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使って、すべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

このパックでは、ご自身の API キー（_apiKey）を使用します。このパック用のキーは弊社では提供していないため、キーなしで実行できる curl コマンドはありません。ツールの内容は GET https://gateway.pipeworx.io/v1/tools/matomo_visit_summary で確認できます。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "matomo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-matomo"]
    }
  }
}

または、次のコマンドを直接実行して、起動することを確認できます。

npx -y @pipeworx/mcp-matomo

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Matomo data" })

ゲートウェイが適切なツールを選び、引数を自動で設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT