nable (finops-mcp)

Se o finops setup não configurar automaticamente, execute:

finops setup claude

Ou adicione manualmente ao claude_desktop_config.json:

Com uvx (recomendado):

{
  "mcpServers": {
    "nable": { "command": "uvx", "args": ["--python", "3.12", "finops-mcp"] }
  }
}

Com caminho absoluto:

{
  "mcpServers": {
    "nable": { "command": "/usr/local/bin/finops-mcp" }
  }
}

Use o caminho de which finops-mcp.

Locais dos arquivos de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Por que uvx? O Claude Desktop é um aplicativo GUI e não herda o PATH do seu shell. O uvx executa o finops-mcp em seu próprio ambiente isolado. É a opção mais confiável em máquinas corporativas com Python gerenciado.

O nable não é apenas ferramentas que seu agente lê. É uma barreira pré-ação que seu agente chama antes de fazer uma alteração que afete custos: ele precifica a alteração, verifica contra seu orçamento e oferece um caminho mais barato. Nunca aplica nada por conta própria. Somente proposta: seu agente propõe e um humano aprova.

Adicione uma linha ao prompt do sistema do seu agente (Claude Code, Cursor ou qualquer cliente MCP):

Antes de aplicar qualquer alteração de infraestrutura (um terraform apply, um helm upgrade, criar ou redimensionar um recurso) ou iniciar um trabalho caro, primeiro chame check_action_policy com a ação e a alteração (um terraform plan, um helm diff ou um monthly_delta_usd). Transmita o veredito, o impacto em dólares e o caminho mais barato quando oferecido. Nunca aplique uma ação block ou escalate; apresente ao humano. O nable é consultivo e somente proposta.

A barreira retorna allow / warn / block / escalate contra sua política, o impacto mensal e anual em dólares e uma alternativa spot quando a alteração é de computação. Portas de mão única (excluir, encerrar, comprar compromisso) e alterações acima do orçamento sempre escalam para um humano.

E um orçamento para o próprio agente. Execute nable ai-budget uma vez; ele pergunta se você está em um plano fixo ou em API medida e quanto paga, e depois lembra. Em um plano fixo, ele rastreia quanto de computação subsidiada você consome pela taxa fixa e avisa antes de ficar sem; em plano medido, ele limita com um teto de gastos em dólares. check_ai_budget faz o mesmo para o agente no meio da tarefa. Ele lê o uso do Claude Code localmente, nada é enviado. Adicione ao prompt do sistema:

Antes de iniciar uma tarefa grande, chame check_ai_budget. Se retornar warn ou over, me diga onde estou antes de continuar.

Ele reporta seu uso real e taxa de consumo contra seu orçamento, não uma porcentagem fabricada de um limite de taxa oculto do plano.

Funções do Azure. As ferramentas do Azure abrangem três funções RBAC, concedidas ao service principal em cada assinatura (execute finops doctor para verificar):

# repeat per subscription
az role assignment create --assignee <client-id> --role 'Cost Management Reader' --scope /subscriptions/<sub-id>
az role assignment create --assignee <client-id> --role Reader --scope /subscriptions/<sub-id>
az role assignment create --assignee <client-id> --role 'Monitoring Reader' --scope /subscriptions/<sub-id>

O nable é gratuito? Sim. A varredura no terminal, todas as consultas de custo, detecção de anomalias, todos os achados de desperdício e redimensionamento e todos os conectores são gratuitos para sempre. O agente em equipe, criação automática de tickets, resumos agendados e recomendações de compromisso são Pro.

Meus dados de faturamento saem da minha máquina? Não. O nable é local-first e somente leitura por padrão. Ele lê seus dados de custo na sua máquina e nunca os envia, e você pode confirmar o comportamento sem saída de dados no código-fonte.

Quais nuvens e provedores ele suporta? AWS, Azure, GCP e Vertex; Kubernetes (Kubecost, OpenCost); provedores de IA e LLM (OpenAI, Anthropic, Bedrock, OpenRouter, LiteLLM, Modal, Together, Replicate, Cohere, Mistral, Langfuse); plataformas de dados (Databricks, Snowflake, MongoDB); e SaaS (Datadog, New Relic, Cloudflare, Twilio, Vercel, Stripe).

Como é diferente do AWS Cost Explorer? O Cost Explorer é exclusivo da AWS e limitado ao console. O nable é multi-nuvem, roda no seu terminal e no Claude/Cursor, cobre gastos com IA e GPU que nenhum console de nuvem mostra e propõe correções como pull requests. nable scan também faz zero chamadas pagas de API por padrão.

Existe uma alternativa open-source ao Vantage ou CloudHealth? O nable é uma alternativa open-source (Apache-2.0), local-first, para consultas de custo, detecção de desperdício, redimensionamento e custo de IA/GPU, rodando na sua máquina em vez de um SaaS hospedado.

finops-doctor          # checks credentials, DB, network, audit log
finops setup claude    # re-run editor configuration only