stripe-projects

Stripe Projects — サービスプロビジョニング

Stripe Projects CLI プラグインを使用してサードパーティサービスをプロビジョニングし、API キー/トークンを取得します。

ワークフロー

ステップ 1: プロバイダーの利用可能性を確認

何をする前に、https://projects.dev/providers を取得し、要求されたプロバイダーがディレクトリリストに表示されているか確認します。

• プロバイダーがそのページにリストされていない場合、Stripe Projects はこのプロバイダーをサポートしていないことをユーザーに知らせて停止します。
• プロバイダーがリストされている場合、続行します。

ステップ 2: Stripe CLI がインストールされていることを確認

Stripe CLI が利用可能か確認します:

which stripe && stripe --version

インストールされていない場合は、ユーザーのプラットフォームに基づいてインストールします:

macOS (Homebrew):

brew install stripe/stripe-cli/stripe

Linux (Debian/Ubuntu via APT):

curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
sudo apt update
sudo apt install stripe

Windows (Scoop):

scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
scoop install stripe

インストールされている場合でも、バージョンが 1.40.0 より低い場合は、ユーザーのプラットフォームに基づいてアップグレードします:

macOS (Homebrew):

brew upgrade stripe/stripe-cli/stripe

または、他のプラットフォームについては https://docs.stripe.com/stripe-cli/upgrade の指示に従ってください。

ステップ 3: Stripe Projects プラグインがインストールされ、最新であることを確認

stripe plugin install projects

ステップ 4: カタログを検索

特定のプロバイダーが利用可能で、特定のサービスを検証していることを確認します:

stripe projects search <query> --json

result_count が 0 の場合、サービスがカタログに見つからなかったことをユーザーに知らせて停止します。

ステップ 5: プロジェクトを初期化

プロジェクトが既に初期化されているか確認します:

stripe projects status --json

初期化されていない場合:

stripe projects init --json --yes

注: ユーザーが Stripe CLI にログインしていない場合、projects init はブラウザーにリダイレクトして、既存の Stripe アカウントにログインするか、新しい Stripe Projects アカウントを作成するよう促します。この場合、ユーザーに次のようにプロンプトします:

▎ Stripe Projects は認証のためにブラウザーにリダイレクトしています。 ▎ - 既存の Stripe アカウントがある場合は、認証情報でログインしてください。 ▎ - 初めての場合は、数秒で無料の Stripe Projects アカウントを作成できます。 ▎ ▎ ブラウザーでサインインを完了してから、ここに戻って完了したことを知らせてください。

続行する前にユーザーの確認を待ちます。

ステップ 6: ローカル stripe-projects-cli スキルに引き渡す

重要: プロジェクトが初期化された後は、常にローカルプロジェクトディレクトリの .claude/skills/stripe-projects-cli にインストールされた stripe-projects-cli スキルを使用して (Skill ツールで名前 stripe-projects-cli を使用して呼び出す)、サービス追加のワークフローを続行します。テーブルで返された環境変数名を出力しますが、その値は決して表示しません。

ステップ 7: プロバイダー推奨事項

正常な 'add' 出力の後、Stripe Projects カタログで利用可能な他のプロバイダーサービスで補完的な (別のプライマリカテゴリ) または役立つ可能性のあるものについて、ユーザーに有用な提案を与えます — 3 〜 5 つの提案。これらのサービスをプロビジョニングするために作成されたコマンドを絶対に表示しないでください。stripe projects catalog 出力からのもののみ表示します。

非対話モード

常に --json --yes フラグを使用して対話的なプロンプトを抑制します。有料サービスが確認を必要とする場合は、--confirm-paid-service を追加します。

作業契約

• .projects の下または生成された .env 出力の CLI 管理ファイルを手動で編集しないでください。
• .projects ディレクトリのファイルを絶対に確認しないでください。CLI がすべてを管理します。
• .env ファイルを絶対に確認しないでください。CLI がすべてを管理します。

エラーハンドリング

• projects.dev/providers にプロバイダーがリストされていない → 早期に停止し、サポートされていないことをユーザーに伝える
• Stripe CLI が見つからない → 上記のプラットフォーム指示に従ってインストール
• プラグインが見つからない → stripe plugin install projects でインストール
• projects init がブラウザーログインをトリガーする → ユーザーにプロンプトし、確認を待つ
• カタログにサービスがない → ユーザーに知らせ、stripe projects catalog --json を提案して他の選択肢を閲覧する