mcpField
S
setup-api-key

setup-api-key

github.com/vapiai開発68957 回インストール3 日前に更新
リポジトリ

setup-api-key について

Vapi API キーをローカルに保存し、検証する手順を案内するスキルです。チャットでの秘密情報の共有を避け、環境ファイルを保護します。

主な機能

  1. 01API キー作成の案内
  2. 02ローカル環境変数の設定
  3. 03キーを表示しない検証
  4. 04.gitignore の保護確認

活用シーン

  1. 01他のスキル向けの Vapi 接続設定
  2. 02ローカル保存した API キーの確認
  3. 03環境ファイルのバージョン管理への混入防止

MCP 対応

README では、互換性のある AI エージェントがドキュメントを検索できる Vapi ドキュメント MCP サーバーに触れています。

インストール

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

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

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

詳細

Vapi API キーの設定

音声 AI プラットフォームの Vapi API キーを取得して設定する手順をユーザーに案内します。

ワークフロー

ステップ 1：API キーをリクエストする

ユーザーに次のように伝えます。

Vapi を設定するには、Vapi Dashboard の API キーのページを開いてください：https://dashboard.vapi.ai/org/api-keys

（アカウントをお持ちでない場合は、まず https://dashboard.vapi.ai/signup で作成してください）

API キーをまだお持ちでない場合：

  1. "Create Key" をクリックします
  2. キーに名前を付けます（例：「development」）
  3. キーは一度しか表示されないため、すぐにコピーします

このチャットに非公開の API キーを貼り付けないでください。以下の手順に従ってローカルに保存し、ファイルの準備ができたらお知らせください。

ユーザーがローカルの環境ファイルの準備ができたと確認するまで待ちます。キーを送信したり表示したりするよう求めないでください。

ステップ 2：検証して設定する

ユーザーがキーをローカルに保存したと確認したら：

  1. キーの値を表示せずに、利用可能であることを確認します。 既存の環境変数を優先します。ない場合は、エディターを使ってローカルの .env.local ファイルに VAPI_API_KEY として保存するようユーザーに依頼します。ファイルの内容は決して表示しません。

  2. キーが読み込まれている環境からリクエストを送信し、キーを検証します：

     curl -s -o /dev/null -w "%{http_code}" https://api.vapi.ai/assistant \
   -H "Authorization: Bearer $VAPI_API_KEY"

  3. 検証に失敗した場合（200 以外のレスポンス）：

    • API キーが無効と思われることをユーザーに伝えます
    • キーを再確認して、もう一度試すよう依頼します
    • URL https://dashboard.vapi.ai/org/api-keys を案内します

  4. 検証に成功した場合は、ローカルの環境ファイルにこの変数が含まれていることを、値を表示せずに確認します：

    VAPI_API_KEY=<the-api-key>

  5. 成功を確認します：

    Vapi API キーが VAPI_API_KEY としてローカルに設定されました。

    これで Vapi の API を使って、アシスタントの作成、通話の発信、音声 AI エージェントの構築ができます。

    このキーは安全に保管し、バージョン管理にコミットしないでください。

ステップ 3：.gitignore を確認する

.gitignore がローカルの環境ファイルを保護しているか確認します。保護していない場合は、次を追加します：

.env*
!.env.example

環境変数

すべての Vapi スキルでは、API キーを VAPI_API_KEY 環境変数に設定します。すべての API リクエストで使用するベース URL は次のとおりです：

https://api.vapi.ai

認証には Bearer トークンを使用します：

Authorization: Bearer $VAPI_API_KEY

追加リソース

Vapi はドキュメント MCP サーバーを提供しており、互換性のある AI エージェントが Vapi のナレッジベースにアクセスできます。高度な設定、トラブルシューティング、SDK の詳細、このスキルの範囲を超える内容については、ドキュメント検索を利用してください。

手動での設定： エージェントが設定を自動検出しない場合は、次を実行します：

claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server

サポートされているエージェントでの設定手順については、Vapi MCP 連携ガイドを参照してください。

コメント

Markdown 対応