weckr

@weckr/mcp

Weckr の AI コストと利益率のデータを、Claude、Cursor、またはその他の MCP 対応 AI アシスタントから直接照会できます。

ライブデモを試す

自分のデータを接続する前に、Weckr の様子をご確認ください。 👉 https://app.useweckr.com/demo

質問できること

次のような質問ができます。

• 「今月、どのユーザーが赤字の原因になっていますか？」
• 「現在の AI 利益率はいくらですか？」
• 「どの機能をより安価なモデルに切り替えるべきですか？」
• 「実際の AI コストを踏まえて、現在の価格設定は持続可能ですか？」
• 「機能ごとのコスト内訳を表示してください。」

Claude が Weckr API を呼び出し、会話の中でダッシュボードの実際の数値を提示します。

API キーを取得する

app.useweckr.com でサインアップしてください。プロジェクトを作成すると、wk_ キーが一度だけ表示されます。コピーしておいてください。キーを見逃した場合は、 app.useweckr.com/dashboard/projects/new で新しいプロジェクトを作成してください。

Claude Desktop

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

{
  "mcpServers": {
    "weckr": {
      "command": "npx",
      "args": ["-y", "@weckr/mcp"],
      "env": {
        "WECKR_API_KEY": "wk_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。次のように試してください。「Weckr ツールを使って、今月の AI コストを表示してください。」

npm install -g ではなく npx を使うのはなぜですか？ macOS では Claude Desktop は launchd の配下で実行されるため、対話型シェルの PATH を引き継ぎません。Node を nvm / asdf / volta 経由でインストールした場合、グローバルにインストールされた weckr-mcp バイナリは通常 Claude Desktop の PATH に含まれず、診断情報も表示されないままサーバーの起動に失敗します。npx -y @weckr/mcp を使えば、PATH の問題を完全に回避できます。

Cursor

プロジェクトのルートにある .cursor/mcp.json（グローバル設定の場合は ~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "weckr": {
      "command": "npx",
      "args": ["-y", "@weckr/mcp"],
      "env": {
        "WECKR_API_KEY": "wk_your_key_here"
      }
    }
  }
}

公開されるツール

ツール	質問例
get_overview	「今月の状況はどうですか？」合計コスト、収益、利益率、リクエスト数、赤字のユーザー数
get_users	「赤字のユーザーは誰ですか？」／「コスト上位のユーザーを表示してください。」ユーザーごとの利益率（絞り込み可能）
get_feature_breakdown	「最もコストがかかっている機能はどれですか？」機能ごとのコスト割合
get_model_recommendations	「AI コストを削減できるのはどこですか？」同じプロバイダー内での、より安価なモデルへの切り替えと節約額の見積もり
get_pricing_recommendations	「現在の価格設定は持続可能ですか？」プランごとの利益率の健全性と推奨価格
get_spending_cap_url	上限を編集するダッシュボードの URL を返します（状態は変更しません）

設定

環境変数	必須	デフォルト	備考
WECKR_API_KEY	はい	なし	app.useweckr.com で取得した wk_ キー
WECKR_PROJECT_ID	いいえ	/api/v1/me から解決	任意：プロジェクト UUID を事前に設定すると、起動時の往復通信を 1 回省略できます
WECKR_BASE_URL	いいえ	https://app.useweckr.com	セルフホスト版 Weckr の場合に上書きします。リクエストのたびに wk_ キーがここへ送信されるため、管理していないホストを設定しないでください。 https:// のみ使用できます（開発時はループバックに限り http:// も使用できます）。

仕組み

MCP サーバーは、AI クライアントによって起動される小さな stdio プロセスです。wk_ キーを使って Weckr HTTP API を呼び出します（サーバー間通信のため、JWT は不要です）。API キーによって 1 つのプロジェクトが確実に識別されます。サーバーは起動時に一度だけキーを使って projectId を解決し、その後のすべての呼び出しをそのプロジェクトに限定します。ダッシュボードのエンドポイント（/api/v1/stats、/users、/recommendations/*）は、URL のプロジェクト ID が API キーのプロジェクトと一致するかを検証し、一致しない場合は 404 を返します。そのため、API キーが漏洩しても、別のプロジェクトのデータを読み取ることはできません。

このパッケージは、プロンプトのテキストも補完のテキストもどこにも送信しません。ツールが読み取るのは集計済みの統計情報のみです。API キーがローカルプロセスの外に出ることはありません。ただし、WECKR_BASE_URL に設定された URL（デフォルトでは app.useweckr.com）への送信を除きます。WECKR_BASE_URL を変更すると、SDK は stderr に警告を出力するため、誤ったホストを指定したコピー＆ペースト設定を見つけることができます。

トラブルシューティング

Claude Desktop で weckr サーバーがエラーもなく切断済みと表示されます。 PATH の問題が考えられます。上記の npx -y @weckr/mcp 形式に切り替えてください。起動時の実際のエラーを確認するには、ターミナルでサーバーを手動で実行します。 WECKR_API_KEY=wk_... npx -y @weckr/mcp。問題があれば（API キーの不足、Weckr からの 401、ネットワークの問題など）、標準エラー出力に表示されます。

Weckr API 401 on /api/v1/me。 WECKR_API_KEY が空、形式が正しくない、無効化されている、または末尾にスペースが含まれています。動作するキーを確認するには、 app.useweckr.com/dashboard/projects/new にアクセスして、新しいプロジェクトを作成してください。

ツールに「Project not found or forbidden」（404）と表示されます。 WECKR_PROJECT_ID に、API キーが所有するプロジェクトに属していない UUID を設定しています。WECKR_PROJECT_ID を削除すると、サーバーが API キーから正しいプロジェクト ID を解決します。

ローカル開発

git clone https://github.com/Ghiles3232/weckr-sdks
cd weckr-sdks/mcp
npm install
npm run build

# Smoke-test against production:
WECKR_API_KEY=wk_... node dist/index.js
# (prints "weckr-mcp running on stdio" to stderr, then waits for JSON-RPC on stdin)

ローカルの Weckr バックエンドを指定するには：

WECKR_API_KEY=wk_... WECKR_BASE_URL=http://localhost:3000 node dist/index.js

ソース

オープンソースとして公開されています： github.com/Ghiles3232/weckr-sdks。

ライセンス

MIT