mcpField
S
setup-api-key

setup-api-key

github.com/bolna-ai開発366 回インストール2 日前に更新
リポジトリ

setup-api-key について

Bolna API キーの設定と検証を行うスキルです。ダッシュボードでのキー作成、環境変数への保存、接続テスト、認証エラーの確認方法を説明します。

主な機能

  1. 01Bolna ダッシュボードでキーを作成
  2. 02キーを環境変数に保存
  3. 03接続テストでアクセスを検証
  4. 04一般的な認証エラーを診断

活用シーン

  1. 01Bolna スクリプトの実行前に認証情報を設定
  2. 02API キーのアカウントアクセスを確認
  3. 03401、403、429 の応答を調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bolna-ai/skills --skill setup-api-key

インストール後、Claude Code で/setup-api-keyを入力して読み込まれたか確認します。

同梱ファイルscripts/verify_key.py

詳細

Bolna API キーの設定

基本情報

  • ベース URL：https://api.bolna.ai
  • 認証ヘッダー：Authorization: Bearer $BOLNA_API_KEY
  • 動作確認用エンドポイント：GET /user/me
  • API キーは Bolna ダッシュボードの Developers から作成します。
  • キーは一度しか表示されません。紛失した場合は、削除して新しいキーを生成してください。
  • サブアカウントのキーは sa- で始まります。

ワークフロー

  1. Bolna API キーをすでに持っているか、ユーザーに確認します。
  2. 持っていない場合は、https://platform.bolna.ai にアクセスし、Developers を開いてキーを作成するよう案内します。
  3. コミット対象のファイルには決して記載せず、ローカルの環境変数として保存します。
  4. GET /user/me で確認します。
  5. 確認に失敗した場合は、環境変数の未設定、無効なキー、期限切れまたは削除済みのキー、アカウントへのアクセス権限不足を切り分けます。

シェルの設定

export BOLNA_API_KEY="paste-key-here"

プロジェクト内の .env に設定する場合：

BOLNA_API_KEY=paste-key-here

.env が .gitignore に含まれていることを確認してください。

cURL による動作確認

curl --request GET \
  --url https://api.bolna.ai/user/me \
  --header "Authorization: Bearer $BOLNA_API_KEY"

想定される形式：

{
  "id": "user-uuid",
  "name": "Account name",
  "email": "[email protected]",
  "wallet": 42.42,
  "concurrency": {
    "max": 10,
    "current": 0
  }
}

トラブルシューティング

  • 401：API キーが未設定、形式不正、削除済み、または誤っています。
  • 403：キーは存在しますが、アカウントまたはサブアカウントに、要求されたリソースへのアクセス権がありません。
  • 429：レート制限に達しています。指数バックオフで再試行してください。
  • $BOLNA_API_KEY が空の場合：スクリプトを実行するシェルセッションでエクスポートするようユーザーに伝えてください。

スクリプト

付属の動作確認を実行します：

python3 setup-api-key/scripts/verify_key.py

関連項目

  • https://raw.githubusercontent.com/bolna-ai/skills/main/references/bolna-core.md — ベース URL、ヘッダー、ページネーション、レート制限をまとめて確認できます。
  • manage-subaccounts — sa- のプレフィックスと、親アカウントのキーとサブアカウントのキーの違いについて説明します。

コメント

Markdown 対応