# Stripe Projects-CLI Nehmen Sie Dienstleistungen von Drittanbietern in Ihre App auf, synchronisieren Sie Zugangsdaten mit Ihrem Projekt und verwalten Sie Upgrades. Weitere Informationen finden Sie im [Referenzdokument für das Stripe CLI](https://docs.stripe.com/cli.md). Stripe Projects stellt Dienstleistungen von Drittanbietern (wie Hosting, Datenbanken, Autorisierung, KI und Beobachtbarkeit) über das Datenterminal bereit und verwaltet diese. Führen Sie einen Befehl aus, um Ihre Konten zu erstellen, Anmeldeinformationen mit Ihrer `.env` zu synchronisieren und die Abrechnung über Stripe abzuwickeln. - **Sorgen Sie für die Bereitstellung** von Diensten von [über 60 Anbietern](https://docs.stripe.com/projects.md#available-providers). Keine separaten Dashboards. - **Synchronisieren Sie** Anmeldeinformationen automatisch mit der `.env`. Kein Kopieren und Einfügen von API-Schlüsseln erforderlich. - **Verwalten Sie** Pläne, die Abrechnung, Umgebungen und Schlüssel über die CLI oder Ihren Coding Agent. ## Mit einem Coding Agent beginnen Installieren Sie die Fähigkeit Stripe Projects in Claude Code, Cursor, Codex oder einem beliebigen MCP-kompatiblen Coding Agent: ```bash npx skills add https://docs.stripe.com --skill stripe-projects -g -y ``` Beschreiben Sie dann den gewünschten Stack für Ihren Agent: ``` "Use Stripe Projects to set up a Next.js app with Supabase, Vercel, and PostHog." ``` Der Agent installiert das CLI-Plug-in, führt `stripe projects init` aus, fügt Ihre Dienste hinzu und synchronisiert die Anmeldeinformationen automatisch. ## Quickstart Installieren Sie das Plug-in, erstellen Sie ein Projekt, fügen Sie Dienste hinzu und übertragen Sie Anmeldeinformationen in Ihre lokale Umgebung: ```bash stripe plugin install projects stripe projects init stripe projects add supabase/project stripe projects add vercel/project stripe projects env --pull ``` ## Funktionsweise Ein Stripe-Projekt stellt eine einzelne Anwendung oder Codebasis dar und gruppiert die Dienste und Ressourcen eines Anbieterkontos. - **Anbieter-Konto**: Das Konto bei Ihrem Anbieter, wie Vercel, Supabase, Clerk oder PostHog. - **Service**: Das Produktangebot des Anbieters, wie Datenbank, Autorisierung oder Analyse. - **Ressource**: Eine Instanz des Dienstes für Ihr Konto sowie die zugehörigen Anmeldeinformationen und Umgebungsvariablen (z. B. `test-db-1`, `auth` oder `test-analytics-1`). Sie können ein Projekt nutzen, um: - Fügen Sie ein bestehendes Anbieterkonto hinzu oder erstellen Sie ein neues - Bereitstellung von Ressourcen wie Datenbanken, Autorisierungsinstanzen und Analyseprojekten - Speichere Zugangsdaten im Tresor und synchronisiere sie mit deiner Umgebung :(`.env`) als Umweltvariablen - Verwalten Sie benannte Umgebungen wie `development`, `staging` und `production`, jeweils mit einer eigenen Ausgabedatei und Gruppe von Ressourcen. - Verwaltung von Upgrades und rotierende Zugangsdaten Nachdem Sie ein Anbieterkonto mit Ihrem Stripe-Konto verknüpft haben, bleibt es autorisiert, bis Sie die Verknüpfung ausdrücklich entfernen. Sie können ein Anbieterkonto für neue Projekte mit dem gleichen Stripe-Konto wiederverwenden. Wenn Sie ein anderes Stripe-Konto verwenden möchten, müssen Sie das Anbieterkonto erneut verknüpfen. Sie können ein Projekt in einem neuen Verzeichnis oder einer bestehenden Codebasis initialisieren. Wenn Sie eine bestehende Codebasis verwenden und Dienste hinzufügen, werden neue Anmeldeinformationen und Umgebungsvariablen in Ihre bestehende Umgebung (`.env`) und Projektkonfiguration integriert. ## Funktionsweise von Anmeldedaten Stripe Projects ruft in Ihrem Namen Anmeldedaten von jedem Anbieter ab, verschlüsselt sie in `.projects/vault/vault.json` und speichert sie im Stripe [Secret Store](https://docs.stripe.com/stripe-apps/store-secrets.md): - **Lokale Dateien**: `.projects/vault/vault.json` speichert eine verschlüsselte Kopie Ihrer Anmeldeinformationen. Ihre `.env` ist die Standardausgabe für die lokale Entwicklung. Für benannte Umgebungen schreibt die CLI in die konfigurierte Ausgabedatei, wie z. B. `.env.dev` oder `.env.production`. Die CLI erstellt Ausgabedateien mit den Berechtigungen `600`, sodass nur Sie diese auf Ihrem Computer lesen können. Übergeben Sie keine Dateien mit Anmeldeinformationen an die Versionskontrolle – `stripe projects init` fügt diese automatisch zu `.gitignore` hinzu. - **Beim Entfernen**: Bei der Ausführung von `stripe projects remove ` wird die Ressource aufgehoben und aus Ihrem Projektstatus entfernt. Die CLI löscht keine Anmeldedaten, die zuvor in `.env` oder `.projects/vault/` geschrieben wurden. Entfernen Sie diese manuell oder führen Sie `stripe projects env --pull` aus, um sie mit dem aktuellen Anmeldedatensatz zu überschreiben. Informationen zur Verwendung Ihrer Anmeldedaten in einer Produktionshosting-Umgebung finden Sie unter [Produktionsumgebungsvariablen einrichten](https://docs.stripe.com/projects.md#production-env). ## Erstellen Sie ein Projekt Führen Sie `init` in dem Verzeichnis aus, das Sie für Ihr Projekt verwenden möchten: ```bash stripe projects init [name] ``` Dadurch wird ein Stripe-Projekt für dieses Verzeichnis initialisiert. Wenn du den Namen weglässt, verwendet Stripe Projects den Ordnernamen. Stripe Projects schreibt den Projektzustand unter `.projekte/`, wo die zugehörigen Anbieterkonten, bereitgestellten Ressourcen und die lokale Projektkonfiguration verfolgt werden. Sie können die Werkzeuge sehen, die Ihr Projekt in `.projekte/state.json` nutzt. Die Datei `.projekte/state.local.json` in Ihrem privaten Repository enthält die Ressourcen-IDs, die dein Team benötigt, um denselben Projektstatus zu teilen. ### Dateireferenz | Datei oder Ordner | Zweck | Zur Versionskontrolle verpflichten? | | --- | --- | --- | | `state.json` | Gemeinsamer Projektstatus für die Dienste, Ressourcen, Umgebungsdefinitionen, Ausgabedateipfade und die Konfiguration, die Ihr Team nutzt. | Ja | | `state.local.json` | Ihre lokalen Überschreibungen und gerätespezifischen Einstellungen. Speichert Zuordnungen zwischen Projektressourcen und Ihren persönlichen Anbieterkonten, Backend-Ressourcen-IDs und der aktiven Umgebung, die auf diesem Gerät ausgewählt ist. | Ja1 | | `.projects/vault/` | Verschlüsselter Anmeldedaten-Cache, der von der CLI nach der Bereitstellung oder `env --pull` geschrieben wurde. | Nein, automatisch zu `.gitignore` hinzugefügt2 | | `.projects/cache/` | CLI-Metadaten-Cache, der für die Leistung verwendet wird. | Nein, automatisch zu `.gitignore` hinzugefügt | | `.env`, `.env.*` | Klartext-Anmeldeinformationen für die lokale Entwicklung, die von `env --pull` für die aktive Umgebung geschrieben werden. | Nein, automatisch zu `.gitignore` hinzugefügt | 1 Trotz der Benennungskonvention `.local` übergeben Sie weiterhin `state.local.json`. Es speichert die Zuordnungen zwischen Ihren Projektressourcen und Ihren persönlichen Anbieterkonten. Ihre Teammitglieder benötigen diese Datei, um ihre eigenen Konten korrekt mit `stripe projects link` zu verknüpfen. Wenn Sie sie von der Versionskontrolle ausschließen, erhalten Ihre Teammitglieder eine Fehlermeldung, wenn sie versuchen, eine Verknüpfung herzustellen. Die aktive Umgebung ist lokal für jeden Bezahlvorgang eines Teammitglieder. Ein Wechsel der Umgebungen ändert daher die aktive Umgebung für andere Teammitglieder nicht. 2 Dies ist ein lokaler Anmeldedaten-Cache, kein gemeinsam genutztes Geheimschlüsselverteilungssystem. Jedes Teammitglied führt `stripe projects env --pull` auf seinem eigenen Computer aus, um seine eigenen Anmeldedaten aus dem Stripe Secret Store abzurufen. ## Verwenden Sie einen Codierungsagenten Nachdem Sie ein Projekt initialisiert haben, schreibt Stripe Projects die Coding-Agent-Fähigkeiten in das lokale Projektverzeichnis. Diese Fähigkeiten bieten Kontext und Handlungen, damit Ihr Agent über den Workflow von Stripe Projects in Ihr Projekt eingebunden werden kann. Anschließend können Sie Ihren Agent auffordern, Aufgaben zu erledigen, wie etwa die folgenden: - “Mein bestehendes Neon-Konto verknüpfen und eine Datenbank bereitstellen.” - „Füge Turso-Authentifizierung und PostHog auf der kostenlosen Stufe hinzu.“ - „Richte die Dienste ein, die dieses Repository braucht, und erkläre, was sich geändert hat.“ Ihr Agent verwendet die gleichen Stripe Projects-CLI-Befehle. Sie können Anmeldeinformationen bereitstellen, aktualisieren, konfigurieren und synchronisieren, indem Sie den gleichen deterministischen, auditierbaren Pfad verwenden wie die CLI direkt. Um Browser-Pop-ups während der Bereitstellung und des Austauschs von Anmeldeinformationen zu vermeiden, gehen Sie wie folgt vor: 1. Melden Sie sich bei Ihrem Stripe-Konto an. 2. Verknüpfe dein bestehendes Anbieterkonto (oder erstelle ein neues) mit einem `Link zu Stripe-Projekten`. 3. Fügen Sie mit `Abrechnung für Stripe-Projekte hinzufügen` eine Zahlungsmethode hinzu. 4. Beginnen Sie mit der Agentensitzung. ## Aus einer Vorlage erstellen Verwenden Sie `stripe projects build`, um eine vollständige Starter-App aus dem Vorlagenverzeichnis zu erstellen. Die CLI kopiert die App-Dateien, installiert Abhängigkeiten und stellt alle erforderlichen Dienste in einem Schritt bereit. Führen Sie den Befehl interaktiv aus. Die CLI führt Sie durch die Auswahl einer App-Kategorie, eines Frameworks und einer Traffic-Stufe und stellt dann den empfohlenen Stack bereit: ```bash stripe projects build my-app ``` Wenn Sie bereits wissen, welche Vorlage Sie möchten, überspringen Sie den geführten Ablauf mit `--template`: ```bash stripe projects build my-app --template stripe/nextjs-saas/amber-fox ``` Geben Sie nur die Vorlagen-ID ohne eine Variante an, um die Standardvariante zu verwenden: ```bash stripe projects build my-app --template stripe/nextjs-saas ``` Um eine vollständige Liste aller verfügbaren Vorlagen zu sehen, sehen Sie sich das [Vorlagenverzeichnis](https://github.com/stripe/projects-template-registry) an. Um Ihre eigene Vorlage zu erstellen, lesen Sie [Eine Build-Vorlage erstellen](https://docs.stripe.com/projects/templates.md). ## Prüfen Sie den Status des Projekts Führen Sie, nachdem Sie Dienste oder verbundene Anbieter hinzugefügt haben, `status` aus, um Ihr Projekt zu überprüfen: ```bash stripe projects status ``` Hier werden Ihr Projektname, Ihr Stripe-Konto, zugehörige Anbieterkonten, bereitgestellte Ressourcen, aktuelle Stufen und der Zustandsscore angezeigt. Für Projekte mit benannten Umgebungen zeigt `status` auch die Umgebungszugehörigkeit an und markiert die aktive Umgebung für diesen Bezahlvorgang. ## Projekte auflisten Verwenden Sie `Stripe projects list`, um alle Projekte in Ihrem Stripe-Konto anzuzeigen. ```bash stripe projects list ``` Der Befehl gibt den Namen, die ID und das Erstellungsdatum jedes Projekts zurück. Verwenden Sie die Projekt-ID mit dem Befehl `stripe projects pull`. ## Ein Projekt einrichten Verwenden Sie den Befehl `stripe projects pull`, um ein bestehendes Projekt in einem neuen lokalen Verzeichnis einzurichten. Führen Sie den Befehl in einem leeren Verzeichnis aus: ```bash stripe projects pull ``` Der Befehl erstellt die Dateien `.projects/state.json` und `.projects/state.local.json` und schreibt anschließend Ihre `.env`-Datei, indem er den Befehl`env --pull` ausführt. Er verbindet Sie mit den vorhandenen Service-Instanzen des Projekts – es werden keine neuen bereitgestellt. Um eine Projekt-ID zu ermitteln, führen Sie den Befehl `stripe projects list` aus. ## Integrieren Sie Projekte in Ihren Arbeitsablauf Sie können Stripe Projects für neue Apps, bestehende Codebasen und aktive Setups verwenden. ### Ein neues Projekt starten Wenn Sie eine neue App haben, können Sie ein Projekt erstellen, Associate-Provider-Konten erstellen oder neue erstellen und Ressourcen bereitstellen, wie Datenbank, Autorisierungen und Analysen. ### Dienste zu einer bestehenden Codebasis hinzufügen Sie können Stripe-Projekte in einem bestehenden Anwendungsverzeichnis initialisieren. Wenn Sie ein bestehendes Verzeichnis verwenden und Dienste hinzufügen, werden neue Zugangsdaten und Umgebungsvariablen in Ihre bestehende Umgebung (`.env`) und Projektkonfiguration integriert. Dies ist nützlich, wenn eine App bereits über ein Hosting verfügt, aber Dienste wie eine Datenbank, Authentifizierung, Analysen, Feature-Flags oder andere verwaltete Infrastrukturelemente benötigt. ### Verwaltung eines bestehenden Setups Wenn Sie die bereits genutzten Provider-Konten mit Ihrem Stripe-Konto verknüpfen, wird das Projekt an einem einzigen Ort dargestellt. Das ermöglicht es Ihnen auch, bestehende Ressourcen zuzuordnen und relevante Umgebungsvariablen hinzuzufügen. ## Durchsuchen Sie den Dienstkatalog Verwenden Sie `catalog`, um alle verfügbaren Anbieter, ihre Dienstkategorien, Planstufen, Add-ons und Preise aufzulisten: ```bash stripe projects catalog stripe projects catalog stripe projects catalog ``` Verwenden Sie `search`, um alle verfügbaren Anbieterdienste zu einem Stichwort zu erkunden: ```bash stripe projects search ``` ## Einen Dienst verwalten ### Einen Dienst hinzufügen Fügen Sie Ihrem Projekt einen Anbieterdienst hinzu: ```bash stripe projects add / ``` Wenn Sie einen Dienst hinzufügen, verknüpft diese Aktion ein bestehendes Anbieterkonto mit Ihrem Stripe-Konto oder erstellt eines, bevor der Dienst hinzugefügt wird. Das Hinzufügen eines Dienstes stellt eine Ressource in Ihrem Provider-Konto bereit. Verwenden Sie den Befehl `Hinzufügen` zur Bereitstellung einer Datenbank, einer Authentifizierungsinstanz, eines Analyseprojekts, von Feature-Flags oder einer anderen verwalteten Infrastruktur für Ihre App. ### Einen Anbieter mit dem Link-Befehl verknüpfen Einen Anbieter-Account verknüpfen oder ein Konto erstellen, ohne eine Ressource bereitzustellen. Das ist hilfreich in agentengesteuerten Workflows, wenn Sie vor der Bereitstellung von Ressourcen eine Verbindung zum Anbieter herstellen möchten. ```bash stripe projects link ``` ### Einen Dienst entfernen Entfernen Sie einen Dienst aus Ihrem Konto und Ihrem lokalen Projekt: ```bash stripe projects remove / #or stripe projects remove ``` ### Anmeldedaten rotieren Rotieren Sie Anmeldedaten für einen bestimmten Dienst: ```bash stripe projects rotate / #or stripe projects rotate ``` ### Eine Servicestufe aktualisieren Du kannst die Service-Stufe aufrüsten, wenn ein Service mehr Kapazität, Funktionen oder Limits benötigt als die aktuelle Stufe bietet. ```bash stripe projects upgrade | / | ``` Überprüfen Sie vor dem Upgrade die aktuelle Stufe für jeden Service im Status- oder Anbieter-Dashboard. Sie müssen Ihre Zahlungsmethode nur einmal bei Stripe hinterlegen. Wenn Sie in der CLI einen kostenpflichtigen Plan auswählen, wandelt Stripe Ihre Zahlungsdaten in ein [Shared Payment Token](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) um und gewährt dem Anbieter eine Zahlungsberechtigung für dieses Upgrade. Der Anbieter rechnet über dieses Token ab. Ihre eigentlichen Zahlungsdaten werden nicht weitergegeben. > Sehen Sie, [in welchen Ländern kostenpflichtige Dienste angeboten werden](https://docs.stripe.com/projects/paid-tier-countries.md). ### Ein Anbieter-Dashboard öffnen Öffnen Sie das Dashboard eines Anbieters in Ihrem Standardbrowser: ```bash stripe projects open ``` ## Umgebungsvariablen verwalten Stripe Projects speichert Zugangsdaten im Vault und synchronisiert die Umgebungsvariablen mit Ihrer lokalen Umgebung (`.env`) automatisch, wenn Sie Dienste hinzufügen oder ändern. ### Variablen auflisten Zeigen Sie alle Projektumgebungsvariablen an. Werte werden in der Ausgabe nicht angezeigt: ```bash stripe projects env ``` Umgebungsvariablen synchronisieren sich ebenfalls automatisch nach der Ressourcenbereitstellung. ### Variablen synchronisieren Aktualisieren Sie die Ausgabedatei der aktiven Umgebung und füllen Sie Ihren Tresor für Anmeldeinformationen auf. Für die Standardumgebung wird in `.env` geschrieben, sofern Sie keinen anderen Ausgabepfad konfiguriert haben. Für benannte Umgebungen wird in die Ausgabedatei geschrieben, die Sie bei der Erstellung oder Aktualisierung der Umgebung konfiguriert haben. ```bash stripe projects env --pull ``` ### Projektvariablen verwalten Verwenden Sie Projektvariablen, um Umgebungsvariablen zu speichern, die nicht von einer bereitgestellten Anbieterressource stammen, wie z. B. App-URLs, Funktions-Flags oder API-Schlüssel, die Sie selbst verwalten. Legen Sie eine Projektvariable fest und binden Sie sie an die aktive Umgebung: ```bash stripe projects variables set --env-key --value ``` Wenn Sie `--value` im interaktiven Modus weglassen, veranlasst die CLI eine sichere Aufforderung für den Wert. Der Variablenname identifiziert den gespeicherten Wert in Stripe Projects. Der Wert `--env-key` ist der Schlüssel, der in die Ausgabedatei der aktiven Umgebung geschrieben wird. `variables set` synchronisiert diese Ausgabe sofort. Beispielsweise können Sie unterschiedliche gespeicherte Werte für die Entwicklung und die Produktion verwenden, während Sie denselben Umgebungsschlüssel in jede Ausgabedatei schreiben: ```bash stripe projects env create development --output .env.dev stripe projects variables set api-url-dev --env-key API_URL --value https://dev.example.com stripe projects env create production --output .env.production stripe projects variables set api-url-prod --env-key API_URL --value https://api.example.com ``` Listen Sie Projektvariablen und ihre lokalen Umgebungsbindungen auf: ```bash stripe projects variables list ``` Löschen Sie eine Projektvariable und entfernen Sie ihre lokalen Bindungen: ```bash stripe projects variables delete ``` Um eine vorhandene Projektvariable an die aktive Umgebung zu binden, verwenden Sie `env add`: ```bash stripe projects env add --variable --env-key ``` Um eine Projektvariable aus der aktiven Umgebung zu entfernen, ohne die gespeicherte Variable zu löschen, verwenden Sie `env remove`: ```bash stripe projects env remove --variable ``` Stripe Projects behält lokale Umgebungsschlüssel bei, die es nicht verwaltet. ### Wann env --pull ausgeführt werden soll `env --pull` wird automatisch ausgeführt, nachdem Sie einen Dienst bereitgestellt, Anmeldedaten rotiert, eine Ressource aktualisiert oder die Umgebungszugehörigkeit geändert haben. In diesen Fällen müssen Sie es nicht manuell ausführen. Führen Sie `env --pull` in folgenden Fällen manuell aus: - Sie richten das Projekt auf einem neuen Computer ein oder nachdem Sie das Repo geklont haben. - Ein Teammitglied hat eine Ressource bereitgestellt oder rotiert und Sie müssen die aktualisierten Anmeldedaten abrufen. - Ihre `.env` wurde gelöscht oder beschädigt und Sie müssen sie wiederherstellen. - Sie möchten überprüfen, ob Ihre lokalen Anmeldedaten mit dem aktuellen Projektstatus übereinstimmen. - Sie sind mit `stripe projects env use` in eine andere Umgebung gewechselt und benötigen die Anmeldeinformationen dieser Umgebung lokal. - Eine Projektvariable wurde per Remotezugriff geändert und Sie möchten ihre lokale Ausgabedatei aktualisieren. ```bash stripe projects env --pull ``` ### Produktionsumgebungsvariablen einrichten `stripe projects env --pull` schreibt Anmeldeinformationen in die lokale Ausgabedatei der aktiven Umgebung. Umgebungsvariablen werden nicht in Ihren Produktionshost geschrieben. Um dieselben Anmeldedaten in der Produktion zu verwenden, fügen Sie sie den Umgebungsvariableneinstellungen Ihres Hosts hinzu. Stripe Projects automatisiert diesen Schritt nicht. > Oft verfügen Anbieter über eigene CLI-Tools, die eine `.env`-Datei auslesen können. Den empfohlenen Import-Workflow finden Sie in der Dokumentation Ihres Anbieters. ### Mehrere Umgebungen verwalten Verwenden Sie Projektumgebungen, um separate Anmeldeinformationen und Ressourcen für verschiedene Phasen Ihrer App aufzubewahren, wie z. B. lokale Entwicklung, Staging und Produktion. Jede Umgebung verfügt über Folgendes: - Einen Namen, z. B. `default`, `development`, `staging` oder `production` - Eine Ausgabedatei, z. B. `.env`, `.env.dev` oder `.env.production` - Eine Reihe von Projektressourcen, deren Anmeldeinformationen in diese Ausgabedatei geschrieben werden Stripe Projects verwendet eine aktive Umgebung für lokale Befehle. Befehle, die Ressourcen hinzufügen oder Anmeldeinformationen synchronisieren, zielen auf die aktive Umgebung ab. Ihre Umgebungen auflisten: ```bash stripe projects env list ``` Die aktive Umgebung anzeigen: ```bash stripe projects env show ``` Eine neue Umgebung erstellen und als aktiv festlegen: ```bash stripe projects env create development --output .env.dev ``` Die aktive Umgebung wechseln: ```bash stripe projects env use default stripe projects env use development ``` Nachdem Sie die Umgebungen gewechselt haben, stellt `stripe projects add` Ressourcen in der aktiven Umgebung bereit und `stripe projects env --pull` schreibt die Anmeldeinformationen dieser Umgebung in ihre konfigurierte Ausgabedatei. ```bash # Add a database to the active development environment stripe projects env use development stripe projects add neon/postgres --name dev-db stripe projects env --pull # Switch back to the default environment and pull its credentials stripe projects env use default stripe projects env --pull ``` Den Namen oder die Ausgabedatei der aktiven Umgebung aktualisieren: ```bash stripe projects env update --name staging stripe projects env update --output .env.staging ``` Eine Umgebung löschen: ```bash stripe projects env delete staging ``` Die letzte Umgebung und die virtuelle Umgebung `default` können Sie nicht löschen. ### Umgebungsressourcen verwalten Die Umgebungszugehörigkeit steuert, welche Projektressourcen Anmeldeinformationen zur Ausgabedatei der aktiven Umgebung beitragen. Der aktiven Umgebung eine vorhandene Projektressource hinzufügen: ```bash stripe projects env add ``` Eine Ressource aus der aktiven Umgebung entfernen: ```bash stripe projects env remove ``` Diese Befehle ändern nur die Umgebungszugehörigkeit. Sie dienen nicht dazu, Anbieterressourcen bereitzustellen, zu entfernen oder zu rotieren. Um eine Anbieterressource aus dem Projekt zu entfernen, verwenden Sie `stripe projects remove`. Führen Sie `stripe projects status` oder `stripe projects services list` aus, um Ressourcennamen zu finden. ## Die Abrechnung verwalten Zahlungsmethoden sind mit Ihrem Stripe-Konto verknüpft. ### Die Zahlungsmethode anzeigen Zeigen Sie Ihre Zahlungsmethode in der Datei an: ```bash stripe projects billing show ``` ### Eine Zahlungsmethode hinzufügen oder aktualisieren Fügen Sie eine Zahlungsmethode hinzu oder ersetzen Sie eine bestehende: ```bash stripe projects billing add ``` Nachdem Sie eine Zahlungsmethode eingerichtet haben, können Sie ein [Ausgabenlimit festlegen](https://docs.stripe.com/projects.md#set-a-spend-limit). ### Ihre Ausgaben anzeigen Rufen Sie die `Stripe-Projekt-Ausgaben` auf, um Ihre Ausgaben für den aktuellen und die vergangenen Monate, aufgeschlüsselt nach Anbietern, anzuzeigen. ```bash stripe projects spend ``` Die Anzeige enthält Ihre Ausgaben für: - **Aktueller Monat**: Ausgaben bis heute, nach Anbietern - **Vergangene Monate**: Gesamtausgaben, nach Anbietern Standardmäßig zeigt der Befehl die Ausgaben der letzten 6 Monate an. Verwenden Sie `--duration` oder `--since`/`--until`, um den Zeitraum zu ändern: ```bash stripe projects spend --duration 3m ``` Verwenden Sie `--duration` mit einer positiven ganzen Zahl von Monaten oder Tagen, wie z. B. `3m`, `12m` oder `90d`. Verwenden Sie `all`, um Abbuchungen seit dem 1. Januar 2026 anzuzeigen. Verwenden Sie `--since` oder `--until` mit einem Datum im Format `YYYY-MM-DD`. Sie können jede Option für sich allein oder beide zusammen verwenden. Der Befehl umfasst die vollen Kalendermonate, die die Daten enthalten. Zum Beispiel umfasst `--since 2026-01-15` den gesamten Januar und `--until 2026-03-10` den gesamten März. ```bash stripe projects spend --since 2026-01-15 --until 2026-03-10 ``` Sie können `--duration` nicht mit `--since` oder `--until` kombinieren. So zeigen Sie die Ausgaben für einen bestimmten Anbieter an: ```bash stripe projects spend [provider] ``` ### Ein Ausgabenlimit festlegen Verwenden Sie `Stripe Projects Billing Update`, um Ausgabenlimits für Ihre Zahlungsmethode festzulegen. Sie können ein globales Limit festlegen, das für alle Anbieter gilt, oder ein Limit pro Anbieter für eine detailliertere Kontrolle. Führen Sie den Befehl interaktiv aus, um den Limit-Typ auszuwählen und Ihre Werte einzugeben: ```bash stripe projects billing update ``` Sie können auch das Flag `--limit` direkt angeben, um die Eingabeaufforderungen zu überspringen. So legen Sie ein globales Limit für alle Anbieter fest: ```bash stripe projects billing update --limit ``` So legen Sie ein Limit für einen bestimmten Anbieter fest: ```bash stripe projects billing update --limit --provider ``` Anbieterbezogene Limits haben Vorrang vor einem globalen Limit, wenn beide festgelegt sind. Führen Sie den Befehl einmal für jeden Anbieter aus, den Sie individuell begrenzen möchten. ## LLM-Kontext generieren Zeigen Sie eine lokale Datei an, die Ihren Projektkontext mit allen vom Anbieter bereitgestellten LLM-Kontextdateien kombiniert, und erstellen Sie eine solche Datei: ```bash stripe projects llm-context ``` ## Ein Projekt teilen Verwenden Sie `stripe projects share`, um eine URL zu generieren, die den Service-Stack Ihres Projekts enthält. Die URL gibt wieder, welche Dienste Sie hinzugefügt haben, enthält jedoch weder Ihre Anmeldedaten noch Ihre Konfigurationswerte. Führen Sie dies in einem Projektverzeichnis aus, das mindestens einen Dienst enthält: ```bash stripe projects share ``` Kopieren Sie die URL und teilen Sie diese mit anderen. Die URL ist eigenständig und läuft nicht ab. ### Ein neues Projekt aus einem gemeinsam genutzten Stack einrichten Führen Sie den Befehl `stripe projects init` mit dem Flag `--from` in einem leeren Verzeichnis aus: ```bash stripe projects init --from ``` Dadurch wird ein neues Projekt initialisiert und es werden neue Instanzen aller Dienste im gemeinsamen Stack bereitgestellt. ### Dienste zu einem bestehenden Projekt hinzufügen Führen Sie den Befehl `stripe projects import` aus einem bereits initialisierten Projektverzeichnis aus: ```bash stripe projects import ``` Dadurch werden die Dienste aus dem gemeinsamen Stack bereitgestellt und Ihrem bestehenden Projekt hinzugefügt. ## Verfügbare Anbieter Diese Anbieter haben das Integrationsprotokoll gemeinsam mit Stripe entwickelt. Das Protokoll standardisiert die Bereitstellung, die Planauswahl, Upgrades und die Übergabe von Anmeldedaten. | Anbieter | Hauptkategorien | | --- | --- | | AgentMail | E-Mail | | AgentPhone | Kommunikation | | Algolia | Suche | | Amplitude | Analysen, Feature-Flags | | Auth0 | Autorisierung | | Base 44 | Hosting, Datenbank, KI | | Blaxel | Hosting, Sandbox, KI | | Browserbase | Browser, KI | | Chatbase | KI | | Chroma | Datenbank, KI | | Clerk | Authentifizierung | | ClickHouse | Datenbank, Analysen | | Cloudfare | Hosting, Datenbank, Speicher, Domains, Cache, Warteschlangen, Browser | | Composio | KI | | CreateOS | Compute | | Customer.io | Messaging, E-Mail | | Datadog | Beobachtbarkeit, Analysen | | Daytona | Sandboxes, Hosting | | Depot | CI, Compute | | E2B | Hosting, Sandbox | | ElevenLabs | KI | | Exa | Suche, KI | | Firecrawl | Suche | | Fly.io | Hosting, Datenbank | | GitLab | CI/CD, Beobachtbarkeit, Speicher | | HeyGen | KI | | Hugging Face | KI, Hosting, Speicher | | Inngest | Warteschlange | | Kernel | Browser, KI | | Klaviyo | E-Mail, Messaging | | Laravel Cloud | Hosting, Cache, Datenbank | | Metronome | Payments | | Mixpanel | Analytik | | Neon | Datenbank, Authentifizierung | | Netlify | Hosting | | OpenRouter | KI | | Parallel | Suche, KI | | PlanetScale | Datenbank | | PostalForm | Kommunikation | | PostHog | Analysen, Feature-Flags | | Prisma | Datenbank | | Privy | Zahlungen, Authentifizierung | | Pydantic | Beobachtbarkeit, Analysen | | Railway | Hosting, Datenbank, Speicher, Cache | | Darstellung | Hosting, Datenbank | | RevenueCat | Zahlungen, Analysen | | Runloop | Sandboxes, KI | | Schematische Darstellung | Funktions-Flags, Zahlungen | | Sentry | Beobachtbarkeit | | Spaceship | Domains | | Squarespace | Domains | | Steelbrowser | Browser, KI | | Supabase | Datenbank, Authentifizierung, Speicherung | | Supermemory | KI, Datenbank, Suche | | Tabstack | Suche, Browser | | Turso | Datenbank | | Twilio | Kommunikation | | Upstash | Cache, Suche, Datenbank | | Vercel | Hosting | | Wix | Hosting | | WordPress.com | Hosting, Domains | | WorkOS | Autorisierung | Sie können jederzeit `stripe projects catalog` ausführen, um die aktuellste Liste der Anbieter und verfügbaren Servicestufen anzuzeigen. Alternativ ist das Verzeichnis auch unter [projects.dev/providers](https://projects.dev/providers) abrufbar. > #### Fragen Sie nach einem Anbieter > > Kontaktieren Sie [provider-request@stripe.com](mailto:provider-request@stripe.com), wenn Sie daran interessiert sind, ein Anbieter im Netzwerk von Stripe Projects zu werden, oder wenn Sie an einem bestimmten Anbieter interessiert sind. ## Nicht-interaktive Umgebungen verwenden Jeder Befehl unterstützt Flags für nicht-interaktive Umgebungen wie CI/CD-Pipelines, Scripts und Agenten. ### Globale Flags | Flag | Beschreibung | | --- | --- | | `-v, --version` | Aktuelle Plugin-Version anzeigen. | | `--json` | Geben Sie die Ausgabe als strukturierte JSON anstelle von formatiertem Text zurück. | | `--no-interactive` | Deaktivieren Sie interaktive Eingabeaufforderungen und Bestätigungsdialoge. Befehle schlagen fehl, wenn die erforderliche Eingabe fehlt. | | `--auto-confirm` | Akzeptieren Sie Bestätigungsaufforderungen automatisch, z. B. wenn Sie einen Dienst entfernen. | | `--quiet` | Unterdrücken Sie nicht wesentliche Ausgaben und geben Sie nur endgültige Ergebnisse oder Fehler zurück. | | `--accept-tos` | AGB des Anbieters ohne Aufforderung akzeptieren. | | `--stream` | Streaming-Ausgabeanimationen aktivieren. | | `--debug` | Fehlerbehebungsprotokollierung für Stripe API-Anfragen aktivieren. | ## Leitfaden zur Agent-Integration ### Wann Stripe Projects verwendet werden sollte Verwenden Sie Stripe Projects, wenn der/die Nutzer/in Folgendes anfragt: - Bereitstellung einer Datenbank, eines Caches, eines Authentifizierungsdienstes, von Hosting, Analysetools, Observability oder einer beliebigen Infrastruktur von Drittanbietern - Beziehen Sie einen API-Schlüssel, Anmeldedaten, einen geheimen Schlüssel oder ein Token für einen Drittanbieter-Dienst - Registrieren Sie sich bei einem Dienst wie Neon, Supabase, PlanetScale, Upstash, Clerk, Auth0, WorkOS, Vercel, Netlify, Railway, Render, Fly.io, Cloudflare, Sentry, PostHog, Mixpanel, Amplitude, OpenRouter, Hugging Face, Elevenlabs, Twilio, Resend, Algolia, Chroma, Turso oder verbinden Sie sich mit einem solchen Dienst Inngest, Browserbase, Daytona, Runloop, Privy, Squarespace, GitLab, AgentMail - Richten Sie einen LLM-Anbieter, einen Modellanbieter, eine Vektordatenbank, eine Nachrichtenwarteschlange, einen Objektspeicher, einen E-Mail-Versand, eine Suchfunktion oder Feature-Flags ein - Sehen Sie sich an, welche Dienste verfügbar sind, überprüfen Sie den Projektstatus, listen Sie bereitgestellte Ressourcen auf oder zeigen Sie Umgebungsvariablen an - Jede Erwähnung von projects.dev, Stripe Projects, dem Stripe Projects-Katalog oder dem Hinzufügen, Einrichten oder Verbinden eines Cloud-Dienstes Weisen Sie die/den Benutzer/in NICHT an, sich manuell für einen der oben genannten Dienste anzumelden. Sehen Sie zunächst im Projektkatalog nach und richten Sie die Dienste programmgesteuert ein. ### Bootstrap-Workflow Schritt 1 – Überprüfen Sie, ob die Stripe-CLI installiert ist: ```bash which stripe && stripe --version ``` Falls fehlend oder unter 1.40.0: - macOS: brew install stripe/stripe-cli/stripe (oder brew upgrade stripe/stripe-cli/stripe) - Andere Plattformen: Leiten Sie den/die Nutzer/in an https://docs.stripe.com/stripe-cli/install weiter Installieren Sie das Projects-Plug-in: ```bash stripe plugin install projects ``` Schritt 2 – Durchsuchen Sie den Katalog, um zu bestätigen, dass der Service existiert: ```bash stripe projects search --json ``` Wenn die Anfrage vage ist, durchsuchen Sie den gesamten Katalog: ```bash stripe projects catalog --json ``` Schritt 3 – Initialisieren Sie (falls noch nicht geschehen): ```bash stripe projects status --json stripe projects init --yes ``` Wenn die CLI einen Browser zur Authentifizierung öffnet, halten Sie an und fordern Sie den/die Nutzer/in deutlich auf, die Anmeldung abzuschließen. Führen Sie keine weiteren Befehle aus, bis der/die Nutzer/in dies bestätigt hat. Schritt 4 – Übergeben Sie an den lokal installierten stripe-projects-cli-Skill unter .skills/stripe-projects-cli/ (während der Initialisierung installiert). Verwenden Sie diesen Skill für alle nachfolgenden Befehle: add, link, env, rotate, upgrade, remove. ### Regeln - Zeigen Sie niemals Werte von Umgebungsvariablen an, sondern nur Namen. - Erfinden Sie niemals Anbieternamen oder Befehle, die nicht in der Katalogausgabe enthalten sind. - Bearbeiten Sie .projects/ oder .env nicht manuell – die CLI ist maßgeblich. - Verwenden Sie --json bei allen Befehlen außer init für eine strukturierte Ausgabe. ### Fehlerbehebung - PROVIDER_NOT_LINKED: Führen Sie Stripe-Projekte Link aus - UNKNOWN_ERROR: Zeigen Sie den vollständigen Fehler an und schlagen Sie --debug vor - Service nicht im Katalog: Informieren Sie den/die Nutzer/in und schlagen Sie vor, den Katalog zu durchsuchen - CLI nicht gefunden: Installieren Sie gemäß den obigen Plattformanweisungen