> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/developer-and-mcp/ai-agent-access/keeper-mcp-setup.md).

# Keeper MCPのセットアップ

MCP対応のAIクライアントをKeeperデスクトップに接続

Keeper MCPは、MCP対応のAIクライアントをKeeperデスクトップに接続します。ローカルサーバーは**stdio**トランスポートを使用します。Keeperデスクトップが、接続に必要なボルトセッションとAIエージェントアクセスの制御を担います。

## 要件 <a href="#prerequisites" id="prerequisites"></a>

* 開発者センターとAIエージェントアクセスの制御が利用できるKeeperデスクトップ
* サインイン済みのKeeperボルトセッション
* stdioを使用するMCPサーバーに対応した、ローカルのAIクライアント
* 組織のポリシーに基づく、AIエージェントアクセスの使用権限

エージェントを使用する前に、[AIエージェントアクセス](https://docs.keeper.io/keeperpam/jp/developer-and-mcp/ai-agent-access.md)で、必要な機能とリソースのスコープを構成してください。

## Keeper MCPのインストール <a href="#install-keeper-mcp" id="install-keeper-mcp"></a>

1. **\[開発者センター]** > **\[ローカルツール]** を開きます。
2. **AIエージェント向けMCP**で **\[セットアップ]** をクリックします。または、**\[AIエージェントアクセス]** を開いて **\[MCPセットアップ]** をクリックします。
3. **\[Keeper MCPに接続]** で **\[インストーラーをダウンロード]** をクリックします。
4. AIクライアントを実行するワークステーションに、Keeper MCPをダウンロードしてインストールします。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-c879ab74bbd475cdd2ca69e9c661c32e38f0a521%2FScreenshot%202026-11-05%20at%201.34.12%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

## AIクライアントの構成 <a href="#configure-the-ai-client" id="configure-the-ai-client"></a>

1. **\[Keeper MCPに接続]** で **\[コピー]** をクリックして、クライアント構成の手順をコピーします。
2. コピーした手順をAIクライアントに貼り付け、Keeper MCPサーバーを構成するよう依頼します。クライアントが構成を編集できない場合は、そのクライアントのドキュメントに従って、サーバーを手動で追加します。
3. Keeperデスクトップに表示されるサーバーの詳細を使用します。
   * **名前:** `keeper`
   * **トランスポート:** `stdio`
   * **コマンド:** インストールされた `keeper-mcp` 実行ファイルの絶対パス
4. クライアントでサーバーを有効にします。
5. セットアップのダイアログの指示に従って、AIクライアントを再起動します。
6. Keeperデスクトップで **\[完了]** をクリックします。

コマンドのパスはワークステーションごとに異なります。macOSのスクリーンショットには、`/Users/<username>/.keeper/mcp/keeper-mcp` のように、ユーザーのホームディレクトリ配下のパスが表示されています。他のユーザーのスクリーンショットのパスではなく、ご自身のセットアップダイアログからコピーした正確なパスを使用してください。MCPの構成形式とファイルの場所は、クライアントによって異なります。

## ボルト接続の承認 <a href="#approve-the-vault-connection" id="approve-the-vault-connection"></a>

Keeper MCPがボルトセッションを要求すると、Keeperデスクトップに「Keeper MCPサーバーによるボルトの使用を許可しますか？」と表示されます。このプロンプトには、アプリケーション、要求の目的、バージョンが表示されます。

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-13a650e676fb3e684af95e4935535fb3c0f6dbe4%2FScreenshot%202026-11-05%20at%201.35.37%E2%80%AFPM%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

1. アプリケーションと、記載された目的を確認します。
2. 自分で開始した接続の場合は **\[許可]** を、心当たりのない要求の場合は **\[拒否]** をクリックします。
3. Keeperにそのアプリケーションの承認を記憶させる場合にのみ、**\[このアプリを常に許可]** を選択します。

この同意プロンプトで認可されるのは、アプリケーションによるボルトへの接続のみです。**AIエージェントアクセス**の機能スイッチや、フォルダ・レコードのガードレールの代わりにはなりません。接続を確立するために、マスターパスワードや保存済みのシークレット値をAIとの会話に貼り付けないでください。

## 接続の確認 <a href="#verify-the-connection" id="verify-the-connection"></a>

AIクライアントで `keeper` MCPサーバーが接続済みと表示されていることを確認します。Keeperデスクトップでは、**AIエージェントアクセス**タブの **\[接続済みエージェント]** の表示を確認します。

最初は、以下のようなメタデータのみを取得するリクエストを試します。

```
List the PAM Database records available to you in my allowed folders.
Return record titles and types only. Do not retrieve credentials or run queries.
```

このリクエストには、**レコードの読み取り**、適切な検出用ガードレール、対象レコードを含むスコープが必要です。接続済みのサーバーでも、許可された機能がなければ、依頼したタスクに使えるツールがない場合があります。

## トラブルシューティング <a href="#troubleshooting" id="troubleshooting"></a>

| 症状              | 確認事項                                                                                            |
| --------------- | ----------------------------------------------------------------------------------------------- |
| サーバーが起動しない      | Keeper MCPがインストールされており、コマンドに実行ファイルの絶対パスが指定されていることを確認します。クライアントがstdioを使用し、サーバーが有効になっていることも確認します。 |
| ボルト接続が拒否される     | Keeperデスクトップにサインインしていること、同意の要求を許可したことを確認します。                                                    |
| 必要な機能が利用できない    | AIエージェントアクセスのスイッチ、機能のステータススイッチ、ガードレール、エンタープライズの制限を確認します。                                        |
| 期待するレコードが表示されない | 該当する機能のフォルダとレコードのスコープを確認します。                                                                    |
| データベースクエリが拒否される | データベースクエリの権限、リソースのスコープ、PAMアクセスの要件、データベースアカウントの権限を確認します。                                         |
| 書き込みクエリが拒否される   | 読み取り専用のワークフローを維持するか、書き込みクエリを許可することが適切かどうかを慎重に確認します。ガードレールを回避しないでください。                           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/keeperpam/jp/developer-and-mcp/ai-agent-access/keeper-mcp-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
