MCP設定ガイド

Overview

QueryPie ACP (Access Control Platform) Community Edition 11.5.0にRemote MCP (Model Context Protocol) Server機能が追加されました。 これにより、様々なAIコーディングアシスタントでLLMを使用して、QueryPie ACPのアクセス制御下で安全に様々な作業を実行できるようになりました。

サポートされているAIコーディングアシスタント

• Claude Code 
• gemini-cli 
• Cursor 
• Windsurf 

前提条件

• 実行中のQueryPie ACP Community Edition 11.5.0以上
• QueryPie ACP Community Editionに作成された有効なユーザーアカウント

Integration

MCP Server URL

AIコーディングアシスタントを設定するには、MCP Serverの役割を果たすQueryPie ACPのURLを入力する必要があります。 このMCP Server URLの設定は、複数のAIコーディングアシスタントで共通して行う必要があります。

{QueryPie_URL}/api/mcp

{QueryPie_URL}は実行中のQueryPie ACP Community Editionのアドレスです。

例) https://querypie.example.com/api/mcp

Claude Code

1. MCPサーバーアドレスを追加します。

claude mcp add querypie --transport http {QuerPie_URL}/api/mcp

例) claude mcp add querypie --transport http https://querypie.example.com/api/mcp

2. OAuthログインを実行します。

まず、/mcpを入力して、現在設定されているMCP Serverの状態を確認します。

リストからquerypieを選択します。 その後、Authenticateを選択します。

ブラウザが開いたら、QueryPieログインページでログインします。 正常にログインすると、ブラウザに「Authentication Successful」メッセージが表示されます。

Claude Codeでも「Authentication successful. Connect to querypie.」メッセージが表示されます。

3. MCP接続を確認します。

claude codeを実行していない状態であればclaude mcp listコマンドでmcp接続を確認できます。

クエリを通じて作業を実行してみます。

使用可能なツールの確認ができれば、進行に関するクエリが出力されます。 ‘yes’または’yes, and don’t ask again for querypie -…’を選択します。

認証管理: Claude Codeで/mcpコマンドを実行して認証状態を管理できます。 認証トークンは自動的に更新されます。 「Clear authentication」オプションで認証を解除できます。

gemini-cli

1. 設定ファイルを編集してMCPサーバーアドレスを追加します。

設定ファイル編集: ~/.gemini/settings.jsonファイルを編集します。

{
  "mcpServers": {
    "acp": {
      "httpUrl": "https://acp.example.com/api/mcp"
    }
  }
}

OAuthをサポートするサーバーは自動的に検出されます。

2. OAuthログインを実行します。

Gemini CLIで/mcp authコマンドを使用して認証を進めます。

 /mcp auth acp

ブラウザが開いたら、QueryPieログインページでログインします。 正常にログインすると、ブラウザに「Authentication Successful」メッセージが表示されます。

ブラウザが自動的に開かない場合は、上図のように画面上に表示されるアドレスをブラウザに貼り付けて進めることもできます。

Cursor

1. 設定ファイルを編集してMCPサーバーアドレスを追加します。

設定ファイル編集: ~/.cursor/mcp.jsonファイルを作成または編集します:

{
  "mcpServers": {
    "acp": {
      "url": "https://querypie.example.com/api/mcp"
    }
  }
}

2. OAuthログインを実行します。

• Cursorを再起動するか、MCPサーバーリストを更新します。
• MCPサーバーリストでacpサーバーの認証ボタンをクリックします。
• Webブラウザが開き、ACPのログインページが表示されます。
• ACPで認証を完了すると、CursorでMCP機能を使用できます。

3. MCP接続を確認します。

Cursor SettingsでMCPツールが正しく連携されているか確認します。

Windsurf

1. 設定ファイルを編集してMCPサーバーアドレスを追加します。

設定ファイルを作成または編集します: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "acp": {
      "serverUrl": "https://querypie.example.com/api/mcp"
    }
  }
}

2. OAuthログインを実行します。

• Windsurfを再起動するか、MCPサーバーリストを更新します。
• MCPサーバーリストでacpサーバーの認証ボタンをクリックします。
• Webブラウザが開き、ACPのログインページが表示されます。
• ACPで認証を完了すると、WindsurfでMCP機能を使用できます。

3. MCP接続を確認します。

Windsurf Agents画面でMCPツールが正しく連携されているか確認します。

QueryPie ACP Community Edition MCP serverのサポートTool一覧

DAC (Database Access Control)

データベースアクセスおよびクエリ実行関連のツールです。

SAC (Server Access Control)

サーバーアクセスおよびSSHシェルセッション関連のツールです。

KAC (Kubernetes Access Control)

Kubernetesクラスター管理およびリソース操作ツールです。

User Tools

一般ユーザーが割り当てられた権限内で使用できるツールです。

Admin Tools

管理者権限が必要なツールです。

権限およびセキュリティ

• 各ToolはACP権限システムに従います。
• ACPで各利用者に提供されるDACのDB接続、Privilege Typeに応じたアクセス制御ポリシー、SACのサーバーアクセス制御ポリシー、KACのアクセス制御ポリシーに従い、自分に付与された権限範囲内でのみToolを使用できます。
• すべてのTool呼び出しはACPの監査ログに記録されます。
• ACPのIPアクセス制御ポリシーが適用されます。

トラブルシューティング

接続失敗

• ACP APIサーバーが実行中か確認
• ネットワーク/ファイアウォール設定を確認

権限エラー

• 該当Toolに必要な権限があるか確認
• ロールが正しく割り当てられているか確認
• IP許可リストに現在のIPが含まれているか確認