mcpField
R
remix-api-auth

remix-api-auth

github.com/farworld-labs開発60 回インストール
リポジトリ

remix-api-auth について

ターミナル、MCP クライアント、外部サービスから Remix API を利用する際の認証設定とトラブルシューティングを扱うスキルです。API キーと CLI 認証情報の使い方、優先順位、検証、安全な管理方法を説明します。

主な機能

  1. 01Bearer API キー認証
  2. 02CLI ログインと本人確認
  3. 03MCP 認証情報の参照方法
  4. 04認証情報の優先順位と検証
  5. 05API キーの診断と安全管理

活用シーン

  1. 01サービスの Remix API 認証設定
  2. 02remix login による CLI 接続設定
  3. 03MCP サーバーの認証情報設定
  4. 04無効または上書きされた API キーの調査

MCP 対応

MCP の認証には REMIX_API_KEY を推奨し、未設定の場合はサーバーが ~/.config/remix/credentials.json の CLI 認証情報を利用できると説明します。

インストール

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

$npx skills add https://github.com/farworld-labs/remix-skills --skill remix-api-auth

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

同梱ファイルscripts/README.mdscripts/remix-auth.js

詳細

Remix 認証の設定

ユーザーが Remix に対してターミナル、MCP クライアント、または外部サービスを認証する必要がある場合に、このスキルを使用します。

認証モード

  • REST またはカスタムサービス：Authorization: Bearer <api_key> を https://api.remix.gg に送信します。
  • CLI：remix login を実行し、remix whoami で確認します。
  • MCP：REMIX_API_KEY を優先します。未設定の場合、サーバーは ~/.config/remix/credentials.json に保存された CLI の認証情報を再利用できます。

推奨するターミナルでの手順

curl -fsSL https://remix.gg/install.sh | bash
remix login
remix whoami

CLI は認証情報を ~/.config/remix/credentials.json に保存します。

API キーの手順

  1. Remix アカウントにログインします。
  2. https://remix.gg/api-keys にアクセスします。
  3. 新しい API キーを作成します。
  4. サーバー側のシークレットとして保存するか、REMIX_API_KEY をエクスポートします。
  5. ベース URL https://api.remix.gg を使用します。

確認

まず、次のいずれかを実行して確認します。

  • remix whoami
  • remix config where
  • GET /health
  • 認証済みのデータ取得をユーザーが明示的に希望する場合は GET /v1/games

無効な API キーのトラブルシューティング

  • REMIX_API_KEY が保存済みの CLI 認証情報を上書きしていないか確認します。
  • Authorization が Bearer <api_key> の形式になっているか確認します。
  • https://remix.gg/api-keys からキーをコピーし直し、必要に応じてローテーションします。
  • 現在の実行環境で、サービスが想定されているシークレット／環境変数を読み取っているか確認します。
  • リクエストがサーバー側から送信されており、ブラウザーコードを通じて公開されていないことを確認します。
  • remix whoami --json を実行して、解決された認証／設定のコンテキストを確認します。
  • ローカルのドキュメントと動作が一致しないように見える場合は、https://api.remix.gg/docs を正とします。

現在の認証モデル

サーバー API のベース URL：https://api.remix.gg

Remix サーバー API では、Remix アカウント設定から生成したベアラー API キーを使用します。

サポートされている認証ヘッダー：

  • 直接 HTTP を使用する場合は Authorization: Bearer <api_key>

CLI の実行時の優先順位は次のとおりです。

  1. 明示的に指定したコマンドフラグ
  2. 環境変数
  3. 保存済みの設定と認証情報
  4. デフォルト値

バックエンドはキーをユーザーに関連付け、ゲーム／バージョンの変更時に所有権を確認します。

API キーの取得方法

  1. Remix アカウントにログインします。
  2. https://remix.gg/api-keys にアクセスします。
  3. 新しい API キーを生成します。
  4. 一度だけコピーし、サーバー側のシークレットマネージャーに保存します。

必須ヘッダー

Authorization: Bearer <api_key>
Content-Type: application/json

セキュリティに関する注意事項

  • API キーをクライアント側のブラウザーコードで公開しないでください。
  • サーバーの環境変数またはシークレットマネージャーに保存してください。
  • https://remix.gg/api-keys からキーを取り消してローテーションしてください。
  • 使用すると lastUsed が自動的に更新されます。

API 認証ルール

  • https://remix.gg/api-keys で作成した API キーを使用します。
  • Authorization: Bearer <api_key> を使用します。
  • リクエストは https://api.remix.gg に送信します。
  • キーをブラウザー側のコードに含めないでください。
  • キーが漏えいした場合は、直ちにローテーションしてください。
  • アカウントが停止または削除されていない必要があります。

コメント

Markdown 対応