Matomo Analytics

claude mcp add matomo \
  --env MATOMO_URL=https://your-matomo.example.com \
  --env MATOMO_TOKEN=YOUR_TOKEN \
  --env MATOMO_DEFAULT_SITE_ID=1 \
  -- matomo-mcp

claude_desktop_config.json に追加します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "matomo": {
      "command": "matomo-mcp",
      "env": {
        "MATOMO_URL": "https://your-matomo.example.com",
        "MATOMO_TOKEN": "YOUR_TOKEN",
        "MATOMO_DEFAULT_SITE_ID": "1"
      }
    }
  }
}

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）：

{
  "mcpServers": {
    "matomo": {
      "command": "matomo-mcp",
      "env": {
        "MATOMO_URL": "https://your-matomo.example.com",
        "MATOMO_TOKEN": "YOUR_TOKEN",
        "MATOMO_DEFAULT_SITE_ID": "1"
      }
    }
  }
}

.vscode/mcp.json：

{
  "servers": {
    "matomo": {
      "type": "stdio",
      "command": "matomo-mcp",
      "env": {
        "MATOMO_URL": "https://your-matomo.example.com",
        "MATOMO_TOKEN": "${input:matomo-token}",
        "MATOMO_DEFAULT_SITE_ID": "1"
      }
    }
  },
  "inputs": [
    {
      "id": "matomo-token",
      "type": "promptString",
      "description": "Matomo API token",
      "password": true
    }
  ]
}

stdio 経由で MCP を利用できるクライアントなら、次の汎用形式で動作します。

{
  "command": "matomo-mcp",
  "args": [],
  "env": {
    "MATOMO_URL": "https://your-matomo.example.com",
    "MATOMO_TOKEN": "YOUR_TOKEN",
    "MATOMO_DEFAULT_SITE_ID": "1"
  }
}

{
  "mcpServers": {
    "matomo": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MATOMO_URL", "-e", "MATOMO_TOKEN", "-e", "MATOMO_DEFAULT_SITE_ID",
        "ghcr.io/liohtml/matomo-mcp"
      ],
      "env": {
        "MATOMO_URL": "https://your-matomo.example.com",
        "MATOMO_TOKEN": "YOUR_TOKEN",
        "MATOMO_DEFAULT_SITE_ID": "1"
      }
    }
  }
}

サーバーを一度起動し（ワークステーション、LAN 上のマシン、コンテナなど）、任意の数の MCP クライアントから接続します。

matomo-mcp --url https://your-matomo.example.com --token YOUR_TOKEN --http 127.0.0.1:8080

クライアントはストリーム可能な HTTP トランスポートを使って http://127.0.0.1:8080/mcp に接続します。例：

claude mcp add --transport http matomo http://127.0.0.1:8080/mcp

警告

HTTP エンドポイントには認証機能が組み込まれていません。127.0.0.1 にバインドするか、ローカルホストの外部に公開する前に、認証付きリバースプロキシ（またはファイアウォール）を前段に設置してください。

--default-site-id 1 を指定する（推奨）か、先にモデルから matomo_list_sites を呼び出してください。

matomo-mcp --url ... --token ... --check を実行してください。失敗する場合は、トークンを再生成し（Settings → Personal → Security）、サイトへの閲覧アクセス権があることを確認してください。

MATOMO_URL は Matomo のルート、つまり index.php があるフォルダーを指している必要があります。https://example.com/matomo/index.php の場合は、https://example.com/matomo/ を指定してください。

バイパス用ヘッダーを挿入してください：--header "CF-Access-Client-Id:..." --header "CF-Access-Client-Secret:..."（または MATOMO_EXTRA_HEADERS 経由）。

これはコンテキスト制限が適切に機能しているためです。行数を減らす、日付範囲を短くする、または --max-response-chars を大きくしてください。