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
- Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
- 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).
- Ein Team-Admin dieses Teams, der den Schlüssel anlegt.
Verbinden
Schlüssel in Cursor anlegen
- Öffnen Sie im Cursor-Dashboard API Keys.
- Legen Sie einen Schlüssel mit einem Namen an, der seinen Zweck nennt, etwa
Costfluent. - Kopieren Sie den Schlüssel: Cursor zeigt ihn nur einmal an.
In Costfluent verbinden
- Öffnen Sie Einstellungen, dann Integrationen, wählen Sie Cursor und öffnen Sie den Tab Verbinden.
- 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.
- 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 Tagai:modeles so, wie sein Hersteller es nennt, undai:model_providerden Hersteller. - Die Belastungsbeschreibung nennt das Modell und die Belastungsart von Cursor,
Usage-basedoderIncluded in Business. - Tag
ai:userist die Cursor-ID des Mitglieds, etwauser_abc123. Ein Mitglied, das Cursor nicht mehr führt, trägt keinai:user. - Ressource ist das Dienstkonto hinter Anfragen, die ein Dienstkonto gestellt hat, und
Ressourcentyp ist
Service account; diese Anfragen tragen keinai: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 keinai: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.