Costory FinOps MCP: создайте FinOps-агента для Claude, Cursor или любой LLM

Costory — это слой данных о расходах для FinOps-агента. Он собирает и нормализует данные о расходах на облачные сервисы, Kubernetes, SaaS и AI

(AWS, GCP, Azure, Snowflake, Datadog, OpenAI, Anthropic), распределяет их между командами, продуктами и функциями,

а затем предоставляет через размещённый сервер Model Context Protocol. Claude, Cursor,

VS Code, Codex, Gemini CLI, Dust или ваш собственный агент исследует расходы, объясняет их и помогает оптимизировать с помощью

структурированных вызовов инструментов, а не необработанных строк биллинга.

Этот репозиторий содержит открытую часть проекта: навыки агента и упаковку плагинов для Claude Code, Codex и Cursor, которые помогают

агенту выполнять FinOps-сценарии с помощью инструментов Costory MCP.

Endpoint: https://app-api.costory.io/mcp (потоковый HTTP)
Аутентификация: OAuth 2.1 в браузере. Учётные данные IAM, Docker и локальный сервер не требуются
Документация: документация Costory
Название в реестре: io.costory/finops в официальном реестре MCP

Зачем FinOps-агенту нужен слой данных о расходах?

MCP-подключение к биллингу провайдера возвращает строки расходов для одного облака. Этого достаточно для одной учётной записи. В реальной инфраструктуре,

где используются несколько облаков, общие кластеры Kubernetes и много команд, агенту также нужно знать, кто отвечает за те или иные расходы, как распределяются

общие и неразмеченные затраты и что изменилось после роста счёта. Costory хранит этот контекст, поэтому агент сразу работает с распределёнными и сопоставленными данными.

О чём спрашивают инженеры

«Почему на прошлой неделе вырос счёт за AWS? С какими развёртываниями это совпало?»
«Покажи расходы на Kubernetes по пространствам имён и командам для кластера платежей».
«Каковы общие расходы на AI в OpenAI, Anthropic и Bedrock за этот месяц — с разбивкой по командам и моделям?»
«Распредели общие расходы на Cloud SQL между командами по объёму использования и опубликуй результат как измерение».
«Сколько стоит облачная инфраструктура в расчёте на активного пользователя в этом месяце по сравнению с прошлым?»
«Создай оповещение, если дневные расходы на BigQuery превысят $2,000, и отправляй его в канал Slack #finops».
«Отправляй пятёрку самых заметных изменений расходов в 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 с подключёнными данными биллинга. Доступен пробный период на 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

Сервер предоставляет инструменты пяти групп. Их названия и структура данных версионируются;

актуальная информация приведена в справочнике 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 доступно только сравнение периодов; вопросы об изменениях расходов передаются в Explain навыка `reports`
`virtual-dimensions`	Создание, редактирование, предварительный просмотр и публикация пользовательских осей расходов с упорядоченными правилами CEL
`dashboards`	Создание новых дашбордов и расширение существующих с наследованием виджетами контекста в первую очередь и формированием общего обзора
`reports`	Плановые отчёты в Slack, Teams и по электронной почте, а также DIGEST с предварительным просмотром для объяснения расходов за прошлый месяц
`recipes`	Готовые схемы учёта, подобранные под нужный результат; затем их настройка передаётся описанным выше навыкам

Сейчас рецепты охватывают маршрутизацию хранилища BigQuery, CUD на основе расходов в GCP, дашборды для сравнения бюджета с фактическими расходами, оповещения о скачках расходов на EC2, сравнение производственной среды с R&D, покрытие неразмеченных ресурсов, расходы на marketplace, кредиты провайдеров, расходы по пространствам имён, детализацию вычислительных расходов и объяснение изменений между периодами. См. plugins/costory/skills/recipes/.

Упаковка для Cursor Marketplace

Помимо marketplace для Claude Code, этот репозиторий содержит структуру плагина для Cursor:

.cursor-plugin/marketplace.json — манифест marketplace с несколькими плагинами
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): устанавливает семь навыков в 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.

Структура

Путь к SKILL.md .claude-plugin/marketplace.json server.json ← запись в официальном MCP Registry (io.costory/finops) gemini-extension.json + GEMINI.md ← расширение Gemini CLI (подключение MCP + контекст) powers/costory/ ← power для Kiro (plugin.json + mcp.json + skills/costory-finops) plugins/costory/ .claude-plugin/plugin.json .mcp.json ← MCP server, подключённый через плагин Claude Code / Codex README.md LICENSE ← Apache-2.0 (копия корневого 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 + библиотека рецептов">

.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

Предоставление skills через MCP (`get_skill`)

В файле skills.json каждому MCP skillId соответствует путь к файлу SKILL.md. При подключении costory-app загрузите файл из этого репозитория или из указанного релиза, удалите необязательный YAML frontmatter и верните содержимое в формате Markdown.

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

Создание skills

Правила структуры, обновления версий и проверки описаны в AGENTS.md. При добавлении skill используйте SKILL_TEMPLATE.md.

Поддержка

support@costory.io · Документация · Политика конфиденциальности · Условия использования

Лицензия

Apache-2.0. Подробнее см. LICENSE.