Kerry Studio では、ローカル MCP サーバーが保存済みの接続を、Claude Desktop、ChatGPT、Gemini、Conductor、Cursor、OpenCode などのデスクトップ AI クライアントにつなぎます。それがなければ、チャットからテーブルを一覧したり、列を見たり、SQL を実行したりするには、schema や結果を手で貼ることになります。
サーバーはあなたのパソコン上だけで待ち受けます。パスワード、SSH、証明書はアプリで保護されます。MCP はそれらを公開しません。アシスタントはプロジェクト、環境、データベースの種類、データベース名、schema、実行したクエリの結果を受け取ります。Kerry はそれを Sireeus のサーバーへ送りません。アシスタントに届く内容は設定できます。サーバーが使えるプロジェクトと環境、および mcp.log と応答で墨消しする値を選べます。ただし、AI クライアントは MCP が返したものをクラウドのモデルへ送ることがあります。信頼できるエージェントだけで使ってください。
始める前に
次が必要です。
- Kerry Studio で開いた workspace
- MCP に対応したデスクトップ AI クライアント
パネルを開く
- workspace を開きます。
- 右サイドバーで MCP サーバー アイコンをクリックします。
- または workspace フッター(MCP 有効 / MCP 無効)、またはコマンドパレット(⌘K / CtrlK)で MCP パネルを開く を選びます。
既定では、Kerry Studio を終了して開き直しても、サーバーは再起動しません。起動時の設定は 設定 → MCP にあります(パネルの 設定 ヘッダーの歯車、またはコマンドパレット ⌘K / CtrlK → 設定: MCP)。
- アプリ起動時 → サーバーをオンにして起動:Kerry Studio を開くと MCP サーバーを開始します(既定はオフ)。
- アプリ起動時 → 常に読み取り専用モードで起動:次の起動では、前回がフルモードでも読み取り専用に戻します(既定はオン)。
パネルで、歯車の横の 本 アイコンがドキュメントを開きます(ドキュメントを開く)。
AI クライアントを設定する
- パネルで MCP サーバーを有効にする をオンにします。
- JSON をコピー をクリックします。
- JSON をクライアントの MCP 設定に貼ります(または既にある設定とマージします)。
- クライアントがサーバーを自分で再読み込みしなければ、クライアントを再起動します。
クライアントが MCP をローカルのバイナリとして登録する場合(OpenCode など)は、JSON を貼らないでください。OpenCode で使うには のコマンドを使います。
既定のアドレスは http://127.0.0.1:18765/mcp です。パネルの HTTP ポート でこのポートを変えます。サーバーがオンのあいだ、欄はロックされます。JSON をコピー は現在のポートと本物のトークンを使います。サンプルの YOUR_TOKEN は使わないでください。
{
"mcpServers": {
"kerry-studio": {
"url": "http://127.0.0.1:18765/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}OpenCode で使うには
OpenCode のようなデスクトップ AI クライアントは、MCP サーバーを既定でローカルのバイナリとして登録します。Kerry はその種類のサーバーではありません。あなたのパソコン上で HTTP を待ち受けます。そうしたアプリでは、コマンドではなく URL で Kerry を登録します。
mcpServers 形式の JSON は、設定を貼るクライアント向けです。OpenCode では、パネルでサーバーをオンにした状態で次を実行します。
opencode mcp add kerry-studio --global --url http://127.0.0.1:18765/mcp --header 'Authorization=Bearer YOUR_TOKEN'YOUR_TOKEN は、JSON をコピー が JSON に入れるトークンに置き換えてください。HTTP ポート を変えている場合は、そのポートを URL に使います。--global は、OpenCode のすべてのプロジェクトで Kerry を使えるようにします。そのフラグをコマンドが拒否したら、お使いのバージョンにはありません。--global なしで同じコマンドを実行してください。
読み取り専用とフルモード
既定ではサーバーは読み取り専用です。アシスタントは接続を一覧し、schema を調べ、読み取りクエリを走らせられます。SELECT、SHOW、DESCRIBE、EXPLAIN(SELECT の ANALYZE を含む)。INSERT、UPDATE、DELETE、SELECT … FOR UPDATE、SELECT INTO、INTO OUTFILE、データを変える WITH は拒否されます。
読み取り専用でも、アシスタントのセッションではデータベースを開きます。それがなければ schema も SELECT もありません。Kerry の SQL タブが接続している必要はありません。
パネルでのモード切り替えはすぐに効きます。Kerry Studio を再起動する必要はありません。
設定 → MCP → 読み取り専用 の サーバー起動時に読み取り専用を強制する(既定はオン)は、パネルの 読み取り専用モード をオンのままロックし、サーバーをオンにするたびに読み取り専用を適用します。
権限
Kerry Studio では、権限 でローカル MCP サーバーが使える保存済みプロジェクトと環境を絞ります。この制限がなければ、保存済みの接続はどれもアシスタントに使えます。既定はすべてのプロジェクトと環境です。
読み取り専用と読み取りと書き込みは、それぞれ自分のリストを持ちます。読み取りはカタログ全体のままにして、フルモードでは一部のプロジェクトだけを開ける、という使い方ができます。
権限 は MCP パネルの 設定、設定 → MCP、またはコマンドパレット(⌘K / CtrlK)の MCP 権限 から開けます。
MCP サーバーの権限 では、上で 読み取り専用 と 読み取りと書き込み を切り替えます。使用中 は、パネルが今どちらを使っているかを示します。読み取り専用モード がオンならマークは 読み取り専用 に、オフなら 読み取りと書き込み に付きます。一方を直しても、もう一方は変わりません。
読み取りと書き込み のリストでは、書き込みの初期設定 が挿入、更新、削除をリストに対して決めます。既定は 3 つともオンです。各プロジェクトや接続では、この初期設定と違う設定にできます。変更はアシスタントの次の要求から効きます。
すべてのプロジェクトと環境を許可 がオンなら、サーバーはそのリストでカタログ全体を使います。プロジェクトを個別に選びたいときはオフにします。
スイッチをオフにすると、プロジェクトごと、そのプロジェクトの環境ごとにコントロールが付きます。次へのアクセスを自動で含める では、新しいプロジェクトとその時点の環境 と プロジェクト上の新しい環境 を自動で入れるかを決めます。検索はプロジェクト、SQL エイリアス(@alias)、環境で表示を絞ります。すべて有効にする と すべて無効にする は、見えている項目に効きます。横の矢印は同じ操作を 1 つの環境に適用します。環境ごとにすべて有効にする または 環境ごとにすべて無効にする です。
パネルで 読み取り専用モード を切り替えると、Kerry は対応するリストを使い始めます。変更はアシスタントの次の要求から効きます。そのリストにプロジェクトがなければ、Kerry はその接続をアシスタント向けに開きません。@alias を使うクエリ(例: @billing.orders)は保存済み接続を指し、その接続が使えないときもブロックされます。
アシスタントが触れるもの
接続エラーはユーザー名、ホスト、パスワード、ファイルパスを返しません。アシスタントが受け取る SQL 結果も、ファイルパス、ホスト、接続 URI、キーを省きます。Kerry のタブグリッドはそのままです。
接続一覧はプロジェクト、環境、データベースの種類、データベース名を示します(ローカルファイルではパスではなくファイル名)。
サーバーがオンなら、アシスタントは次も受け取ります。
- テーブル名とビュー名
- 列とテーブルの詳細
- アシスタントが走らせた各 SQL 結果から最大 500 行
- 開いている workspace の ER 図タブの操作
ER 図を操作する
Kerry Studio では、アシスタントがあなたと同じように ER 図タブを使えます。そのプロジェクトと環境のタブがなければ開き、あればフォーカスします。そのタブが未接続なら、図を使う操作(同期、絞り込み、画面に合わせる)で接続し、schema を更新します。アシスタントが操作するのは ER 図タブだけです。開く・同期・環境の切り替えは MCP の権限に従います。テーブルの絞り込み、レイアウト、関係のフォーカス、ズーム、画像の書き出しもできます。書き出しでは、Kerry が 設定 → MCP のフォルダーに保存します。既定はデスクトップです。できないときは、保存先を尋ねます。アシスタントはフルパスを受け取ります。MCP はフォルダーを選べません。
@alias のない SQL は別セッションのままです。タブは切り替わりません。@alias 付きの SQL、たとえば @billing.orders は、アクティブな SQL タブを使います。
アシスタントが図を操作しているあいだ、タブに MCP の印が出ます。workspace のフッターには UI を操作中 と出ます。
例:
- 「プロジェクト billing、環境 開発 の ER 図を開いてください。」
- 「図では
public.ordersと関係するテーブルだけ見せてください。」 - 「図を画面に合わせて PNG で書き出してください。」
チャットでの頼み方
技術的な接続ラベル(postgres など)だけではなく、プロジェクト と 環境 を名前で言ってください。
例:
- 「プロジェクト billing、環境 開発 で、テーブルを一覧して」
- 「Billing / 開発 で、
public.productsにはどの列がある?」
アシスタントは Kerry に保存した接続を使います。@alias のない SQL は別セッションで走ります。タブも エンティティ サイドバーも切り替えません。@alias 付きの SQL、例は @billing.orders は、クエリを実行 と同じくアクティブな SQL タブを使います。@プロジェクト.テーブル はタブの環境に従います。アクティブなタブは SQL で、そのプロジェクトと環境に紐づいている必要があります。エンティティ に出るのは保存済みプロジェクトだけです。
アシスタントができること
| モード | アシスタントができること |
|---|---|
| 読み取り専用 | 接続を一覧する、プロジェクトと環境を探す、テーブルと列を調べる、schema を検索する、読み取り SQL を走らせる、ER 図タブを開いて操作する |
| フル | 上のすべてに加え、権限 で許可した書き込み SQL(挿入、更新、削除) |
誰がつながっているかを見る
パネルの 観測 セクションは、Kerry と話しているアプリを一覧します。
- 下部の数は、つながっているアプリの数です。
- 各カードは 1 つのアプリです。カード上の数は、そのアプリが開いたデータベースセッションの数です。
- アプリが接続する、切れる、データベースへのクエリを始めると、パネルが閉じていても通知が出ます。
アプリを落とす:カードのゴミ箱アイコン(接続を切断)をクリックして確認します。そのアプリの接続が終わります。別のアプリが同じデータベースをまだ使っていれば、それは残ります。最後の 1 つなら、Kerry はそのデータベースの MCP 接続を閉じます。
サーバーを監査する
Kerry Studio では、mcp.log がアシスタントとのやり取りを、アプリとセッション付きで記録します。ファイルの REQUEST は、アシスタントが送ったリクエストで、SQL も含みます。RESPONSE は Kerry が返した内容です。MCP パネルの 観測 見出し、または設定の MCP でファイルを開きます。
フィールド名が一覧の語であるか、その語を含むとき、Kerry は値を墨消しします。SQL が列に別名を付けた場合、式の中でその列を使った場合、JSON からその列を読んで別の名前で返した場合も同じです。これは PostgreSQL、MySQL、Oracle、SQLite で有効です。
既定で次が墨消しされます。
- ファイルとアシスタントへの応答の両方: パスワード、トークン、認可、秘密鍵の値。その行き先の既定一覧にフィールドが合うときです。
- mcp.log だけ: 名前が email であるか、email を含むフィールドの値。本文中に出るメールも隠します。列名が email でなくても同じです。
- アシスタントへの応答だけ: 接続文字列、鍵、ホスト、ユーザー、パス、パスワードが分かるエラー文。列名には依存しません。
SQL が mcp.log に入るのは、監査が届いたときのリクエストを残すからです。ファイルで、あなたのデータベースの列が RESPONSE にまだ実値のまま残っていないかを確認します。Kerry が知らないフィールド、たとえば氏名や書類番号で必要になります。残っていれば、MCP パネルの 墨消しする値、またはコマンドパレット(⌘K / CtrlK)でフィールドを追加し、行き先(ファイル、アシスタント、または両方)と、一致が完全一致か含むかを選びます。
オフにすると、その選択は保持されます。ファイルが既にある場合、Kerry は確認してから削除します。
トラブルシューティング
- AI クライアントが Kerry に届かない:URL が
localhostではなく127.0.0.1か、ポートが HTTP ポート と一致するかを確認します。ポートを変えたら JSON をコピー し直します。 - JSON を貼ってもクライアントがつながらない:パネルでサーバーをオフにしてオンにするか、AI クライアントを再起動します。
- OpenCode がつながらない:Kerry はバイナリ MCP ではありません。
--urlとAuthorizationヘッダー付きでopencode mcp addを使います。コマンドが--globalを拒否したら、そのフラグを外します。 - クエリが拒否された:サーバーは読み取り専用か、その操作の種類が 権限 でオフです。書き込みが意図どおりならフルモードをオンにし、SQL に合わせて挿入、更新、削除をオンにします。
SHOWとSELECTのEXPLAINは読み取りです。FOR UPDATEとSELECT INTOは違います。 - データベースが見つからない:接続ラベルではなく、プロジェクトと環境(名前または
@alias)で頼んでください。 @alias付き SQL が失敗した:そのプロジェクトと環境に紐づいた SQL タブをフォーカスします。クエリを実行 と同じです。- ER 図が開かない、または環境が拒否された:権限 を確認し、その一覧にあるプロジェクトと環境を指定してください。MCP パネルは workspace が開いているときだけあります。
パネルでトークンを再生成したら、JSON をクライアントに貼り直します。