Quelle verbinden

Cursor verbinden

Fügen Sie einen Admin-API-Schlüssel Ihres Cursor-Teams ein, und Costfluent importiert seine täglichen nutzungsbasierten Ausgaben und Token nach Modell und Mitglied.

Costfluent liest Ihre Ausgaben für Cursor aus den Nutzungsereignissen des Teams, über die Admin API von Cursor, mit einem API-Schlüssel, den ein Team-Admin dafür anlegt. Eine Verbindung ist ein Cursor-Team, mit den Anfragen jedes seiner Mitglieder und Dienstkonten.

Wie Costfluent verbindet

Costfluent speichert den Schlüssel verschlüsselt und nutzt ihn nur für drei Abfragen: zu welchem Team der Schlüssel gehört, die Mitgliederliste des Teams und die Nutzungsereignisse des Teams, jeweils für einen UTC-Tag. Das Team wird zur Identität der Verbindung, und der Schlüssel wird nur für dieses Team verwendet.

Die Nutzungsereignisse von Cursor nennen ein Mitglied mit seiner E-Mail-Adresse. Costfluent ermittelt beim Lesen über die Mitgliederliste zu jeder Adresse die Cursor-ID des Mitglieds und behält nur die ID: Keine E-Mail-Adresse und kein Name eines Mitglieds wird gespeichert, protokolliert oder angezeigt.

Cursor dokumentiert die Admin API mit dem Bereich admin:*, der auch Mitglieder und Einstellungen des Teams ändern kann. Bietet Ihr Dashboard einen Schlüssel an, der nur lesen kann (read:*), legen Sie diesen an; in jedem Fall nur für Costfluent, damit Sie ihn widerrufen können, ohne etwas anderes zu berühren.

Voraussetzungen

  1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
  2. Ein Cursor-Team, dessen Plan die Admin API enthält. Cursor führt seine Admin API für Enterprise-Teams (Cursor APIs, gelesen am 2026-11-10).
  3. Ein Team-Admin dieses Teams, der den Schlüssel anlegt.

Verbinden

Schlüssel in Cursor anlegen

  1. Öffnen Sie im Cursor-Dashboard API Keys.
  2. Legen Sie einen Schlüssel mit einem Namen an, der seinen Zweck nennt, etwa Costfluent.
  3. Kopieren Sie den Schlüssel: Cursor zeigt ihn nur einmal an.

In Costfluent verbinden

  1. Öffnen Sie Einstellungen, dann Integrationen, wählen Sie Cursor und öffnen Sie den Tab Verbinden.
  2. Wählen Sie Admin-Schlüssel hinzufügen, übernehmen Sie unter Anzeigename den vorgeschlagenen Namen oder geben Sie einen eigenen ein und fügen Sie den Schlüssel in Admin-API-Schlüssel ein.
  3. Wählen Sie Verbindung testen, um jede Prüfung zu sehen, oder Verbinden, um zu speichern.

Costfluent liest das Team des Schlüssels und eine Seite seiner Nutzungsereignisse, bevor es etwas speichert. Eine Verbindung, die sich speichern lässt, kann also Ihre Ausgaben lesen. Ein Schlüssel eines Teams, das Ihre Organisation bereits verbunden hat, wird abgelehnt.

Daten und Aktualität

Beim Verbinden werden Kosten so weit zurück importiert, wie der rückwirkende Import Ihres Plans reicht, höchstens sechs Monate (Verbindungen verwalten), soweit Cursor so weit zurück Nutzungsereignisse meldet. Kosten kommen pro UTC-Tag in US-Dollar an: die Summe dessen, was Cursor für jedes Ereignis berechnet hat.

Sitzplatzgebühren stehen nicht in der Admin API von Cursor, deshalb erfasst Costfluent sie nicht. Senden Sie sie stattdessen an einen eigenen Anbieter (KI-Ausgaben aus jeder Quelle verfolgen). Anfragen, die Ihr Plan einschließt, erscheinen mit ihren Token und ohne Kosten.

Berichtsdimensionen

  • Dienst ist Cursor, in der Kategorie AI and Machine Learning.
  • SKU ist das Modell, wie Cursor es nennt, etwa claude-4.5-sonnet-thinking. Erkennt Costfluent das Modell, nennt Tag ai:model es so, wie sein Hersteller es nennt, und ai:model_provider den Hersteller.
  • Die Belastungsbeschreibung nennt das Modell und die Belastungsart von Cursor, Usage-based oder Included in Business.
  • Tag ai:user ist die Cursor-ID des Mitglieds, etwa user_abc123. Ein Mitglied, das Cursor nicht mehr führt, trägt kein ai:user.
  • Ressource ist das Dienstkonto hinter Anfragen, die ein Dienstkonto gestellt hat, und Ressourcentyp ist Service account; diese Anfragen tragen kein ai:user.
  • Nutzungseinheit ist Tokens: die Eingabe-, Ausgabe-, Cache-Schreib- und Cache-Lese-Token der Anfragen, zusammengezählt. Cursor berechnet pro Anfrage, nicht pro Token-Typ, deshalb tragen die Zeilen kein ai:token_type, und die Kosten pro Million Token sind ein Mischpreis über sie hinweg.
  • Das Rechnungskonto ist die Team-ID, und der Abrechnungszeitraum ist der Kalendermonat.

Aktualisieren oder trennen

Nach dem Verbinden

Der Tab Verwalten listet die Verbindung unter ihrem Anzeigenamen. Über das Zahnrad daneben sehen Sie, ob die Nutzungsereignisse noch lesbar sind, welche Workspaces die Verbindung speist und welche Monate importiert wurden. Prüfungen ausführen führt die Prüfungen auf Anfrage erneut aus.

Zugriff rotieren oder entfernen

Um den Schlüssel zu rotieren, legen Sie im selben Team einen neuen Schlüssel an, wählen Sie auf der Verbindungsseite Zugangsdaten aktualisieren und fügen Sie ihn ein; widerrufen Sie danach den alten Schlüssel im Cursor-Dashboard. Ein Schlüssel eines anderen Teams wird abgelehnt, weil die Historie der Verbindung zu ihrem Team gehört: Verbinden Sie dieses Team stattdessen als neue Verbindung.

Um die Verbindung aufzugeben, entfernen Sie sie in Costfluent und widerrufen Sie ihren Schlüssel im Cursor-Dashboard. Das Entfernen löscht die von ihr importierten Kosten (Verbindung entfernen).

Fehlerbehebung

  • Cursor refused this key. Die Meldung erscheint auch in der deutschen Oberfläche auf Englisch. Der Schlüssel wurde widerrufen oder ist kein API-Schlüssel des Teams. Ein Team-Admin legt ihn auf der Seite API Keys des Cursor-Dashboards an.
  • Cursor refused the usage events for this key. Der Plan des Teams enthält die Admin API vielleicht nicht, oder der Schlüssel gehört zu einem anderen Team. Verwenden Sie einen Schlüssel des Teams, dessen Ausgaben Sie sehen wollen.
  • The supplied Cursor team ID does not match the validated key. Erscheint beim Aktualisieren der Zugangsdaten. Verbinden Sie dieses Team als neue Verbindung.