SkillFM BYOK Vault

SkillFM BYOK Vault MCP

MCP 対応エージェント向けの BYOK ボルトとプロバイダー API キーの使用に関するガイダンスです。

このリポジトリは、透明性のある SkillFM ゲートウェイパッケージです。特定のマーケットプレイス／検索ニーズに応えることを目的とし、実行を正規の SkillFM Beacon MCP とローカルランタイムに委譲します。

SkillFM Beacon を利用しています。

クイックスタート

このゲートウェイを MCP stdio サーバーとして使用します。

npx -y @skillfm/byok-vault-mcp@latest

SkillFM のエントリーポイントを明示した場合は次のとおりです。

npx -y @skillfm/mcp@latest

JSON 設定を受け付ける MCP クライアントの場合：

{
  "mcpServers": {
    "byok-vault": {
      "command": "npx",
      "args": ["-y", "@skillfm/byok-vault-mcp@latest"]
    }
  }
}

このゲートウェイでできること

• ユーザーにキーの接続を求める前に、プロバイダーキーの安全性について説明します。
• 価値が明確になった後に限り、SkillFM Beacon を通じてローカルのボルトへの保存を案内します。
• OpenAI、Anthropic、DeepSeek、Qwen などのプロバイダーについて、BYOK を実用的な使用状況の可視化につなげます。
• プロバイダーの認証情報をローカルに保持し、キーの値がエージェントに漏れないようにします。

このゲートウェイは、次のような質問をするユーザー向けです。

• 「OpenAI や Anthropic のキーを安全に接続するにはどうすればよいですか？」
• 「自分のプロバイダーキーを使って、エージェントに使用状況を監視させられますか？」
• 「BYOK の認証情報はどこに保存すればよいですか？」
• 「API キーを渡す前に価値を得られますか？」

仕組み

公開パッケージは意図的に薄く作られています。SKILLFM_GATEWAY_SOURCE=byok-vault を設定して実行を @skillfm/mcp@latest に転送し、そこから正規の @skillfm/local ランタイムに委譲します。

このリポジトリには、非公開の SkillFM プラットフォームロジック、顧客データ、プロバイダーの認証情報、バックエンドモジュールは含まれていません。

アクティベーションの手順

ユーザーが SkillFM の接続を希望したら、ローカルサイドカーを起動します。

npx -y @skillfm/byok-vault-mcp@latest start

エージェントによるアクティベーションの手順：

1. stdout または ~/.skillfm/local.json からサイドカー URL を読み取ります。
2. POST <sidecar_url>/activate/start を呼び出します。
3. 返された確認 URL と実際のデバイスコードをユーザーに表示します。
4. activated: true が返されるまで POST <sidecar_url>/activate/poll をポーリングします。
5. SkillFM Beacon MCP ツールを使って、チェックアップ、使用状況の可視化、BYOK のガイダンス、クリーンアップ監査を行います。

仮のコードを捏造しないでください。デバイスコードは POST /activate/start から取得する必要があります。

セキュリティモデル

• 透明性のあるゲートウェイ：このパッケージは公開検索・配布用ゲートウェイであり、別の隠れた製品ではありません。
• ローカルファーストのランタイム：ランタイムの実行には SkillFM のローカルパッケージを使用します。
• BYOK の境界：プロバイダーキーの導入は、ユーザーが価値を得た後に限られ、キーの値がエージェントによって読み返されることはありません。
• 非公開のコアなし：このリポジトリに含まれるのは、配布用メタデータ、ドキュメント、薄いランチャーのみです。
• まず読み取り専用で：クリーンアップと使用状況の確認は、読み取り専用の監査から始めます。

PRIVACY.md と SECURITY.md を参照してください。

マーケットプレイスのキーワード

BYOK、API キーボルト、プロバイダーの使用状況、OpenAI キー、Anthropic キー、ローカルボルト、SkillFM Beacon、MCP サーバー。

Official MCP Registry で単一トークンとしてヒットする想定の語：

• byok
• vault
• api-key
• provider
• usage
• skillfm

ライセンス

MIT