nable (finops-mcp)

Si finops setup no se auto-configura, ejecuta:

finops setup claude

O agrégalo manualmente a claude_desktop_config.json:

Con uvx (recomendado):

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

Con ruta absoluta:

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

Usa la ruta de which finops-mcp.

Ubicaciones de archivos de configuración:

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

¿Por qué uvx? Claude Desktop es una aplicación GUI y no hereda el PATH de tu shell. uvx ejecuta finops-mcp en su propio entorno aislado. Es la opción más confiable en máquinas corporativas con instalaciones de Python administradas.

nable no es solo herramientas que tu agente lee. Es una puerta previa a la acción que tu agente llama antes de hacer un cambio que afecte costos: calcula el precio del cambio, lo verifica contra tu presupuesto y ofrece un camino más barato. Nunca aplica nada por sí mismo. Solo propone: tu agente propone y un humano aprueba.

Agrega una línea al prompt del sistema de tu agente (Claude Code, Cursor o cualquier cliente MCP):

Antes de aplicar cualquier cambio de infraestructura (un terraform apply, un helm upgrade, crear o redimensionar un recurso) o iniciar un trabajo costoso, primero llama a check_action_policy con la acción y el cambio (un terraform plan, un helm diff o un monthly_delta_usd). Transmite el veredicto, el impacto en dólares y el camino más barato cuando se ofrezca. Nunca apliques una acción block o escalate; preséntala al humano. nable es consultivo y solo propone.

La puerta devuelve allow / warn / block / escalate contra tu política, el impacto mensual y anual en dólares, y una alternativa spot cuando el cambio es de cómputo. Las puertas de un solo sentido (eliminar, terminar, comprar un compromiso) y los cambios que exceden el presupuesto siempre escalan a un humano.

Y un presupuesto para el propio agente. Ejecuta nable ai-budget una vez; pregunta si estás en un plan fijo o en una API medida y cuánto pagas, y luego lo recuerda. En un plan fijo, rastrea cuánto cómputo subsidiado consumes por tu tarifa fija y advierte antes de que se agote; en uno medido, limita según un tope de gasto en dólares. check_ai_budget hace lo mismo para el agente a mitad de tarea. Lee tu uso de Claude Code localmente, sin subir nada. Agrega a tu prompt del sistema:

Antes de comenzar una tarea grande, llama a check_ai_budget. Si devuelve warn o over, dime dónde estoy antes de continuar.

Informa tu uso real y tu tasa de consumo contra tu presupuesto, no un porcentaje inventado de un límite de velocidad oculto del plan.

Roles de Azure. Las herramientas de Azure abarcan tres roles RBAC, otorgados a la entidad de servicio en cada suscripción (ejecuta 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>

¿Es nable gratis? Sí. El escaneo de terminal, cada consulta de costos, detección de anomalías, todos los hallazgos de desperdicio y redimensionamiento, y cada conector son gratis para siempre. El equipo de agentes, la creación automática de tickets, los resúmenes programados y las recomendaciones de compromiso son Pro.

¿Mis datos de facturación salen de mi máquina? No. nable es local-primero y de solo lectura por defecto. Lee tus datos de costos en tu máquina y nunca los sube, y puedes confirmar el comportamiento sin salida en el código fuente.

¿Qué nubes y proveedores soporta? AWS, Azure, GCP y Vertex; Kubernetes (Kubecost, OpenCost); proveedores de IA y LLM (OpenAI, Anthropic, Bedrock, OpenRouter, LiteLLM, Modal, Together, Replicate, Cohere, Mistral, Langfuse); plataformas de datos (Databricks, Snowflake, MongoDB); y SaaS (Datadog, New Relic, Cloudflare, Twilio, Vercel, Stripe).

¿En qué se diferencia de AWS Cost Explorer? Cost Explorer es solo de AWS y está limitado a la consola. nable es multi-nube, se ejecuta en tu terminal y en Claude/Cursor, cubre gastos de IA y GPU que ninguna consola de nube muestra, y propone correcciones como solicitudes de extracción. nable scan también hace cero llamadas de API de pago por defecto.

¿Existe una alternativa de código abierto a Vantage o CloudHealth? nable es una alternativa de código abierto (Apache-2.0), local-primero, para consultas de costos, detección de desperdicio, redimensionamiento y costos de IA/GPU, que se ejecuta en tu máquina en lugar de un SaaS alojado.

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