ユーティリティ

LLM プラグイン

TablePlus には、クエリを作成し説明する内蔵の AI アシスタントが搭載されています。これは右サイドバーの Assistant タブにあり、選択した LLM プロバイダーまたはコーディングエージェント(OpenAI、Anthropic、Google AI、OpenRouter、DeepSeek、GitHub Copilot、Codex CLI、Claude CLI、Ollama、OpenAI 互換サーバー、または Agent Client Protocol (ACP) をサポートする任意のエージェント)と連携します。

右側のサイドバーにある「アシスタント」タブで、注文テーブルに関する質問と、生成されたSQLクエリについて。
右側のサイドバーにある「アシスタント」タブ

アシスタントを有効にする

アシスタントはデフォルトで有効になっています。オン/オフにするには、以下のいずれかを行ってください。

  • Settings (⌘ + ,) > AI Agent の Enable Assistant Tab on the Right Sidebar をオンまたはオフにします。
  • サイドバーの右側で、設定ボタンをクリックして、「Enable LLM Chat」を選択してください。

アシスタントが有効になると、右側のサイドバーに「Details」と「Assistant」の 2 つのタブが表示されます。

プロバイダーを設定する

Settings > AI Agent を開きます。リストには組み込みプロバイダーと追加したカスタムプロバイダーが表示されます。リストの下でプロバイダーを選択して設定します。

設定画面の「AIエージェント」タブには、プロバイダーの一覧とOpenAIの設定が記載されています。
設定 > AIエージェント

プロバイダーのDefault Vendorを有効にしてください。新しいチャットでこのプロバイダーを使用します。ただし、個別のチャットごとにプロバイダーを変更することも可能です。

APIキーのプロバイダー

OpenAI、Anthropic、Google AI、OpenRouter、および DeepSeek は、プロバイダーの API キーを使用します。

  1. 提供者を選択してください。
  2. API キー にキーを入力してください。
  3. デフォルトモデル を選択してください。TablePlus はプロバイダーからモデルのリストを読み込みます。

API キーは、macOS のキーチェーンに保存されます。

Ollama

Ollamaはローカルでモデルを実行します。TablePlus は、デフォルトでhttp://localhost:11434に接続します。

  1. Ollama を起動し、モデルをダウンロードします。例えば、ollama pull llama3.2 です。
  2. Ollama を選択し、Default Model をお選びください。

Ollama は API キーが不要です。

GitHub Copilot

GitHubアカウントと、有効なCopilotのサブスクリプションが必要です。

  1. GitHub Copilot を選択し、Connect to GitHub をクリックします。
  2. TablePlus が示すコードをコピーし、「Open GitHub Login Page」をクリックしてコードを貼り付け、TablePlus の認証を行ってください。
  3. ログイン後、Default Modelを選択してください。

Logout をクリックして、GitHub アカウントをログアウトしてください。

Codex CLI

TablePlus は、Mac にインストールされている Codex CLI を ChatGPT アカウントでログインさせ、利用できます。

  1. Codex CLI をインストールしてください。
  2. Codex CLI を選択してください。TablePlus が codex の実行ファイルを自動的に検出し、その Status、Version、および Path を表示します。Codex が見つからない場合は、Path に完全なパスを入力してください。
  3. Sign in with ChatGPT をクリックし、Codex のログインを完了してください。Refresh をクリックしてステータスを更新してください。
  4. デフォルトモデル を選択してください。
Codex CLIの設定で、検知されたパス、ログイン状態、およびデフォルトモデルを表示する。
Codex CLIの設定

Codex とチャットを行うと、チャットボックスに Reasoning と Speed のボタンが表示され、選択したモデルの論理努力とサービスティアを選択できます。

Claude CLI

TablePlus は、Mac にインストールされている Claude Code を使用し、ご自身の Claude アカウントでログインすることも可能です。

  1. Claude Code をインストールしてください。
  2. Claude CLI を選択してください。TablePlus が claude の実行ファイルを自動的に検出し、Status、Version、および Path を表示します。Claude Code が見つからない場合は、Path に完全なパスを入力してください。例:~/.local/bin/claude。
  3. Sign In をクリックしてブラウザでログインを完了し、状態を更新するにはRefreshをクリックしてください。
  4. デフォルトモデル を選択してください。

カスタムLLM(OpenAI互換)

このガイドは、自社のサーバーでホストしたモデルを使用する場合、または OpenAI 互換の API を提供するサービスを利用する場合に使用します。

  1. 提供者リストの下の「Add」をクリックし、「Custom LLM (OpenAI-compatible)...」を選択してください。
  2. Name、Host(例:localhost:3006)、Sub Path(例:/v1)、および必要に応じてAPI キーを入力してください。
  3. デフォルトモデル を選択してください。

カスタムエージェント(ACP)

任意の Agent Client Protocol をサポートするコーディングエージェントを接続できます。例えば、ACP アダプター経由の Claude Code や Gemini CLI などです。TablePlus は Mac でエージェントを起動し、それとチャットします。エージェントは TablePlus からファイルを読み取ったり、ターミナルコマンドを実行したりすることはできません。

  1. 提供者リストの下の「Add」をクリックし、「Custom Agent (ACP)...」を選択してください。
  2. 次の項目を入力します。
    • Name: エージェントのチャット表示名。
    • Command: エージェントの実行コマンドで、シェル上のコマンド PATH または絶対パス claude-agent-acp です。
    • オプション: コマンドに追加する引数、例えば --acp。
    • 環境: 追加の環境変数で、各行に 1 つの KEY=VALUE を含み、例えば ANTHROPIC_API_KEY=... の形式です。これらは macOS のキーチェーンに保存されます。
  3. Test Agent をクリックして、TablePlus がエージェントを正常に起動できるか確認してください。
コマンド、引数、環境、テストエージェントボタン、およびデータベースアクセスに関する設定
カスタムエージェント(ACP)設定

カスタムエージェントは、TablePlus MCP サーバーが稼働している場合にのみデータベースをクエリできます。詳細については、エージェントのデータベースアクセス を参照してください。

カスタムプロバイダーを削除するには、リストで右クリックし、Deleteを選択してください。組み込みプロバイダーは削除できません。

アシスタントとチャットする

  1. 接続を開いて、右側のサイドバーの上部にある "Assistant"をクリックしてください。
  2. 提供者とモデルを選択するために、チャットボックス内のボタンを使用してください。
  3. 何でも聞いてください に質問を入力し、Return を押すと送信します。Shift + Return を押すと新しい行を追加します。

応答がまだ表示中である場合は、Stop ボタンをクリックして中断してください。

テーブルをコンテキストとして追加する

アシスタントが正確なクエリを作成できるよう、@ Add contextをクリックして、アシスタントが参照すべきテーブルとビューを確認します。TablePlus は、その構造(CREATE ステートメント)を会話に追加します。

注文、顧客、注文アイテムのテーブルを含む、ポップアップのコンテキストを表示する。
テーブルを追加する。

生成された SQL を実行します

それぞれのSQLコードブロックには、2つのボタンがあります。

  • コピー: コードをクリップボードにコピーします。
  • Run: コードを SQL エディタに追加して実行します。

メッセージをホバーすると、コピー、再送、または削除できます。

アシスタントにクエリを実行させてください

アシスタントは、回答する前にデータをチェックするために、自身で現在のデータベースをクエリすることもできます。

  • 読み取り専用クエリ(例:SELECT)は直接実行されます。接続で safe mode が有効になっている場合、TablePlus は通常通り確認を求めます。
  • 他のクエリはすべて、まずあなたの承認が必要です。チャットボックスに Approve SQL ボタンが表示されます。これをクリックして SQL と実行対象のデータベースを確認し、Approve をクリックして実行するか、Cancel をクリックして拒否してください。承認後もセーフモードは適用されます。
実行前にSQLの確認を行うポップアップで、UPDATE文と「承認」と「キャンセル」のボタンを表示する。
SQL の実行前にレビューする。

チャットを管理

チャットボックスのメニューボタンをクリックして、以下の操作を実行できます:

  • New Chat: 新しい会話を開始します。
  • Clear Chat: 現在の会話のすべてのメッセージを削除します。
  • History: 最近の会話を開くか、過去の会話を検索します。
  • Settings..: Settings > AI Agent を開く。

エージェント向けのデータベースアクセス

すべての組み込みプロバイダーおよびカスタムのOpenAI互換プロバイダーは、現在のデータベースに自動的にアクセスできます。カスタムACPエージェントは、TablePlus MCP サーバーを使用します。

  1. Settings > MCP
  2. Enable MCP Server を有効にしてください。

カスタムエージェント設定から、エージェントがデータベースへのアクセス権限を持っているかどうかを確認できます。エージェントが実行するクエリは、Query approval で説明されている通り確認されます。

TablePlus を他の AI ツールと併用してください

MCP サーバーは、Codex や Claude Code などの他の AI ツールが TablePlus 接続と連携できるようにします。詳細は MCP サーバー を参照してください。Settings > MCP

  • クライアント設定 で、TablePlus を Add to Claude Code をクリックするだけで、Claude Code、Codex、Grok Build、または Antigravity に追加できます。Others… は、Cursor や VS Code などの他のエージェントをリストします。Manual Setup… は、任意のクライアント(Manual)にコピーする設定または HTTP Server のアドレスを表示します。
  • Access Token を使用することで、Read Only、Read & Write、Full Access、または Custom (per connection) の権限でトークンを作成し、特定の接続に制限を設け、トークンを無効化できます。デフォルトでは、TablePlus は tableplus-mcp コマンドに対して自動的にトークンを生成します。
  • 不適切なクエリへの承認が必要です は、デフォルトで有効な Silent モードにおいて、接続上のデータを変更するクエリの承認を求めます。
  • Allow remote access (TLS) を有効にすると、他の機器から接続できます。Export Certificate… を使用して、リモート機器にサーバー証明書をインストールします。
  • Activity は、MCP クライアントからのリクエストを表示します。
設定画面の「MCP」タブに、クライアント設定ボタン(「Codexに追加」を含む)と、2つのアクセストークンが含まれています。
設定 > MCP

プライバシー

このアシスタントはチャットクライアントです。設定したプロバイダーまたはエージェントへ、あなたのMacから直接リクエストを送信します。TablePlusサーバーを経由しないため、プロバイダーへのアクセスをブロックすると、アシスタントは利用できません。

提供者が得ること:

  • あなたのメッセージと、これまでのやり取り。
  • 追加するテーブルの構造(CREATE ステートメント)
  • アシスタントがそれらの情報を尋ねた場合、データベース名、ドライバ、およびサーバーバージョンなど、現在の接続に関する詳細が表示されます。
  • アシスタントが実行したクエリの結果。承認済みのクエリ、または読み取り専用のクエリのみが実行されますが、その結果(データ行を含む)は、提供者に送信されます。

ご提供のローカルモデル(例:Ollama)を使用することで、このデータをマシン内に保持する必要があります。プロバイダーは独自の条件でこのデータを保存および処理する場合があります。