MCP-Server
Einen KI-Assistenten wie Claude Code oder Cursor über den Costfluent-MCP-Server und ein API-Token mit Leserechten deine Kosten, Kostenberichte, Budgets und Anomalien lesen lassen.
Mit dem Costfluent-MCP-Server beantwortet ein KI-Assistent Fragen zu deinen Cloud-Ausgaben, ohne dass du die App öffnest. Er läuft auf deinem Rechner, spricht das Model Context Protocol über stdin und stdout mit dem Assistenten und ruft die Public API mit einem API-Token auf, das du ihm gibst. Er liest nur: Kein Tool erstellt, ändert oder löscht etwas.
Bevor du beginnst
Verfügbar im Starter-, Core-, Optimize- und Scale-Tarif. Tarife vergleichen
- Das Token zu erstellen erfordert die Organisationsrolle Eigentümer, Integrationsverantwortliche Person oder Bearbeiter; siehe API-Authentifizierung.
- Der Assistent muss lokale MCP-Server unterstützen, die als Befehl laufen, wie Claude Code, Claude Desktop und Cursor.
Token erstellen
- Öffne Einstellungen, dann API-Token, und wähle API-Token erstellen.
- Gib einen Name ein, der sagt, welcher Assistent das Token nutzt, etwa
Claude Code auf meinem Laptop. - Wähle unter Zugriff den Arbeitsbereich, in dem der Assistent arbeitet, damit das Token nichts anderes erreicht. Behalte Gesamte Organisation nur, wenn der Assistent Arbeitsbereiche vergleicht.
- Wähle unter Vorlage die Vorlage Nur lesen. Entferne jede Berechtigung, die der Assistent nicht braucht: Die Tools brauchen Arbeitsbereiche anzeigen, Kosten anzeigen, Kostenberichte anzeigen, Budgets anzeigen und Anomalien anzeigen.
- Wähle den Ablauf, etwa 90 Tage, und wähle API-Token erstellen.
- Kopiere das Token aus Ihr API-Token. Es wird nur einmal angezeigt.
Das Token steht im Klartext in der Konfigurationsdatei deines Assistenten. Gib ihm nur Leseberechtigungen und einen Ablauf, und widerrufe es unter API-Token, wenn du den Assistenten nicht mehr nutzt.
Server installieren
Lade das Archiv für deine Plattform aus dem neuesten Release herunter und lege costfluent-mcp in deinen PATH, oder baue ihn mit Go:
Code
Jedes Release trägt eine Build-Provenance-Attestierung, die gh attestation verify <archive> --repo costfluent/costfluent-mcp prüft.
Assistenten verbinden
Der Server liest COSTFLUENT_API_TOKEN, das Token, und optional COSTFLUENT_BASE_URL, das standardmäßig https://api.costfluent.com ist und https verwenden muss.
- Führe in Claude Code
claude mcp add costfluent --env COSTFLUENT_API_TOKEN=<token> -- costfluent-mcpaus. - Füge den Server in Claude Desktop, Cursor oder einem anderen Client mit einer
mcpServers-Datei wie unten hinzu. - Starte den Assistenten neu und stelle ihm eine Frage, etwa „Was haben wir letzten Monat für AWS ausgegeben, nach Service?".
Code
Tools
| Tool | Was es liest | Berechtigung |
|---|---|---|
list_workspaces | Die Arbeitsbereiche, die das Token lesen kann | Arbeitsbereiche anzeigen |
query_costs | Kosten, Nutzung oder Ressourcenanzahl über einen Zeitraum, je Tag, Woche, Monat oder Quartal, nach bis zu drei Dimensionen gruppiert und durch einen Kostenfilter eingegrenzt | Kosten anzeigen |
list_cost_reports | Die gespeicherten Kostenberichte eines Arbeitsbereichs | Kostenberichte anzeigen |
get_cost_report_data | Die Zahlen, die ein gespeicherter Bericht jetzt zeigt | Kosten anzeigen |
list_budgets | Budgets mit ihren aktuellen Ausgaben und ihrem Zustand | Budgets anzeigen |
list_anomalies | Erkannte Kostenanomalien, die neuesten zuerst | Anomalien anzeigen |
Wie es sich verhält
- Beim Start fragt der Server die API, welche Berechtigungen sein Token trägt, und bietet dem Assistenten nur die Tools an, die diese Berechtigungen erlauben. Ein Token, das die API ablehnt, beendet den Server mit dem Fehler der API.
- Arbeitsbereichs-Tools brauchen eine
workspace_idbei einem Organisations-Token; der Assistent findet die IDs mitlist_workspaces. Ein Workspace-Token liest seinen eigenen Arbeitsbereich, sofern nicht anders angegeben, und die API lehnt jeden anderen ab. - Lehnt die API einen Aufruf ab, erhält der Assistent den Fehler der API mit Status, Code und Detail und kann ihn erklären oder die Frage anpassen.
- Jeder Aufruf zählt gegen das Anfragelimit des Tokens. Der Server wartet ein kurzes Limit ab und gibt ein längeres an den Assistenten zurück.
- Der Server schreibt das Token nie in sein Log oder in ein Tool-Ergebnis; es reist nur im Anfrage-Header.