quorum

Quorum MCP サーバー

Quorum を通じて、Claude、Cursor、VS Code、Windsurf、Codex、または独自のエージェントからデータベースにアクセスできるようにします。Quorum のエディターと同じルールが適用されます。読み取り専用セッション、マスキング、そして書き込みごとの人による承認です。

• ウェブサイト：https://www.quorumdb.ai/mcp
• ガイド：MCP を使って Claude、OpenAI、または Cursor をデータベースに安全に接続する方法

目次

• 仕組み
• 要件
• AI クライアントをセットアップする
• AI クライアントが使用できる接続を選ぶ
• ツール
• 書き込みの処理方法
• Quorum Gate
• quorum コマンド
• このリポジトリについて

仕組み

MCP（Model Context Protocol）は、AI ツールが外部のツールを呼び出すための仕組みです。Quorum は、AI クライアント側で起動する MCP サーバーを提供します。このサーバーは、お使いのコンピューター上のローカルブリッジを通じて、実行中の Quorum アプリと通信します。

• Quorum を開いておく必要があります。 AI クライアントがデータベースにアクセスできるのは、Quorum の実行中に限られます。
• パスワードが Quorum の外に出ることはありません。 クライアントはリクエストを送信し、Quorum が保存済みのログイン情報を使って実行します。
• AI クライアントでは、各接続は有効にするまでオフになっています。
• エディターと同じルールが適用されます。 読み取りには読み取り専用セッション、マスキング、書き込みには承認が必要です。

読み取りは読み取り専用セッションで実行され、最大 10,000 行が返されます。マスキングされた列はマスキングされた状態で返され、マスキングされた列を指定するクエリは拒否されます。DuckDB と SQLite では、AI クライアントはお使いのコンピューター上のファイルを読み書きできません。

要件

• macOS、Windows、または Linux 上で動作する Quorum デスクトップアプリのバージョン 4.0.0 以降。Quorum は有料製品で、14 日間の無料トライアルが近日提供予定です。先行して利用するには、https://www.quorumdb.ai/#access からアクセスをリクエストしてください。
• MCP クライアント。Quorum は Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex をセットアップし、その他のクライアント用にはコピーして使える設定を提供します。

サーバーは Quorum 内の Node ランタイムで動作するため、ほかにインストールするものはありません。

AI クライアントをセットアップする

1. Quorum で、Settings › AI clients を開きます。
2. 1. AI clients でクライアントを探します。ステータスは Set up、Not set up、Not found、または Set up for another copy のいずれかです。
3. Set up をクリックします。Quorum はクライアント独自の設定ファイルに項目を追加し、ほかの設定はすべて保持します。
4. クライアントを終了して、もう一度開きます。
5. 2. Connections the AI may use で、アクセスを許可する接続を有効にします。

別のクライアントを使う場合は、Another AI client: copy the config を開き、Copy をクリックして、そのクライアントの MCP 設定に貼り付けます。

クライアント	Quorum が書き込む設定ファイル（macOS）
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code	~/.claude.json
Cursor	~/.cursor/mcp.json
VS Code	~/Library/Application Support/Code/User/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Codex	~/.codex/config.toml、または CODEX_HOME 内のフォルダー

Linux では ~/.config、Windows では Claude Desktop と VS Code の行に %APPDATA% を使用します。

AI クライアントが使用できる接続を選ぶ

接続を共有するまで、AI クライアントに接続は表示されません。Settings › AI clients で Choose connections… をクリックし、環境ごとに検索または参照して、接続ごとに Let AI clients use を有効にします。

• 共有された接続は、Allow AI features on this connection がオンの間だけ読み取り可能です。
• AI may see row values がオフの場合、結果は値ではなく各列のプロファイルとしてクライアントに渡されます。
• インポートした接続と共有された接続は、常に AI クライアントがオフの状態で追加されます。

ツール

ツール	機能
quorum_list_connections	共有接続と、書き込みの処理方法を一覧表示します。
quorum_get_schema	接続のスキーマ（テーブル、ビュー、カラム、型、キー）を読み取ります。
quorum_describe_table	チームによる説明とともに、指定したテーブルを説明します。
quorum_search_schema	名前でテーブルとカラムを検索します。
quorum_sample_rows	テーブルから最大100行を読み取ります。マスキングされたカラムは、マスキングされた状態で返されます。
quorum_explain_query	1つの読み取りクエリの実行計画を表示します。EXPLAIN のみを実行するため、クエリは実行されません。
quorum_execute_query	読み取り専用セッションで読み取りクエリを実行するか、書き込み設定で許可されている場合は書き込みを実行します。
quorum_list_saved_queries	チームの保存済みクエリを一覧表示します。
quorum_run_saved_query	保存済みクエリを読み取りクエリとして実行します。
quorum_get_query_history	共有接続のクエリ履歴を読み取ります。
quorum_get_audit_log	書き込み監査ログ（実行者、内容、リスク、影響を受けた行数）を読み取ります。
quorum_get_data_dictionary	チームによるテーブルとカラムの説明を読み取ります。
quorum_get_service_health	Quorum で設定されている場合、Last9 または Datadog からサービスの健全性を読み取ります。
quorum_propose_write	理由を添えて書き込みを提案し、担当者が Quorum で承認できるようにします。
quorum_get_proposal	提案の結果を確認します。
quorum_list_proposals	最近の提案とそのステータスを一覧表示します。

書き込みの処理方法

設定 › AI クライアント › 3. AI クライアントからの書き込みには、2つの選択肢があります。

選択肢	動作
Quorum で確認する（デフォルト、推奨）	書き込みは、承認されるまで Quorum で保留されます。PROD では、PROD の入力も必要です。
許可された書き込みを直接実行する	許可されたデータ変更は、LOCAL、DEV、QA、UAT、STAGE で直ちに実行されます。PROD への書き込みは拒否されます。

書き込みを直接実行する設定でも、Quorum は PROD への書き込みと重大な書き込みをすべて拒否します。また、LOCAL 以外の接続での DDL および TRUNCATE、読み取り専用、常時レビュー必須、チケット必須、またはクールダウン設定のある接続への書き込み、安全性チェックでブロックされる操作（WHERE のない UPDATE など）も拒否します。すべての書き込みと拒否は、AI エージェントによるものとして書き込み監査ログに記録されます。

Quorum Gate

Quorum で確認するを選択すると、AI クライアントが理由を1行添えて書き込みを提案し、Quorum で承認を待ちます。

1. Quorum にリクエストが表示されます。種類、環境、接続、リスク、クライアントの理由が表示され、その後に整形された SQL が表示されます。
2. 変更内容には、対象行数、設定するカラム、値が実際に変更されるかどうかが表示されます。また、該当する行がいくつか表示され、マスキングされたカラムはマスキングされた状態で表示されます。
3. 求められた場合は、確認用の単語（例：PROD）とチケットを入力します。
4. 承認して1回実行をクリックするか、理由を入力して拒否します。クライアントには理由が表示されます。

承認された書き込みは、エディターと同じチェックを通じて、提案どおりに1回だけ実行されます。リクエストは30分後に期限切れになります。応答がなければ、書き込みは実行されません。

Claude、Claude Desktop、VS Code、Cursor、Goose など、MCP Apps に対応したクライアントでは、リクエストがチャット内のカードにも表示されます。カードにはステータスが表示されますが、承認は Quorum で行います。

quorum コマンド

同じブリッジを利用するコマンドラインツールを使うと、実行中の Quorum アプリとそのルールを通じてクエリを実行できます。設定 › AI クライアント › コマンドラインツールからインストールしてください。

quorum connections
quorum query <connection> "<sql>" [--format table|csv|json] [--limit N]
quorum describe <connection> <table> [--schema S]
quorum saved
quorum run-saved "<name>" [--connection C] [--format …]
quorum history [--connection C] [--limit N]
quorum propose <connection> "<sql>" --reason "<why>" [--wait SECONDS]
quorum request <id> [--wait SECONDS]

AI クライアントと共有されている接続のみ利用できます。書き込みは propose を通じて行われ、Quorum で承認されるまで保留されます。

このリポジトリについて

このリポジトリには、Quorum の MCP サーバーに関するドキュメントと、MCP Registry のエントリー（server.json）が含まれています。サーバー自体は Quorum アプリに同梱されています。お問い合わせ：https://www.quorumdb.ai/#contact。

製品名および会社名は、それぞれの所有者の商標であり、Quorum が対応する対象を説明する目的でのみ使用しています。