에이전트용

에이전트

사람이 대시보드를 열지 않아도 에이전트가 동작하는 데이터베이스를 건넬 수 있어야 합니다. 그러라고 공개한 모든 것이 여기 있습니다.

01

전제

에이전트가 시작하고 사람은 검토만 하는 프로젝트가 늘고 있습니다. 그 에이전트가 데이터베이스 제공자에게 필요한 것은 세 가지입니다. 제품이 무엇인지 알아낼 방법, 계정에 대해 실제로 행동할 방법, 그리고 사람에게 동작하는 결과를 돌려줄 방법.

세 가지를 모두 공개합니다. 어느 것도 데모용 표면이 아닙니다. MCP 서버와 CLI는 대시보드와 같은 API를, 같은 권한과 같은 감사 기록으로 호출합니다.

02

발견

  • -/llms.txt — 어시스턴트가 가장 먼저 읽는 목차이자 나머지 전부로 가는 입구
  • -/agents.md — 사용자를 대신해 데이터베이스를 준비하기 위한 실행 가능한 지시
  • -/pricing.md, /about.md, /changelog.md — 마케팅 페이지의 마크다운 미러. HTML과 같은 소스에서 생성됩니다
  • -/webmcp.md — 대시보드가 공개하는 브라우저 도구 표면
  • -문서 사이트는 자체 목차와 검색용 전체 코퍼스를 공개합니다
  • -변경 로그 RSS 피드. 호환성 깨짐을 감시하는 에이전트가 페이지를 반복 조회하지 않아도 됩니다

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/mcp

04

브라우저 속 에이전트

대시보드는 이를 지원하는 브라우저 에이전트에 도구 표면을 공개합니다. 페이지를 조작하는 에이전트가 DOM을 추측하는 대신 이름 있는 도구로 행동할 수 있습니다. 파괴적 도구는 사람이 보는 것과 같은 화면에서 확인을 요구합니다.

공개된 표면은 /webmcp.md에 문서화되어 있으며 의도적으로 부분집합입니다. 프로덕션을 덮어쓰는 복원은 에이전트에게 전혀 공개하지 않습니다.

05

안전장치

  • -MCP 서버를 통한 파괴적 SQL은 먼저 복원 지점을 만들어야 합니다
  • -프로덕션 덮어쓰기 복원은 어떤 표면에서도 에이전트 도구로 공개하지 않습니다
  • -API 키는 조직 범위이며, 실행이 어긋나는 순간 대시보드에서 폐기할 수 있습니다
  • -프리뷰 데이터베이스에는 수명이 있어 실험이 조용히 청구서로 자라지 않습니다
  • -에이전트의 모든 동작은 그것을 실행한 키 이름으로 워크스페이스 감사 로그에 남습니다

06

여기서 쉬운 이유

배워야 할 독자 데이터 API가 없기 때문입니다. 에이전트는 셀을 준비하고, 표준 PostgreSQL URL을 받고, 그다음에는 프로젝트에 이미 있는 드라이버를 씁니다. 에이전트가 Postgres에 대해 아는 것은 그대로 통합니다. 그게 첫 시도에 되는 작업과 문서를 세 번 뒤져야 하는 작업의 차이입니다.