Keyfactor Command MCP Server

⚠️プレビュー：本番環境での使用は推奨されません

Command-MCP

Keyfactor Analytics & AI チームの Python SDK を基盤として構築された、Command 用の MCP サーバーです。このプレビュー版ソフトウェアは実験的なものであり、AI ツールに本番データへのアクセスを許可しないことをおすすめします。このソフトウェアは現状有姿で提供され、この MCP サーバーにはサポート SLA が適用されません。

前提条件

1. Keyfactor Command バージョン 11 以降
2. Claude for Desktop
3. Python 3

操作と必要な権限

1. get_license。Keyfactor Command の機能ライセンスに関する情報を取得し、基本的な接続テストとして機能します。必要な権限：なし。
2. get_certificate_details_by_id。証明書 ID を指定して、証明書と関連するメタデータを取得します。Command Risk Intelligence が有効な場合は、リスクデータも含まれます。必要な権限：Certificates: Collections: Read。
3. enroll_certificate。指定したサブジェクトと DNS SAN を使用して PFX 登録を行います。必要な権限：Certificates: Enrollment: PFX。
4. enroll_csr。MCP クライアントに提供された CSR を使用して登録を行います。必要な権限：Certificates: Enrollment: CSR。
5. revoke_certificate。証明書 ID を指定して証明書を失効させます。必要な権限：Certificates: Collections: Revoke。
6. get_metadata_fields。Command に存在するすべてのメタデータフィールドと定義の一覧を取得します。必要な権限：Metadata: Types: Read。
7. query_certificates。一致する証明書を取得するための証明書検索クエリを実行します。並べ替えなどの追加オプションも利用できます。必要な権限：Certificates: Collections: Read。
8. get_module_info_for_mcp。Command API は使用しません。Command MCP Server を説明する静的な定義を返します。

インストール

1. このリポジトリをダウンロードします。以下の手順では、"C:\mcp." にダウンロードしたものとします。
2. 使用する操作に必要な権限を持つ Command アカウントを作成するか、既存のアカウントを特定します。
3. 環境変数を C:\mcp\mcpenv.txt に記述します。Command 環境と作成したアカウントの情報を使用し、1 行に 1 つずつ記述します：
   基本認証：
     KEYFACTOR_HOSTNAME='...'
     KEYFACTOR_TOKEN='...'   KEYFACTOR_TEMPLATE='WebServer'
     KEYFACTOR_CA='kftrain.keyfactor.lab\keyfactor-KFTRAIN-CA'
   OAuth：
     KEYFACTOR_HOSTNAME=...
     KEYFACTOR_URLBASE=Keyfactor/API
     COMMAND_IDP_TOKENURL=...
     COMMAND_IDP_CLIENTID=...
     COMMAND_IDP_CLIENTSECRET=...
     COMMAND_IDP_AUDIENCE=...
     KEYFACTOR_TEMPLATE=Server_tlsServerAuth-1y
     KEYFACTOR_CA=http://ejbca-ca.jdk-2025-may.svc.cluster.local:8082/ejbca\\Sub-CA
4. 次のコマンドを実行します（pip が Python 2.x を参照している場合は、"pip3" を使用する必要があるかもしれません）：
   pip install requests oauthlib httpx attrs python-dateutil uv
5. 次のコマンドを CLI から実行し、「Initializing MCP server」と表示されることを確認します：
   uv --directory C:\\mcp run --env-file=C:\\mcp\\mcpenv.txt commandmcp.py
6. Claude で Ctrl+Comma を押して設定を開き、developer に移動して「edit config」をクリックします。開いたフォルダーにある claude_desktop_config.json に次の内容を記述します：
   { "mcpServers": { "keyfactorCommand": { "command": "uv", "args": [ "--directory", "C:\\mcp", "run", "--env-file=C:\\mcp\\mcpenv.txt", "commandmcp.py" ] } } }
7. Claude で Settings->Integration に移動し、有効にする操作と Claude が許可を求めるタイミングを選択します。最低限、登録機能と失効機能を使用する前に Claude が確認を求めるようにすることをおすすめします。

メモ

• ⚠️ このプレビュー版ソフトウェアは実験的なものとみなされており、本番環境での使用は推奨されません。
• セキュリティ上の理由から、この MCP サーバーは Claude for Desktop などのクライアント向けに、ローカル MCP サーバーとしてデプロイされます。
• 登録に使用するテンプレートと CA のパラメーターは、MCP クライアントが意図した登録タイプのみを対象とするよう、MCP サーバーの環境変数として指定する必要があります。テンプレートと CA では、権限と可用性を設定する必要があります。
• 実装されている操作の詳細については、「commandmcp.py」のコメントを確認するか、MCP クライアントに問い合わせてください。
• Keyfactor Command と必要な権限については、Keyfactor Command リファレンスガイドを参照してください。