OpenSearch MCP サーバー
DynoTable はローカルの MCP サーバーを動かし、Claude Code、Cursor、VS Code、Codex、 OpenCode から Amazon OpenSearch インデックスを扱えるようにします。エージェントはインデックスのマッピングを読み、検索し、DynamoDB テーブルと並べて SQL でクエリし、ドキュメントの変更をステージできます。ステージしたものは、あなたが DynoTable で Commit するまでインデックスに届きません。
サーバーはデスクトップアプリの中でループバックのポートで動き、あなた自身の AWS 認証情報を使います。エージェントがそれを保持することはありません。
エージェントを接続する
設定はテーブルと同じです: サーバーをオンにし、プロファイルを公開し、そのプロファイルの接続コマンドをクライアントに追加します。手順とクライアントごとのコマンドは MCP サーバーのページにあります。
公開するプロファイルでは、エンジンで OpenSearch をオンにしておく必要があります（OpenSearch GUI とクライアント を参照）。接続に見えるのは、そのプロファイルが使うエンジンだけです。DynamoDB のみのプロファイルでは、エージェントはインデックスの機能をまったく得ません。
エージェントがインデックスでできること
接続で何ができるかは、最初の接続時に承認するスコープで決まります。
読み取り専用:
- プロファイルが届くドメイン、コレクション、インデックスを一覧し、インデックスのフィールドとその型を読み取る。
- Lucene クエリやクエリ DSL でインデックスを検索し、
_idでドキュメントを読み、フィールドが持つ値をサンプリングする。 knn_vectorフィールドでベクトル検索を実行する。- テーブルとインデックスを結合する、またはインデックスで集計する SQL を実行する。
読み取りとステージで加わるもの:
- 新しいドキュメント、更新、削除のステージ。そのプロファイルで DynoTable のウィンドウが開いている必要があります。
- クエリまたは
_idの一覧で選んだ、最大 10,000 件のドキュメントの一括編集や一括削除のステージ。ウィンドウがなくても動きます。
フルアクセスでは、クエリ付きでインデックスタブを開く、開いているインデックスタブのクエリを置き換える、開いているタブからファイルやクリップボードへエクスポートする、が加わります。これらは DynoTable のウィンドウで動作します。
プロファイルに設定したセルフホストのエンドポイントにも、アプリと同じく届きます。
Commit するまで何も書き込まれない
どのスコープもインデックスに書き込めません。エージェントが行う変更はすべて保留中の変更で待ち、あなたが DynoTable で Commit します:
- Commit はできません。 エージェントはステージできますが、Commit するのはあなただけです。
- 直接実行はできません。 エージェントからの一括編集は必ずステージになります。
- インデックスの管理はできません。 エージェントはインデックスの作成、変更、削除ができません。
MCP は呼び出しごとに確認しません: クライアントの接続時に承認したスコープが権限です。読み取りとステージの接続は、あなたに尋ねずに変更をステージできるので、Commit の前に差分を読んでください。
マネージドドメインでは、ステージした更新や削除にエージェントが読み取ったドキュメントのバージョンが付くため、Commit 前に誰かが行った変更は、リベースする競合として表示されます。Serverless コレクションでは、Commit は最終書き込み優先です。
プラン
ライセンスの規則はアプリと同じです。無料の読み取り専用プランでは、すべての接続が読み取り専用に制限され、SQL の機能は隠れます。ステージと SQL には試用中または有効なライセンスが必要です。
アプリ内の AI アシスタント
DynoTable の中の AI アシスタントにも、同じインデックスの機能があります。さらに、アクティブなインデックスタブ、そのクエリ、インデックスの AI コンテキストのメモも読み取ります。チャットでは、制御された操作は接続のスコープではなく、あなたの権限モードに従います。
インデックスタブの Query モードでは、AI の自動補完がクエリの続きを提案し、⌘⇧K が指示に従って選択範囲を書き換えます。どちらもインデックスのマッピングを読むので、実際のフィールド名を使います。OpenSearch での自動補完は設定 → AI でオン・オフを切り替えます。