pumaDB

호스팅 MCP URL은 Codex, ChatGPT, Claude web, OpenClaw, 그리고 모든 Streamable HTTP 클라이언트에서 같다. 한 번 연결하면 권한을 부여한 모든 도구가 같은 테이블을 읽고 쓴다. 이것이 pumaDB의 핵심이며, 기억이 한 앱에 갇히지 않고 작업을 따라온다는 뜻이다. 도구별로 준비할 데이터베이스는 없다.

에이전트 클라이언트는 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로 이전 버전을 복원한다. 에이전트가 감독 없이 기억에 쓰는 게 불편한 사람에게, 변경을 보고 되돌릴 수 있느냐가 신뢰와 불신을 가른다.

배치 엔드포인트는 한 번의 호출로 여러 작업을 받아들이며, add와 delete 동작을 행 데이터와 필터에 섞는다. 앱이 여러 레코드를 한꺼번에 동기화한다면 단일 행 요청이 쏟아지는 걸 피한다.

remember 도구는 기술 참조, 코드, Markdown, 설정 예시를 사용 전에 검토해야 하는 불활성 레코드로 저장한다. 기억이 지시를 나르되 조용히 실행하지는 않는다는 의도이며, 에이전트가 자신이 쓴 내용을 다시 읽을 때 이 점이 중요하다.