Black Friday個人の月払い 15% 引き。年払い 5% 引き + 無償シート 1 つ。オファーは 11 月 29 日まで有効です。
ローカル MCP サーバー

ローカル MCP サーバー

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 クライアント

パネルを開く

  1. workspace を開きます。
  2. 右サイドバーで MCP サーバー アイコンをクリックします。
  3. または workspace フッター(MCP 有効 / MCP 無効)、またはコマンドパレット(⌘K / CtrlK)で MCP パネルを開く を選びます。

既定では、Kerry Studio を終了して開き直しても、サーバーは再起動しません。起動時の設定は 設定 → MCP にあります(パネルの 設定 ヘッダーの歯車、またはコマンドパレット ⌘K / CtrlK → 設定: MCP)。

  • アプリ起動時 → サーバーをオンにして起動:Kerry Studio を開くと MCP サーバーを開始します(既定はオフ)。
  • アプリ起動時 → 常に読み取り専用モードで起動:次の起動では、前回がフルモードでも読み取り専用に戻します(既定はオン)。

パネルで、歯車の横の 本 アイコンがドキュメントを開きます(ドキュメントを開く)。

AI クライアントを設定する

  1. パネルで MCP サーバーを有効にする をオンにします。
  2. JSON をコピー をクリックします。
  3. JSON をクライアントの MCP 設定に貼ります(または既にある設定とマージします)。
  4. クライアントがサーバーを自分で再読み込みしなければ、クライアントを再起動します。

クライアントが MCP をローカルのバイナリとして登録する場合(OpenCode など)は、JSON を貼らないでください。OpenCode で使うには のコマンドを使います。

既定のアドレスは http://127.0.0.1:18765/mcp です。パネルの HTTP ポート でこのポートを変えます。サーバーがオンのあいだ、欄はロックされます。JSON をコピー は現在のポートと本物のトークンを使います。サンプルの YOUR_TOKEN は使わないでください。

json
{
  "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 では、パネルでサーバーをオンにした状態で次を実行します。

bash
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 をクライアントに貼り直します。