설정 · 약 30초

htmlbook을
에이전트에 연결하세요.

htmlbook은 MCP 기반입니다. 한 번만 추가하면 Claude Code, Cursor, Codex, 또는 어떤 MCP 클라이언트든 작성한 HTML을 곧장 당신의 서재에 게시합니다 — 복붙도, 배포 단계도 없이.

API 키 받기

로그인하고 워크스페이스 키를 복사하세요. 비밀로 유지하세요 — 라이브러리에 게시할 권한을 부여합니다.

hb_live_REPLACE_WITH_YOUR_KEY워크스페이스 키

키 받기

서버 추가하기

명령어 하나. 어떤 프로젝트에서든 실행하세요 — 에이전트가 HTML을 쓰는 곳이라면 어디서나 작동합니다.

Terminal — recommended (browser login)

claude mcp add --transport http htmlbook https://htmlbook.io/api/mcp# then run `claude` and approve the htmlbook login

Terminal — with an API key

claude mcp add --transport http htmlbook https://htmlbook.io/api/mcp \  --header "Authorization: Bearer hb_live_REPLACE_WITH_YOUR_KEY"

.mcp.json — share with your repo (project scope)

{  "mcpServers": {    "htmlbook": {      "type": "http",      "url": "https://htmlbook.io/api/mcp",      "headers": { "Authorization": "Bearer ${HTMLBOOK_API_KEY}" }    }  }}

확인 → claude mcp list 이렇게 표시되면 정상 htmlbook ✓ connected

사용하기

그냥 요청하세요. 에이전트가 끝나면 publish 를 호출하고 — 실제 URL을 돌려줍니다.

claude — ~/acme

>우리 PRD를 HTML 페이지로 만들어서 게시해줘

●Write(prd.html)

⎿312줄 · 섹션, 목차, 다크 모드

●htmlbook → publish

⎿✓서재에 올림 · htmlbook.io/d/prd

비용 팁

큰 문서? 파일로 푸시하세요.

publish 도구는 HTML을 인라인으로 받습니다 — 편리하지만, 큰 문서면 에이전트가 파일 전체를 토큰으로 다시 내보내고 컨텍스트에도 계속 남습니다. 파일로 쓰게 한 다음, 셸에서 그 파일을 푸시하세요 — 바이트가 모델을 완전히 건너뜁니다:

shell — token-free push (same pipeline as the tool)

curl -s -X POST "https://htmlbook.io/api/docs?project=PROJECT&slug=SLUG" \  -H "Authorization: Bearer $HTMLBOOK_API_KEY" \  --data-binary @doc.html   # or @doc.md — .md kept as source + rendered to a view

작은 문서 → 그냥 publish 사용 (마크다운도 됩니다). HTMLBOOK_API_KEY 를 같은 키로 설정하세요.

에이전트가 갖게 되는 도구들

동사 여덟 개. 담기는 한 번의 호출이고, 나머지는 에이전트(와 당신)가 라이브러리를 실제로 관리하게 해줍니다.

htmlbook.publishHTML이나 마크다운으로 문서를 만들거나 업데이트합니다 (있으면 새 스냅샷).capture

htmlbook.guide작성 규약 — hb-doc 클래스, 토큰, 컴포넌트 — 스킬 없이 어떤 에이전트든.capture

htmlbook.list라이브러리를 둘러봅니다, 프로젝트로 필터링 가능.manage

htmlbook.get문서를 가져옵니다 — 메타데이터 + 현재 HTML (meta_only로 본문 생략).manage

htmlbook.organize제목/태그/경로 설정, 다른 프로젝트로 이동, 이름 변경.manage

htmlbook.restore문서를 이전 스냅샷으로 되돌립니다.recover

htmlbook.set_access문서를 공개 또는 비공개로 전환합니다.share

htmlbook.delete문서를 휴지통으로 보냅니다 (소프트 삭제).manage

연결이 안 되나요?

클라이언트 재시작. Cursor, Codex, Claude Desktop은 실행할 때만 설정을 읽습니다. 종료 후 다시 여세요.
401 / 인증 실패. 키가 틀렸거나 없습니다. Authorization 헤더로 다시 추가하거나 브라우저 로그인을 실행하세요.
상태 확인. Claude Code에서: claude mcp list — 자세히는 claude mcp get htmlbook.
프록시 뒤 / 헤드리스. OAuth 대신 정적 API 키(Bearer)를 사용하세요 — “Any MCP client” 탭을 보세요.

에이전트에게 서재를 주세요.

무료로 시작. AI가 쓰는 모든 HTML 파일을 — 담고, 정리하고, 어디서나 읽을 수 있게.

내 서재 시작하기 — 무료

htmlbook을에이전트에 연결하세요.