mcpField
S
setup-api-key

setup-api-key

github.com/elevenlabs開発51610.3k 回インストール今日更新
リポジトリ

setup-api-key について

既存のキーの設定や、使えなくなったキーの確認を支援するElevenLabs APIキー管理スキルです。キーを表示せずにElevenLabs CLIで検証し、安全な保管手順も案内します。

主な機能

  1. 01既存APIキーの設定案内
  2. 02CLIによるキー検証
  3. 03キーを表示しない確認
  4. 04拒否されたキーへの対応手順
  5. 05シークレット管理の注意事項

活用シーン

  1. 01管理者から受け取ったキーをプロジェクトに追加
  2. 02動作しなくなったキーを検証
  3. 03所定の手順で拒否されたキーに対処

インストール

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

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

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

詳細

ElevenLabs API キーの設定

ユーザーがすでに持っているキー、または機能しなくなったキーの場合に使用します。プロジェクトに ElevenLabs を一から追加する場合は、onboarding スキルを使用してください。

ユーザーがすでに持っているキー（たとえば、管理者から受け取ったキー）： 新しいキーを取得するためにサインインしないでください。使用するアプリの環境ファイル（.env.local、または Python プロジェクトの .env）で ELEVENLABS_API_KEY= の後に貼り付けるよう伝えてください。このチャットには絶対に貼り付けないよう伝え、完了したら知らせてもらいます。その後、キーを確認してください（check でキーが見つからない場合、または ElevenLabs がキーを拒否してサインインを促した場合は、サインインするのではなく、貼り付けた内容を確認するようユーザーに依頼してください）。

npx -y @elevenlabs/cli@latest onboard check

機能しなくなったキー： アプリのフォルダーから同じコマンドを実行してください。アプリが使用するキー（シェル、環境ファイル、または親ディレクトリにある .env）を見つけ、キーを表示せずに ElevenLabs で確認し、JSON を出力します。next は次の手順（instruction に明記されています。以下のリストと異なる場合は、以下のリストに従ってください）、run は実行する正確なコマンド、say はユーザーへの伝達内容です（記載どおりに伝えてください）。キーが機能するまで続けてください。キーが拒否された場合は、新しいキーを取得するためにユーザーをサインインさせます。各 next の意味は次のとおりです。

  • run：run を実行します。wait：say を表示してから、すぐに run を再実行します。
  • ask_user、またはユーザーのシェルやシークレットが必要な fix：say の内容をユーザーに尋ね、回答を待ってから run を実行します。ただし、ユーザーが拒否した場合は実行しません。
  • write_code：アプリがすでに SDK または独自のリクエストを通じて ELEVENLABS_API_KEY を読み込んでいる場合は、コードを変更しないでください。connect の後は run を実行し、check の後は say ではなくキーが機能していることをユーザーに伝えて終了します。それ以外の場合は、コードで SDK が使われるようにしてから run を実行します。アプリで ElevenLabs をどう使うべきか判断できる情報がなければ、まずユーザーに尋ねてください。ユーザーに代わって製品を選んではいけません。
  • offer_test：say にある質問をして、ユーザーが同意した場合のみ run を実行します。
  • done：say の内容をユーザーに伝えます。

ルール

  • 環境ファイルを開いたり、表示したり、cat したりしてはいけません。また、ELEVENLABS_API_KEY をエコーしてはいけません。onboard check がキーを確認します。
  • チャットで API キーを尋ねたり、チャットに貼り付けられたキーを受け取ったりしてはいけません。キーが貼り付けられた場合は、API キーのページでローテーションするようユーザーに伝えてください。
  • キーをコードに記述してはいけません。SDK は ELEVENLABS_API_KEY を読み込みます。
  • ユーザーが同意するまでは、アプリ（または起動スクリプト）を実行したり、試すために音声を生成したりしてはいけません。エージェントの作成など、ユーザーが依頼した内容に必要な API 呼び出しは問題ありません。コードを書き終えたら、終了する前に onboard check を実行してください。キーとコードが確認されます。
  • ブラウザーアプリやクライアントサイドアプリでは、キーをサーバー上に保持し、製品が対応している場合は有効期間の短いトークンを発行してください。

npx を使わない場合

npx が使えない場合（Node.js がインストールされていない場合）は、CLI をインストールしてください（すでにインストールされている場合は、brew upgrade elevenlabs で更新するか、インストーラーを再実行します）。その後、代わりに elevenlabs onboard check を実行してください。

  • macOS または Linux：brew install elevenlabs/tap/elevenlabs、または curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
  • Windows：powershell -ExecutionPolicy ByPass -c "irm https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.ps1 | iex"

インストーラーの実行後に elevenlabs が見つからない場合は、ここおよび CLI が指示するすべての run で、代わりに ~/.cargo/bin/elevenlabs を使用してください。

コメント

Markdown 対応