AIエージェント向けモデルコンテキストプロトコル (MCP) – Node版

Nodeを使用して、KeeperシークレットマネージャーをAIエージェントに統合

Keeperシークレットマネージャー (KSM) でAIエージェントとの連携機能を利用するには、ロールに「アプリケーションの作成およびシークレットの管理」のポリシーが設定されている必要があります。

この機能を有効にすると、KeeperとサードパーティのAIツールやサービスとの連携を許可することになります。Keeperはゼロトラストアーキテクチャを維持しており、ボルト内のレコードにはアクセスせず、処理も行いません。

ただし、サードパーティのツールと共有されたデータについては、それぞれのツールのセキュリティ、プライバシー、コンプライアンスの方針が適用され、Keeperの方針は適用されません。これらの連携の設定、管理、監査は、組織の内部ポリシーや適用される法規制に従って、利用者自身の責任で行ってください。

リスクを最小限に抑えるために、AIエージェントに付与するアクセス権は、特定の事例の達成に必要な最小限のフォルダに限定するようにしてください。

モデルコンテキストプロトコル (MCP) によるAIエージェント統合

Keeperシークレットマネージャーはモデルコンテキストプロトコル (MCP) を通じてAIエージェントと統合できます。これにより、AIエージェントがKeeperのボルト内の特定のフォルダにだけ安全にアクセスできるようになります。この仕組みは、AIエージェントにアクセスを許可する情報を明確に制限できるゼロトラスト型の設計です。

MCPは、AIアシスタントとKeeperシークレットマネージャーの間にセキュアな橋渡し役として機能します。これにより、AIがパスワードや秘密情報を使って作業を支援できるようになります。また、機密性の高い操作には人間による確認を取り入れることで、最高レベルのセキュリティ基準を維持します。

GitHub: https://github.com/Keeper-Security/keeper-mcp-node

主なメリット

• ゼロトラストアーキテクチャ: AIエージェントにはボルト内の特定フォルダのみを割り当て
• ユーザーの承認: 機密操作時にユーザー確認を要求
• エンタープライズ対応: 監査ログやコンプライアンス機能を完備
• マルチプラットフォーム対応: Linux、macOS、Windowsで動作

AIアシスタントでできること

シークレット操作

• シークレットの一覧表示: アクセス可能なシークレットを確認
• シークレットの検索: タイトル、URL、ユーザー名などで検索
• シークレットの取得: 特定のシークレット値を取得 (マスク解除には確認が必要)
• シークレットの作成: 新しいシークレットエントリを登録
• シークレットの更新: 既存の情報を修正
• シークレットの削除: シークレットを削除 (確認あり)

ファイル管理

• 添付ファイルの一覧表示: シークレットに添付されたファイルを確認
• ファイルのアップロード: ファイルをシークレットに添付
• ファイルのダウンロード: 添付ファイルを取得
• ファイルの削除: 添付ファイルを削除

ユーティリティ機能

• パスワード生成: 条件を指定して安全なパスワードを生成
• TOTPコードの取得: 現在のワンタイムパスワードを取得
• KSM表記法の実行: Keeper表記法を使って高度な操作を実行
• ヘルスチェック: サーバーの状態や接続状況を確認

セットアップとインストール

1. シークレットマネージャーアプリケーションの作成

Keeperシークレットマネージャーで、新しいアプリケーションを作成するか、既存のアプリケーションを使用します。

アプリケーションを作成してフォルダへアサイン

2. デバイストークンの作成

最初に表示されるデバイストークンは破棄し、[デバイスを追加] をクリックして、新しいBase64構成データを生成します。この構成情報は、AIエージェントに提供されます。

Base64トークンの生成

3. MCPサーバーを構成

オプションA: 構成ファイル (推奨)

以下のいずれかの場所にダウンロードした構成ファイルを配置します。

• ~/.keeper/ksm-config.json (推奨)
• ./ksm-config.json (カレントディレクトリ)

オプションB: ワンタイムトークン

ワンタイムトークンがある場合

export KSM_TOKEN="US:YOUR_ONE_TIME_TOKEN_HERE"

このトークンにより、サーバーが自動的に構成ファイルを生成・保存します。

4. サーバーのテスト

以下のコマンドでサーバーを直接起動して動作確認します。

npm start

Keeper MCP server is running と表示されます。

MCPクライアントとの連携例

Claude Desktop

Claude Desktopの構成ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "keeper": {
      "command": "node",
      "args": ["/path/to/keeper-mcp-node/dist/index.js"]
    }
  }
}

Postman

1. API Networkタブに移動します。
2. MCPリクエストを作成または選択します。
3. stdio接続を以下のように設定します。

   • Command: node
   • Arguments: /path/to/keeper-mcp-node/dist/index.js

その他のMCP対応クライアント

stdio経由で通信するため、以下のように実行することで任意のMCP対応クライアントと連携可能です。

node /path/to/keeper-mcp-node/dist/index.js

利用可能なツール

シークレット操作

ksm_list_secrets

アプリケーションからアクセス可能なすべてのシークレットを一覧表示します (メタデータのみ)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_list_secrets",
    "arguments": {}
  }
}

レスポンス

[
  {
    "uid": "XXXXXXXXXXXXXXXXXXXXXX",
    "title": "My Secret",
    "type": "login"
  }
]

ksm_get_secret

UIDまたはタイトルを指定して、完全なシークレットを取得します (機密フィールドはデフォルトで伏字となります)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_get_secret",
    "arguments": {
      "identifier": "My Secret",
      "unmask": false
    }
  }
}

ksm_search_secrets

タイトル、メモ、または他のフィールド内容でシークレットを検索します。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_search_secrets",
    "arguments": {
      "query": "database"
    }
  }
}

ksm_create_secret

Keeperシークレットマネージャーに新しいシークレットを作成します (確認が必要)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_create_secret",
    "arguments": {
      "title": "New Database Credentials",
      "type": "login",
      "fields": {
        "login": "admin",
        "password": "secure_password",
        "url": "https://db.example.com"
      },
      "notes": "Production database",
      "folderId": "FOLDER_UID"
    }
  }
}

ksm_update_secret

既存のシークレットを更新します (確認が必要)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_update_secret",
    "arguments": {
      "identifier": "My Secret",
      "updates": {
        "title": "Updated Title",
        "fields": {
          "password": "new_password"
        }
      }
    }
  }
}

ksm_delete_secret

Keeperシークレットマネージャーからシークレットを削除します (確認が必要)

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_delete_secret",
    "arguments": {
      "identifier": "My Secret"
    }
  }
}

ksm_get_field

指定されたシークレットから特定のフィールド値を取得します。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_get_field",
    "arguments": {
      "identifier": "My Secret",
      "field": "password"
    }
  }
}

一般的なフィールド名

• password: パスワードフィールド
• login: ユーザー名またはメールアドレス
• url: ウェブサイトのURL

カスタムフィールドラベルにも対応しています。

フォルダ操作

ksm_list_folders

Keeperシークレットマネージャーでアクセス可能なすべてのフォルダを一覧表示します。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_list_folders",
    "arguments": {}
  }
}

ksm_create_folder

新しいフォルダを作成します (確認が必要。親の共有フォルダを指定する必要があります)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_create_folder",
    "arguments": {
      "name": "Development Secrets",
      "parentFolderId": "PARENT_FOLDER_UID"
    }
  }
}

ksm_create_folder

新しいフォルダを作成します (確認が必要。親の共有フォルダを指定する必要があります)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_create_folder",
    "arguments": {
      "name": "Development Secrets",
      "parentFolderId": "PARENT_FOLDER_UID"
    }
  }
}

ksm_delete_folder

フォルダを削除します (確認が必要)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_delete_folder",
    "arguments": {
      "folderId": "FOLDER_UID",
      "force": false
    }
  }
}

ksm_upload_file

シークレットにファイルを添付します (確認が必要)。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_upload_file",
    "arguments": {
      "identifier": "My Secret",
      "filePath": "/path/to/certificate.pem",
      "fileName": "server-cert.pem"
    }
  }
}

ksm_download_file

シークレットから添付ファイルをダウンロードします。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_download_file",
    "arguments": {
      "identifier": "My Secret",
      "fileId": "certificate.pem",
      "outputPath": "/tmp/downloaded-cert.pem"
    }
  }
}

ユーティリティ

ksm_generate_password

安全なパスワードを生成します。

生成したパスワードをAIに表示せずに新しいシークレットとして保存することもできます。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_generate_password",
    "arguments": {
      "length": 24,
      "includeUppercase": true,
      "includeLowercase": true,
      "includeNumbers": true,
      "includeSpecial": true,
      "saveToSecret": {
        "title": "Generated API Key",
        "login": "api-user",
        "url": "https://api.example.com",
        "notes": "Auto-generated API key"
      }
    }
  }
}

ksm_get_totp_code

TOTPが設定されたシークレットの現在のコードを取得します。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_get_totp_code",
    "arguments": {
      "identifier": "My 2FA Secret"
    }
  }
}

ksm_get_server_version

KSM MCPサーバーの現在のバージョンを取得します。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_get_server_version",
    "arguments": {}
  }
}

ksm_health_check

MCPサーバーとKSMとの接続状態をチェックします。

リクエスト

{
  "method": "tools/call",
  "params": {
    "name": "ksm_health_check",
    "arguments": {}
  }
}

トラブルシューティング

エラー: No Keeper Secrets Manager configuration found

• 構成ファイルがサポートされている場所にあるか確認する
• JSON形式が正しいことを確認する
• ファイルのパーミッションが適切で、ユーザーが読み取れる状態であることを確認する

エラー: Failed to initialize KSM

• 構成ファイルに必要な項目がすべて含まれているか確認する
• アプリケーションが対象の共有フォルダまたはシークレットにアクセス可能であることを確認する
• デバイスがKeeperで無効化されていないことを確認する

接続に関する問題

• インターネット接続があることを確認する
• 組織内でIP制限が設定されていないか確認する
• Keeperのサブスクリプションにシークレットマネージャーが含まれていることを確認する

---

追加のセットアップ手順については、こちらのリポジトリをご参照ください。