Clés API et assistants IA (MCP)
Create API keys and connect Claude Desktop, Cursor or Claude Code to your cost data.
Clés API et assistants IA (MCP)
Créez une clé pour qu'un assistant IA tel que Claude Desktop, Cursor, Claude Code ou Windsurf puisse poser des questions à CostGlass sur vos coûts cloud.
- Une clé API est un secret qui permet à un programme d'agir comme la personne qui l'a créé. Cela commence par cg_live_.
- La clé complète est affichée une fois, lorsque vous la créez. CostGlass stocke uniquement une empreinte digitale, donc une clé perdue ne peut pas être récupérée ; révoquez-le et créez-en un nouveau.
- The page offers one scope, read, but see the warning below: a key acts with its creator's role.
- La connexion MCP (Model Context Protocol) offre à un assistant IA sept outils en lecture seule, deux ressources et deux invites prêtes à l'emploi.
- Vous êtes propriétaire ou administrateur.
- Certaines données de coûts sont déjà connectées, sinon l'assistant n'a rien à répondre.
- Un assistant IA qui prend en charge les serveurs MCP.
Créer une clé
Révoquer une clé
In the key's row use the revoke action and confirm. La clé cesse immédiatement de fonctionner pour tout ce qui l'utilise et disparaît de la liste. Révoquez une clé lorsqu'un ordinateur portable est perdu, qu'une personne part ou que vous ne savez pas qui l'a vu. Seuls les propriétaires et les administrateurs peuvent révoquer.
Ce qu'une clé peut faire (lire ceci)
- Le champ scope est stocké, mais aujourd’hui il n’est pas appliqué par le serveur. Une clé agit avec le rôle de celui qui l'a créé, sur l'ensemble de l'API CostGlass, et pas seulement sur les outils d'assistance. Si un propriétaire le crée, il dispose des droits de propriétaire.
- Une clé est non restreint par la portée hiérarchique. Les outils d'assistance lisent toute l'organisation même si le créateur est limité à un seul nœud.
- Si le créateur est supprimé ou désactivé, la clé cesse de fonctionner.
Bonne pratique
- Créez des clés pour une personne dédiée et la moins privilégiée lorsque cela est possible (un membre qui n'est pas concerné), et non pour un propriétaire.
- Utilisez des expirations courtes et une clé par outil ou machine, afin de pouvoir en révoquer une sans affecter le reste.
- Ne collez jamais de clé dans le chat, les tickets ou le contrôle de source. Keep it in the assistant's environment settings.
- Vérifiez régulièrement la dernière utilisation et révoquez les clés que vous ne reconnaissez pas.
- N'oubliez pas que ce que lit l'assistant est envoyé au fournisseur d'IA qui exécute l'assistant. Connectez uniquement les assistants approuvés par votre entreprise.
Connectez votre assistant
Remplacez l'espace réservé à la clé par votre clé. 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 et Cursor (serveur local)
Add this to claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor). Le chemin pointe vers le script du serveur CostGlass MCP que vous avez installé.
Claude Code
Connexion à distance (pas d'installation locale)
Pour les assistants pouvant communiquer avec un serveur MCP distant via HTTP :
Redémarrez l'assistant. Demandez-lui : "Quels ont été nos cinq principaux dépensiers dans le cloud ce mois-ci ?" à tester.
Ce que l'assistant peut utiliser
| Outil | Ce que ça fait |
|---|---|
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 et 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). Tous ces éléments ne lisent que des données. Ils ne changent rien dans CostGlass ou dans vos cloud.