Claves API y asistentes de IA (MCP)
Create API keys and connect Claude Desktop, Cursor or Claude Code to your cost data.
Claves API y asistentes de IA (MCP)
Cree una clave para que un asistente de IA, como Claude Desktop, Cursor, Claude Code o Windsurf, pueda hacer preguntas a CostGlass sobre sus costos de nube.
- Una clave API es un secreto que permite a un programa actuar como la persona que lo creó. Comienza con cg_live_.
- La clave completa se muestra una vez, cuando la creas. CostGlass almacena sólo una huella digital, por lo que una clave perdida no se puede recuperar; revocarlo y hacer uno nuevo.
- The page offers one scope, read, but see the warning below: a key acts with its creator's role.
- La conexión MCP (Protocolo de contexto modelo) le brinda a un asistente de inteligencia artificial siete herramientas de solo lectura, dos recursos y dos indicaciones listas para usar.
- Eres propietario o administrador.
- Algunos datos de costes ya están conectados; de lo contrario, el asistente no tendrá nada que responder.
- Un asistente de IA que admite servidores MCP.
Crear una clave
Revocar una clave
In the key's row use the revoke action and confirm. La clave deja de funcionar inmediatamente para todo lo que la usa y desaparece de la lista. Revocar una clave cuando se pierde una computadora portátil, una persona se va o no está seguro de quién la vio. Sólo los propietarios y administradores pueden revocar.
Qué puede hacer una llave (lea esto)
- El campo de alcance se almacena, pero actualmente el servidor no lo aplica. Una clave actúa con el papel de la persona que lo creó, en toda la API de CostGlass, no solo en las herramientas asistentes. Si un Propietario lo crea, tiene derechos de Propietario.
- Una clave es no restringido por el alcance de la jerarquía. Las herramientas asistentes leen toda la organización incluso si el creador está limitado a un nodo.
- Si el creador es eliminado o deshabilitado, la clave deja de funcionar.
Buenas prácticas
- Cree claves para una persona dedicada y con menos privilegios siempre que sea posible (un miembro que no esté dentro del ámbito), no un propietario.
- Utiliza caducidad corta y una clave por herramienta o máquina, así podrás revocar una sin afectar al resto.
- Nunca pegues una clave en el chat, tickets o control de fuente. Keep it in the assistant's environment settings.
- Verifique el último uso con regularidad y revoque las claves que no reconozca.
- Recuerde que lo que lee el asistente se envía al proveedor de IA que ejecuta el asistente. Conecte solo los asistentes que su empresa haya aprobado.
Conecta tu asistente
Reemplace el marcador de posición de clave con su clave. The API address below is the UK region's. If your organisation is in another region, use your region's API address instead; ask support if you are unsure.
Claude Desktop y Cursor (servidor local)
Add this to claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor). La ruta apunta al script del servidor CostGlass MCP que ha instalado.
Código Claude
Conexión remota (sin instalación local)
Para asistentes que pueden comunicarse con un servidor MCP remoto a través de HTTP:
Reinicie el asistente. Pregúntele: "¿Cuáles fueron nuestros cinco principales gastadores en la nube este mes?" para probar.
Qué puede utilizar el asistente
| Herramienta | que hace |
|---|---|
costglass_query_costs | Spend grouped by service, region or account, over a time range (for example current month, last 30 days, year to date), daily or monthly, with optional filters and cost basis (unblended or amortized). The provider filter accepts aws, azure and gcp. |
costglass_get_anomalies | Cost anomalies, filterable by status, severity and provider. |
costglass_get_savings_recommendations | Savings opportunities, optionally above a minimum monthly saving. |
costglass_get_kubernetes_costs | Kubernetes cluster spend, namespace allocation, idle capacity and pod rightsizing. |
costglass_get_budgets | Budgets, limits and current spend. |
costglass_get_connected_accounts | Connected accounts and their sync status. |
costglass_get_cost_filters | The services, regions, accounts and tag dimensions that exist, so the assistant uses valid names. |
Two resources are available, costglass://summary/current-month y costglass://anomalies/active, and two prompts: /finops_audit (a broad review of spend, anomalies and waste) and /investigate_cost_spike (step-by-step triage of a sudden rise). Todos estos solo leen datos. No cambian nada en CostGlass ni en tus nubes.