01
전제
에이전트가 시작하고 사람은 검토만 하는 프로젝트가 늘고 있습니다. 그 에이전트가 데이터베이스 제공자에게 필요한 것은 세 가지입니다. 제품이 무엇인지 알아낼 방법, 계정에 대해 실제로 행동할 방법, 그리고 사람에게 동작하는 결과를 돌려줄 방법.
세 가지를 모두 공개합니다. 어느 것도 데모용 표면이 아닙니다. MCP 서버와 CLI는 대시보드와 같은 API를, 같은 권한과 같은 감사 기록으로 호출합니다.
에이전트용
사람이 대시보드를 열지 않아도 에이전트가 동작하는 데이터베이스를 건넬 수 있어야 합니다. 그러라고 공개한 모든 것이 여기 있습니다.
이 프로젝트에 쓸 CapyDB Postgres 데이터베이스를 준비해 줘. https://capydb.dev/agents.md 를 받아서 네 환경에 맞는 안내를 따라가면 돼. 내가 필요한 건 딱 한 번, 브라우저 탭에서 접근을 승인할 때야. 나머지는 전부 맡길게.
Claude Code, Cursor, Copilot 등에서 동작합니다. 브라우저에서 한 번만 승인하면 계정, 데이터베이스, 환경 변수까지 정리됩니다.
01그다음에 일어나는 일
프롬프트가 세 줄인 것은 의도한 것입니다. 실제 지침은 capydb.dev/agents.md에 있고 제품과 함께 버전 관리됩니다. 에이전트가 따르는 내용은 항상 최신이며, 몇 달 전에 복사한 프롬프트가 낡을 일이 없습니다.
01
에이전트가 시작하고 사람은 검토만 하는 프로젝트가 늘고 있습니다. 그 에이전트가 데이터베이스 제공자에게 필요한 것은 세 가지입니다. 제품이 무엇인지 알아낼 방법, 계정에 대해 실제로 행동할 방법, 그리고 사람에게 동작하는 결과를 돌려줄 방법.
세 가지를 모두 공개합니다. 어느 것도 데모용 표면이 아닙니다. MCP 서버와 CLI는 대시보드와 같은 API를, 같은 권한과 같은 감사 기록으로 호출합니다.
02
03
표면은 둘, API는 하나. 에이전트가 에디터나 채팅 클라이언트에 산다면 MCP 서버가, 셸이 있다면 CLI가 맞습니다.
둘 다 조직 범위의 API 키로 인증하거나, 사람이 브라우저에서 승인하는 기기 로그인을 씁니다. 에이전트에게 비밀번호는 필요 없고, 줘서도 안 됩니다.
# In a shell
capydb login
capydb create --name my-app
capydb env pull
# In an editor, over MCP
npx -y @capydb/mcp04
대시보드는 이를 지원하는 브라우저 에이전트에 도구 표면을 공개합니다. 페이지를 조작하는 에이전트가 DOM을 추측하는 대신 이름 있는 도구로 행동할 수 있습니다. 파괴적 도구는 사람이 보는 것과 같은 화면에서 확인을 요구합니다.
공개된 표면은 /webmcp.md에 문서화되어 있으며 의도적으로 부분집합입니다. 프로덕션을 덮어쓰는 복원은 에이전트에게 전혀 공개하지 않습니다.
05
06
배워야 할 독자 데이터 API가 없기 때문입니다. 에이전트는 셀을 준비하고, 표준 PostgreSQL URL을 받고, 그다음에는 프로젝트에 이미 있는 드라이버를 씁니다. 에이전트가 Postgres에 대해 아는 것은 그대로 통합니다. 그게 첫 시도에 되는 작업과 문서를 세 번 뒤져야 하는 작업의 차이입니다.