SikkerKey

公式

あなたのAIエージェントがSikkerKeyシークレットボールトを管理できるようにするMCPサーバーです。

sikkerkey.com で表示

SikkerKey MCPで何ができますか？

スコープ付きで監査されたAIエージェントIDを使用して、AIアシスタントをSikkerKey管理プレーンに接続します。

エージェントIDの確認 — whoamiを実行して、アクティブなエージェント、付与されたスコープ、プロジェクトアクセス、および最近の属性付き監査アクティビティを確認します。
シークレットの管理 — manage_secretsを使用して、許可されたプロジェクト内で管理シークレットを作成、ローテーション、スケジュールします。保存された平文を読み取ることはありません。
一時シークレットの発行 — manage_temporary_secretsを使用して、人間の受信者向けにワンタイムの自己破壊型シークレット共有を作成します。
マシンの監視 — manage_machinesを使用して、マシンIDの一覧表示、承認、拒否、名前変更、または失効を行います。
監査アクティビティの確認 — read_auditを使用して、アクティビティのクエリ、監査証跡のエクスポート、使用統計の確認を行います。

ドキュメント

vault

監査ログ
アラート
IP許可リスト
ゴミ箱
マシン
- 標準マシン
- 一時マシン
- 登録トークンと一時マシン

applications & projects

アプリケーション
スタンドアロンプロジェクト
シークレット
- 標準シークレット
- 構造化シークレット
- 管理シークレット
- リースシークレット
- 証明書シークレット
- カナリアシークレット
- TTLシークレット
アクセスポリシー

組織とチーム管理

組織
Vaultロール
アクセスロール
シングルサインオン（SSO）

account

サポート
設定

tools

CLI
MCPサーバー
SDK概要
SDK
- Kotlin SDK
- Go SDK
- Python SDK
- Node.js SDK
- .NET SDK
- PHP SDK
トンネル

security

セキュリティ概要
自社キー持ち込み（BYOK）
SikkerLinkセキュリティ

tools/MCPサーバー

MCPサーバー

MCP互換のAIクライアントを、専用・スコープ付き・監査済み・平文不可視のAIエージェントIDを通じてSikkerKeyに接続します。

22日前に更新

SikkerKey MCPサーバーは、MCP互換のAIクライアントをSikkerKey管理プレーンに接続します。AIアシスタントが、専用のAIエージェントIDを通じて、プロジェクト、シークレットメタデータ、ポリシー、マシン、アラート、監査アクティビティ、その他のvault操作の管理を支援できるようにします。

MCPサーバーは、保存されたシークレット値に対して読み取り不可です。意図的に提供した値の作成や置換は可能ですが、既存の保存済みシークレットの平文を取得できるツールはありません。

#仕組み

MCPサーバーは、AIクライアントの子プロセスとしてローカルで実行され、標準入出力を介して通信します。AIがSikkerKeyツールを呼び出すと、サーバーは選択されたAIエージェントIDで対応するSikkerKey APIリクエストに署名します。

ローカルID。 AIエージェントのEd25519秘密鍵は、お使いのコンピューター上で生成・保存されます。公開鍵のみがSikkerKeyに登録されます。
署名付きリクエスト。 すべてのリクエストは、HTTPメソッド、パス、タイムスタンプ、ワンタイムノンス、リクエストボディのハッシュを対象とします。変更または再生されたリクエストは検証に失敗します。
スコープ付き認可。 管理スコープはvault全体の操作を制御します。アクセスロールは、エージェントが到達できるアプリケーション、プロジェクト、シークレットタイプ、マシン操作、ポリシー機能を制御します。
ライブ作成者バインド。 エージェントの実効アクセスは、作成者の現在のアクセスを決して超えることはできません。作成者のアクセスが削減または削除された場合、エージェントの権限は次のリクエストで縮小されます。
完全な帰属。 成功したすべての変更は、AIエージェントのIDで監査ログに記録されます。

#要件

SikkerKey vault
vault内でAIエージェントをプロビジョニングする権限
MCP互換のAIクライアント
サポートされているデスクトップまたはサーバープラットフォーム

パッケージ化されたサーバーは、Linux（x64およびarm64）、macOS（x64およびAppleシリコン）、Windows（x64）をサポートしています。stdioでサーバーを起動できる任意のMCPクライアントで動作します。

生成された構成を持つクライアント

Claude Code
Claude Desktop
Cursor
Codex

#サーバーのインストール

npmでコマンドをグローバルにインストールします：

bashCopy

npm install -g sikkerkey-mcp

グローバルインストールなしでコマンドを実行することもできます：

bashCopy

npx sikkerkey-mcp <subcommand>

#AIエージェントのセットアップ

SikkerKeyダッシュボードで、マシン → AIエージェントを開き、AIエージェントのブートストラップを選択します。

エージェントが受け取る管理スコープとアクセスロールを選択し、ワンタイムブートストラップトークンをコピーします。

MCPサーバーを実行するコンピューターでIDを登録します。

ダッシュボードで保留中のAIエージェントを承認します。

AIクライアントの構成を生成し、指定された構成ファイルに貼り付けて、クライアントを再起動します。

接続されたクライアントにwhoamiを呼び出すよう依頼し、表示されるvault、スコープ、プロジェクトアクセス、エージェントステータスを確認します。

IDの登録

bashCopy

sikkerkey-mcp install <bootstrap-token>

登録時にオプションのローカル表示名を追加します：

bashCopy

sikkerkey-mcp install <bootstrap-token> -name="Operations assistant"

登録により、Ed25519キーペアがローカルで生成され、IDは以下に保存されます：

textCopy

~/.sikkerkey/agents/<agent-id>/

エージェントディレクトリ、IDファイル、秘密鍵は、制限付き権限で作成されます。ダッシュボードから承認するまで、エージェントは保留中のままです。

クライアント構成の生成

bashCopy

sikkerkey-mcp config claude-code
sikkerkey-mcp config claude-desktop
sikkerkey-mcp config cursor
sikkerkey-mcp config codex

各コマンドは、貼り付け可能な構成ブロックと、そのクライアントが使用する場所を出力します。生成された構成は、sikkerkey-mcp serveを起動し、SIKKERKEY_AGENT_IDでエージェントを選択します。

クライアント、自動化環境、または信頼境界ごとに、個別のAIエージェントIDを使用してください。これにより、権限と監査ログの帰属を簡単に確認できます。

#接続の確認

AIクライアントを再起動した後、whoamiを使用するよう依頼します。この呼び出しは常に利用可能で、以下を報告します：

AIエージェントIDと名前
承認および有効化ステータス
付与された管理スコープ
アクセスロールと到達可能なアプリケーションおよびプロジェクト
プロジェクトごとの機能
エージェントに帰属する最近の監査エントリ20件

機密セッションの開始時、または作成者のロール、エージェントのスコープ、アクセスロールを変更した後は、whoamiを使用してください。

#ツールが管理できるもの

希望する結果を通常の言語で説明できます。AIクライアントが適切なツールとアクションを選択し、SikkerKeyがすべてのリクエストに対してエージェントの現在の認可を独立してチェックします。

ツール	目的
whoami	アクティブなエージェント、権限、プロジェクトアクセス、ステータス、最近の帰属アクティビティを確認します。
manage_projects	エージェントが到達できるアプリケーションとプロジェクトを閲覧します。
manage_secrets	許可されたプロジェクト内で、シークレットメタデータ、値、バージョン、ローテーション、スケジュールされた管理シークレットを管理します。
manage_temporary_secrets	ワンタイムの自己破壊型シークレット共有を作成および検査します。
manage_policies	アクセスポリシーとそのシークレットバインディングを作成および管理します。
manage_canaries	カナリアシークレットを配置、構成、武装、または解除し、凍結されたプロジェクトを復旧します。
manage_machines	マシンIDを一覧表示、検査、承認、拒否、名前変更、または失効させます。
manage_project_machines	マシンをプロジェクトに接続し、シークレットごとの明示的な許可を管理します。
manage_enrollment	一時マシン用の登録トークンを発行、検査、失効させます。
manage_ai_agents	AIエージェントのライフサイクル状態、名前、承認を検査および管理します。
manage_alerts	どの監査アクションがアラートをトリガーするかを選択します。
manage_webhooks	署名付きアラート配信ウェブフックを作成および管理します。
manage_ipallowlist	マシン認証と登録で使用されるvault IP許可リストを管理します。
manage_trash	ソフト削除されたシークレットを一覧表示、復元、または完全に削除します。
read_audit	アクティビティを照会し、監査証跡をエクスポートし、使用統計を確認します。
support	サポートチケットを開く、読む、返信する、評価します。
manage_sdks	公式ランタイムSDKのインストールおよびクイックスタートガイドを参照します。

AIクライアントに表示されるツールは安定していますが、個々のアクションは、選択されたエージェントが呼び出し時に必要なスコープとプロジェクト機能を持っている場合にのみ成功します。

#管理スコープとプロジェクトアクセス

AIエージェントは、2つの補完的な権限セットを受け取ります。

管理スコープ

管理スコープは、マシン、AIエージェント、登録、監査、アラート、ウェブフック、IP許可リスト、ゴミ箱、サポートなどのvault全体の領域を制御します。読み取りスコープと書き込みスコープは、機能がサポートしている場合に個別に付与できます。

アクセスロール

アクセスロールはプロジェクトプレーンを制御します。エージェントに表示されるアプリケーションとスタンドアロンプロジェクト、および各プロジェクトで実行できる操作（許可されたシークレットタイプ、マシン接続と許可、ポリシー、カナリアを含む）を決定します。

SikkerKeyは、すべてのリクエストで両方の権限セットを作成ユーザーの現在のアクセスと交差させます。エージェントはMCPツールを使用して、自身の管理スコープやアクセスロールを置き換えることはできません。

意図したワークフローをカバーする最小のスコープとプロジェクト機能セットから始めてください。エージェントが本当に必要とする場合に、後でダッシュボードからアクセスを追加します。

#保存されたシークレット値の処理方法

MCPサーフェスは、シークレット管理とランタイムシークレット取得を分離します。

メタデータ読み取り。 シークレットの一覧表示、詳細の表示、バージョン履歴の表示では、識別子、名前、タイプ、フィールド名、メモ、バージョン、タイムスタンプが返されます—保存された値は返されません。
作成と更新。 作成または置換のために意図的に値を提供すると、その値はAIクライアントを通過して署名付き書き込みリクエストに入り、SikkerKeyによって暗号化されます。レスポンスはメタデータを返し、値をエコーしません。
サーバー生成ローテーション。 ローテーションと管理シークレットの作成は、SikkerKey内で新しい値を生成できます。AIは新しいバージョンとスケジュールメタデータを受け取り、生成された平文は受け取りません。
ランタイム取得。 アプリケーションは、公式SDKまたはCLIを使用して、個別のマシンIDでシークレットを読み取ります。AIエージェントIDはマシンとして認証できません。

意図的にそのAIクライアントにシークレット書き込みで送信させたい場合のみ、平文値をAI会話に配置してください。保存後、MCPは値を読み戻すことはできません。

ワンタイム認証情報

一部の管理アクションは、セットアップを完了できるように、新しく生成された認証情報を一度だけ返します。これには、登録トークン、新しいウェブフック署名シークレット、一時シークレット共有のトークンとパスフレーズが含まれます。作成時に保存または配信してください。後の一覧表示や詳細アクションではこれらは明らかにされません。

一時シークレット共有は、人間の受信者を対象としています。リンクを開くとワンタイム表示が消費されるため、AIはリンクを開くのではなく、共有詳細を配信する必要があります。

#監査、承認、失効

SikkerKeyは、各管理アクションをAIエージェントのIDと名前で記録します。ダッシュボードの監査ログまたはread_auditを通じてアクティビティを確認できます。アラートルールとウェブフックは、選択したエージェントアクションが発生したときに通知できます。

AIクライアントは、ツール呼び出しを送信する前に、独自の確認プロンプトを制御します。人間のレビューに値する変更（特に完全削除、アクセス変更、マシン失効、ポリシー変更、IP許可リスト変更、外部配信メッセージ）には確認を要求するようにクライアントを構成してください。

エージェントの無効化または失効

無効化。 エージェントのスコープとアクセスロールを保持したまま、エージェントの署名付きリクエストを即座に拒否し、後で再有効化できるようにします。
失効。 サーバー側のAIエージェントIDを削除し、ローカルキーペアを将来のリクエストに使用できないようにします。

どちらも次のリクエストで有効になります。サーバー側のライフサイクルはダッシュボードから管理します。失効後、ローカルIDスロットを削除します：

bashCopy

sikkerkey-mcp revoke <agent-id>

ローカルの失効コマンドは、このコンピューターからファイルを削除します。SikkerKeyダッシュボードでAIエージェントを失効させるわけではありません。

#複数のAIエージェントを使用する

1台のコンピューターには複数のAIエージェントIDを保存できます。登録済みのローカルIDを一覧表示するには次のコマンドを使用します:

bashCopy

sikkerkey-mcp whoami

生成されたクライアント設定では、IDごとに個別のサーバーエントリが作成されます。サーバーを手動で設定する場合は、SIKKERKEY_AGENT_ID をクライアントが使用する正確なエージェントに設定してください:

jsonCopy

{
  "mcpServers": {
    "sikkerkey": {
      "command": "sikkerkey-mcp",
      "args": ["serve"],
      "env": {
        "SIKKERKEY_AGENT_ID": "agent_..."
      }
    }
  }
}

インストールされているIDが1つだけの場合は、サーバーが自動的にそれを選択します。複数のIDが存在し、エージェントIDが設定されていない場合は、暗黙的に選択するのではなく、起動が停止して選択を求められます。

#環境変数

変数	目的
SIKKERKEY_AGENT_ID	MCPサーバーが使用するローカルAIエージェントIDを選択します。
SIKKERKEY_HOME	ローカルのSikkerKey IDルートをデフォルトの ~/.sikkerkey から変更します。

#コマンドリファレンス

コマンド	目的
sikkerkey-mcp install	ワンタイムダッシュボードトークンから新しいローカルAIエージェントIDを登録します。
sikkerkey-mcp whoami	ローカルに登録されたAIエージェントIDを一覧表示します。
sikkerkey-mcp config	Claude Code、Claude Desktop、Cursor、またはCodexの設定を出力します。
sikkerkey-mcp serve	stdio経由でMCPサーバーを実行します。
sikkerkey-mcp revoke [agent-id]	ローカルAIエージェントIDのスロットを削除します。
sikkerkey-mcp	MCPサーバーを実行します。serveと同等です。

#ソースコードとライセンス

SikkerKey MCPサーバーはMITライセンスの下で完全にオープンソースです。認証、IDストレージ、プロトコル処理、ツールスキーマ、およびリクエスト動作は、SikkerKeyOfficial GitHub組織を通じて確認できます。

このページの内容

仕組み
要件
サーバーのインストール
AIエージェントのセットアップ
接続の確認
ツールが管理できるもの
管理スコープとプロジェクトアクセス
保存されたシークレット値の処理方法
監査、承認、失効
複数のAIエージェントを使用する
環境変数
コマンドリファレンス
ソースコードとライセンス