Costory FinOps MCP

Costory FinOps MCP：Claude、Cursor、あらゆる MCP クライアントでチームの基盤となる FinOps エージェント

Costory は、チームの基盤となる FinOps エージェントです。Claude と単一プロバイダーの MCP の組み合わせは、一人で一つのクラウドを使う場合には機能します。しかし、プロバイダーやユーザーが増え、保守するツールが増えると対応しきれなくなります。

• 複数プロバイダー： AWS、GCP、Azure、LLM API、データクラウドのコストを一つのモデルで標準化し、チームや機能ごとに配賦します。テレメトリー（Kubernetes、Datadog、dbt）からの配賦にも対応します。
• 複数ユーザー： ユーザーごとのローカル認証情報やプロンプトではなく、OAuth、ユーザーごとのアクセス制御、エンタープライズ SSO を備えた一元管理の環境を利用できます。
• お客様に代わって保守： Costory がツール、スキル、コネクターを最新の状態に保つため、組織再編や新しいサービスの導入によってエージェントが動かなくなることはありません。

エージェントはコスト削減の機会を見つけ、支出の変化を一つひとつ説明し、コーディングエージェントが実装できる推奨事項を提示します。Claude、Cursor、あらゆる MCP クライアント、さらに Slack で利用できます。顧客には Alan、Deezer、Delivery Hero、Voodoo、Pennylane が含まれます。

料金： Starter は月額 300 ドルからの定額制です。ユーザー数とデータソース数は無制限で、80％のお客様が上限に達することのない公正な利用枠が設定されています。サービスが停止されることはなく、MCP 経由で接続されたエージェントは AI クレジットを消費しません。30 日間の無料トライアルをご利用いただけます。

このリポジトリで公開しているのは、Costory MCP ツールを使った FinOps ワークフローの実行方法をエージェントに教える、エージェントスキルとプラグインのパッケージ（Claude Code、Codex、Cursor）です。

• エンドポイント： https://app-api.costory.io/mcp（ストリーミング可能な HTTP）
• 認証： ブラウザーでの OAuth 2.1。IAM 認証情報、Docker、ローカルサーバーは不要です
• ドキュメント： docs.costory.io/features/mcp
• レジストリ名： 公式 MCP Registry の io.costory/finops

エンジニアからよく寄せられる質問

• 「先週、AWS の請求額が急増したのはなぜですか？関連するデプロイはどれですか？」
• 「payments クラスターの Kubernetes コストを、名前空間とチームごとに内訳表示してください。」
• 「今月の OpenAI、Anthropic、Bedrock の AI 支出合計を、チームとモデルごとに教えてください。」
• 「共有の Cloud SQL コストを使用量に応じてチーム間で按分し、ディメンションとして公開してください。」
• 「今月のアクティブユーザー 1 人あたりのクラウドコストはいくらですか？先月と比較してください。」
• 「BigQuery の日次コストが 2,000 ドルを超えたらアラートを作成し、#finops Slack チャンネルに投稿してください。」
• 「毎週月曜日に、コスト変動の大きい上位 5 件を Slack に送信してください。」

MCP に接続する

ワンクリックで https://app-api.costory.io/mcp を VS Code または Cursor に追加できます。初回利用時には、OAuth ログイン画面がブラウザーで開きます。 貼り付けて使う場合は、Cursor のディープリンクを利用できます：cursor://anysphere.cursor-deeplink/mcp/install?name=costory&config=eyJ1cmwiOiJodHRwczovL2FwcC1hcGkuY29zdG9yeS5pby9tY3AifQ%3D%3D

請求データが接続された Costory ワークスペースが必要です。Starter は月額 300 ドルからで、定額です。30 日間の無料トライアルをご利用いただけます。

Claude Desktop / Claude Code / Cursor / VS Code： https://app-api.costory.io/mcp を指定するカスタムコネクターを追加し、開いたブラウザーウィンドウで OAuth ログインを完了してください。スクリーンショット付きのクライアント別手順は、MCP ドキュメントをご覧ください。

このリポジトリには、コピーして使える .mcp.json が含まれています：

{
  "mcpServers": {
    "costory": {
      "type": "http",
      "url": "https://app-api.costory.io/mcp",
      "oauth": { "callbackPort": 8080 }
    }
  }
}

Claude Desktop（開発者設定、claude_desktop_config.json）については、代替 JSON 設定をご覧ください：

{
  "mcpServers": {
    "costory": {
      "url": "https://app-api.costory.io/mcp"
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "costory": {
      "type": "http",
      "url": "https://app-api.costory.io/mcp"
    }
  }
}

最初のプロンプト

「Costory を使って、先月のコスト要因の上位を表示して」と試してみてください。エージェントは get_context を呼び出し、次に query を呼び出します。

アカウントが複数の組織にアクセスできる場合、スラッグを指定せずに get_context を呼び出すと、スラッグの一覧とともに「Multiple organizations」が返されます。エージェントは list_organizations を呼び出す（またはその一覧を読み取る）必要があります。使用する組織を尋ね、その slug を get_context と以降のツールに渡してください。最初に「Costory の組織 acme を使って、先月のコスト要因の上位を表示して」のように指定することもできます。

MCP ツールのリファレンス

サーバーは 5 つのグループに分かれたツールを公開します。名前とペイロードにはバージョンが付けられています。正確な情報は API リファレンスをご確認ください。

グループ	ツール	機能
概要	get_context, search, get, suggest_groupby, suggest_usage_metrics, suggest_actions	ディメンション、ダッシュボード、メトリクスを確認し、質問を適切に切り分ける方法を見つけます
クエリ	query, list_metrics, list_virtual_dimensions	期間比較を含む、コスト、使用量、メトリクス、数式、予算のクエリ
割り当て	create_virtual_dimension_draft, update_virtual_dimension_draft, preview_virtual_dimension_draft, publish_virtual_dimension, virtual_dimension_overlap_matrix	順序付き CEL ルールでカスタムのコスト軸を定義し、プレビューしてから公開します
レポート	create_report, update_report, preview_report_widget, run_report_now, create_dashboard, update_dashboard	チャットから作成する、Slack、Teams、メールのスケジュールレポートとダッシュボード
アラートとイベント	create_alert, preview_alert, list_alerts, create_event, update_event	コストと予算のアラート、および相関分析用のイベント注釈

書き込みツールは、Costory ワークスペース内でのみ動作します。クエリのスコープは、呼び出し元ユーザーのワークスペースロールに従います。

FinOps スキル

スキルはワークフローレイヤーです。それぞれのスキルは、特定の種類の質問に対して上記のツールをどのような順序で使うかを定義しているため、アシスタントがその手順を再発見する必要はありません。

MCP skillId	使用する場面
bigquery	BigQuery ウェアハウスに関する注意点（オンデマンドとスロット、物理と論理、ラベル）と、[BigQuery] ダッシュボードテンプレート
cost-change-investigation	コストの変化を、寄与度、タイミング、使用状況、メトリクス、イベント、アラート、用語の根拠を使って説明する場合
query	コスト、使用状況、メトリクス、数式、予算の調査。Explorer では期間比較のみを行い、「何が変わったか」の説明は reports の Explain に引き継ぎます
virtual-dimensions	順序付きの CEL ルールを使って、カスタムのコスト軸を作成、編集、プレビュー、公開する場合
dashboards	コンテキスト優先のウィジェット継承と概要の生成を使って、ダッシュボードを作成または拡張する場合
reports	Slack、Teams、メールの定期レポート、および先月のコストを説明するためのプレビュー優先 DIGEST
recipes	目的に合ったすぐに使える追跡設計を選び、上記のスキルに引き継いで構築する場合

レシピでは現在、BigQuery ウェアハウスのルーティング、GCP の支出ベース CUD、予算対実績のダッシュボード、EC2 スパイクアラート、本番環境と研究開発の分割、タグ未設定のカバレッジ、マーケットプレイスの支出、プロバイダーのクレジット、名前空間のコスト、コンピューティングの詳細分析、期間変化の説明を扱っています。plugins/costory/skills/recipes/ を参照してください。

Cursor Marketplace のパッケージ

このリポジトリには、Claude Code マーケットプレイスに加えて、Cursor プラグインの構成も含まれています。

• .cursor-plugin/marketplace.json — 複数プラグイン対応のマーケットプレイスマニフェスト
• plugins/costory/.cursor-plugin/plugin.json — Cursor プラグインのマニフェスト
• plugins/costory/mcp.json — ホスト型 MCP（https://app-api.costory.io/mcp、クライアントで OAuth を使用）
• plugins/costory/assets/logo.png — プラグインのロゴ

cursor.directory/plugins/costory に掲載されています。

プラグインとしてインストール（MCP 接続＋スキル）

このプラグインは、MCP サーバーを接続し、スキルを一度にインストールします。

# Claude Code
claude plugin marketplace add costory-io/costory-finops-mcp-skills
claude plugin install costory@costory

# Codex
codex plugin marketplace add costory-io/costory-finops-mcp-skills
codex plugin add costory@costory

スキルのみ、任意のエージェント（skills.sh）： 7 つのスキルを Claude Code、Cursor、Codex など、Agent Skills を読み込む他のエージェントにインストールします。MCP は別途接続してください（上記を参照）。

npx skills add costory-io/costory-finops-mcp-skills

Kiro： このリポジトリにはKiro power（MCP 接続＋FinOps スキル）が含まれています。Kiro で Powers パネルを開き、Add Custom Power → Import power from GitHub を選択して、https://github.com/costory-io/costory-finops-mcp-skills/tree/main/powers/costory を入力してください。

構成

.mcp.json                              ← ready-to-copy MCP client config
skills.json                            ← MCP skillId -> SKILL.md path
.claude-plugin/marketplace.json
server.json                            ← official MCP Registry entry (io.costory/finops)
gemini-extension.json + GEMINI.md      ← Gemini CLI extension (MCP connection + context)
powers/costory/                        ← Kiro power (plugin.json + mcp.json + skills/costory-finops)
plugins/costory/
  .claude-plugin/plugin.json
  .mcp.json                            ← MCP server wired by the Claude Code / Codex plugin
  README.md
  LICENSE                              ← Apache-2.0 (copy of the root LICENSE)
  skills/
    bigquery/SKILL.md
    cost-change-investigation/SKILL.md
    query/SKILL.md
    virtual-dimensions/SKILL.md
    dashboards/SKILL.md
    reports/SKILL.md
    recipes/SKILL.md  + recipe library

MCP 経由でのスキル提供（get_skill）

skills.json は、各 MCP skillId を SKILL.md のパスに対応付けています。costory-app を接続する際は、このリポジトリ（または固定したリリース）からファイルを読み込み、任意の YAML フロントマターを削除して、Markdown 本文を返してください。

{
  "skillId": "dashboards",
  "path": "plugins/costory/skills/dashboards/SKILL.md"
}

作成

構成ルール、バージョン更新、検証については AGENTS.md を参照してください。スキルを追加する場合は SKILL_TEMPLATE.md を使用してください。

サポート

[email protected] · ドキュメント · プライバシーポリシー · 利用規約

ライセンス

Apache-2.0。詳しくは LICENSE を参照してください。