pumaDB

ホスト型MCP URLはCodex、ChatGPT、Claude web、OpenClaw、そして任意のStreamable HTTPクライアントで同じだ。一度つなげば、認可したすべてのツールが同じテーブルを読み書きする。これがpumaDBの要点であり、記憶が1つのアプリに閉じ込められず仕事についてくる。ツールごとに用意すべきデータベースはない。

エージェントクライアントはOAuthディスカバリと自動クライアント登録で接続するので、メールでサインインし、APIキーをクライアントへ貼る手間を省ける。MCPサーバーは remember、query、add、upsert、update_row、delete といったエージェント向けツールを公開し、これらはRESTで触るのと同じ行を指す。

サーバー側コード、Worker、サーバーレス関数、CLIツール、スクリプトは puma_live_ で始まるbearer APIキーを使う。エンドポイントには GET /v1/{table}、POST /v1/{table}、POST /v1/{table}/update_row、DELETE /v1/{table} がある。ドキュメントはキーの置き場所について率直だ。Reactのバンドル、静的サイト、モバイルアプリ、公開リポジトリには入れないこと。

これが製品の中心にあるJSON記憶ストアだ。行は素のJSONオブジェクトで、id、created_at、updated_at が自動で付く。フィルタは文字列、数値、真偽値、nullに対するトップレベルの等値チェックだ。人やエージェントが直接読める構造化された事実や好みを保存するには、これで足りる。検索エンジンではなく、そのふりもしない。

pumaDBは行のアーカイブ版を保持する。GET /v1/{table}/versions?id=<row-id> で版を一覧し、POST /v1/{table}/restore で前の版を復元できる。エージェントに監督なしで記憶を書かせるのが不安な人にとって、変更を見て巻き戻せるかどうかが、信頼できるかどうかの分かれ目になる。

バッチエンドポイントは1回の呼び出しで複数の操作を受け付け、add と delete のアクションを行情報やフィルタと混ぜられる。アプリが複数のレコードを一度に同期するなら、単一行リクエストの連発を避けられる。

remember ツールは、技術的な参照、コード、Markdown、設定例を、使用前に見直すべき不活性なレコードとして保存する。記憶が指示を運んでも黙って実行しない、という意図だ。エージェントが自分で書いた内容を読み返すとき、これが効いてくる。