D2B for Agents

D2B는 “Spreadsheets for AI Agents”입니다. messy한 사람의 Excel을 입구에서 받아, 에이전트에게는 타입 지정·행 ID 부여·버전 관리·거버넌스가 적용된 테이블로 전달하고, 결과를 사람이 읽을 수 있는 형태(xlsx / 원본 서식)로 돌려줍니다. 답만이 아니라 어떤 숫자가 어디에서 왔는지까지 추적할 수 있습니다.

3가지 입구

경로	적합한 대상	첫 1 콜
MCP	Claude Code / Claude Desktop / Cursor / VS Code 등 MCP 호스트	claude mcp add d2b --transport http https://d2b.dev/mcp/ --header "Authorization: Bearer $PAT"
CLI	셸을 다루는 에이전트, CI, 사람	pipx install d2b-sdk && d2b login
SDK / API	자체 에이전트·앱(Python / TypeScript / HTTP)	pip install d2b-sdk → 퀵스타트. PyPI / npm / GitHub

3가지는 같은 백엔드의 같은 표면입니다. MCP의 툴·CLI의 서브커맨드·SDK의 메서드·REST의 엔드포인트는 1대1로 대응하며, 어디에서 시작하든 다른 경로로 옮겨갈 수 있습니다.

무엇이 다른가

• 추적할 수 있다: 파생 테이블은 transform(SQL / Python)으로 만들고, {{ arg }} 바인딩으로 lineage가 남습니다. code interpreter는 답은 내놓지만, 추적할 수 없고 재현할 수 없습니다.
• 되돌릴 수 있다: snapshot / named version / op log / undo. 에이전트는 실수한다는 전제 하에, 임의 시점으로 복원할 수 있습니다.
• 지킬 수 있다: 컬럼 태그 × 롤의 mask / deny를 데이터 레이어에서 강제합니다. SQL이든 export든 MCP든 같은 정책이 적용됩니다.
• 돌려줄 수 있다: xlsx / csv, 원본 Excel의 값 셀만 교체한 원본 파일, 행별로 살아 있는 수식, export = branch → 재 import = 3-way merge.
• git에 둘 수 있다: transform·시트·차트·base 테이블을 리포지토리로 꺼내어, PR로 리뷰하고 다시 반영할 수 있습니다(워크북을 git으로).

읽는 순서

1. 퀵스타트 — PAT를 발급하고 5분 만에 첫 호출
2. 핵심 개념 — Workbook / Source / Table / Sheet / Version, 낙관적 잠금, 멱등성, 거버넌스
3. 사용할 경로: MCP / 코딩 에이전트 / CLI / SDK / Webhook
4. 에러 읽는 법 — problem+json과 suggested_fix
5. API 레퍼런스 — OpenAPI에서 자동 생성

에이전트용 색인: llms.txt / llms-full.txt / openapi.json