Statable

Statable MCP サーバー

ウェブサイトのトラフィックについて、AI アシスタントに質問できます。このパッケージは、Claude、Cursor、ChatGPT、Claude Desktop、その他の MCP クライアントを、EU でホストされているプライバシー重視・Cookie 不使用のウェブ解析サービス Statable に接続します。

ホスト型 Statable MCP エンドポイント（https://mcp.statable.com/mcp）への、シンプルな stdio ブリッジです。各ツール呼び出しは、API キーとともにエンドポイントへ転送されます。ローカルには何も保存されません。

接続方法

クライアント	使用方法
Claude Code、Cursor、ChatGPT、Codex、および OAuth 対応のその他のクライアント	https://mcp.statable.com/mcp に直接接続し、ブラウザーでサインインします。キーもパッケージも不要です。ドキュメントをご覧ください。
Claude Desktop、ローカル stdio サーバーのみを実行するホスト、CI スクリプト、サンドボックス	API キーを使ってこのパッケージを使用します。

クイックスタート

1. Statable ダッシュボードで、Settings → API keys → Create API key を開きます。キーは stbl_ で始まります。アシスタントが使用できるサイトと権限を選択します。
2. サーバーをクライアントに追加します。Claude Desktop（claude_desktop_config.json）の場合：

{
  "mcpServers": {
    "statable": {
      "command": "npx",
      "args": ["-y", "@statable/mcp"],
      "env": { "STATABLE_API_KEY": "stbl_your_key" }
    }
  }
}

Cursor（~/.cursor/mcp.json）や、ほとんどのその他のホストでも、同じ形式を使用できます。

Claude Code の場合：

claude mcp add statable --scope user -e STATABLE_API_KEY=stbl_your_key -- npx -y @statable/mcp

3. 次のように質問します：「example.com の先週の訪問者数は何人で、どこから来ましたか？」

ツール（25）

読み取り：list_sites、query_stats、top_pages、top_sources、top_countries、top_custom_events、top_goals、list_goals、list_prop_keys、list_funnels、funnel_report、current_visitors、visitors_over_time、get_tracking_snippet、get_site_filters、get_subscription

設定：create_site、update_site、create_goal、update_goal、create_funnel、update_funnel、get_tracking_settings、update_tracking_settings、update_site_filters

query_stats は汎用ツールです。あらゆる指標（訪問者数、ページビュー、直帰率、エンゲージメント、ゴール、離脱率など）、ディメンション（参照元、ページ、国、デバイス、UTM、カスタムイベントプロパティなど）、フィルターについて、集計、時系列、上位 N 件の内訳を取得でき、期間比較にも対応しています。すべての数値は、サイトのタイムゾーンで返されます。詳細なリファレンス：statable.com/docs/integrations/mcp。

書き込みツールが変更するのは設定（サイト、ゴール、ファネル、トラッキング機能、フィルター）のみです。データが削除されることはありません。

エージェントスキル

このリポジトリは Claude Code プラグインでもあります。ホスト型 MCP サーバー（.mcp.json、OAuth）に加え、3 つのスキルを備えています。

スキル	機能
statable	コードベースまたは稼働中のサイトを監査し、計測プラン（ゴール、ファネル、カスタムイベント、プロパティ、トラッカー機能）を提案します。承認後、コードと Statable アカウントに反映し、データが届いていることを確認します。明示的な承認なしに書き込みは行われません。
weekly-traffic-report	トラフィック、参照元、ゴールを簡潔にまとめた週次レポートを作成します。
traffic-drop-check	トラフィック減少の原因を特定します。

Claude Code の場合：

claude plugin marketplace add key-arg/skills
claude plugin install statable@statable

最初の Statable ツール呼び出し時に、サインインするためのブラウザーが開きます。エージェントがゴールやファネルを作成できるようにするには、同意画面で「Create and configure your sites」を許可してください。すでに claude mcp add statable ... でサーバーを追加している場合は、ツールが重複して表示されないよう削除してください。

Gemini CLI（gemini-extension.json 経由の MCP サーバーとスキル）：

gemini extensions install https://github.com/key-arg/statable-mcp

その他のエージェント（スキルのみ。上記の手順で MCP サーバーに接続してください）：

npx skills add key-arg/statable-mcp

次のように質問するか、/statable:statable を実行します：「このサイトでは何をトラッキングすべきですか？」

Configuration

Setting	Env	Flag	Default
API key	STATABLE_API_KEY	--api-key	none
Remote endpoint	STATABLE_MCP_URL	--url	https://mcp.statable.com/mcp

Without a key the server still starts and advertises its tools (so registries and hosts can inspect it), but every call returns a short message explaining how to add one.

Run from source

git clone https://github.com/key-arg/statable-mcp.git
cd statable-mcp
npm install
STATABLE_API_KEY=stbl_your_key npm test

Docker:

docker build -t statable-mcp .
docker run -i --rm -e STATABLE_API_KEY=stbl_your_key statable-mcp

About Statable

Statable is cookieless web analytics built for the EU: no consent banner needed for the core tracker, data hosted in the Netherlands, a tracker between 0.5 and 2 KB, goals, funnels, custom events, a public Stats API and this MCP server. Free tier for personal, educational and open-source sites.

Support: [email protected] · Registry: com.statable/analytics in the official MCP registry

MIT © Key Arg B.V.