htmlbook

htmlbook

AI が生成した HTML や Markdown を、ホストされた共有可能な URL として公開します。 htmlbook は、MCP サーバー兼 REST API です。コーディングエージェントが生成したドキュメント（HTML レポート、データダッシュボード、仕様書、会議メモ、インタラクティブなページなど）を受け取り、プロジェクトフォルダーの奥に埋もれたローカルの .html ファイルのままにせず、スマートフォンで開いたり、誰かに送ったりできる、見やすいリンクに変換します。

Claude Code、Cursor、Codex、claude.ai から公開できます。htmlbook はドキュメントを保存し、あらゆるデバイスで読みやすいようにテーマを変更（ペーパー／セピア／ダーク）し、編集内容をすべてバージョンとして保持します。また、各ドキュメントに 1 つの共有リンクを用意し、3 種類のモードを利用できます。公開（誰でもアクセス可能、ログイン不要）、パスワード保護（パスワードを知っている人がアクセス可能、ログイン不要）、非公開シークレットリンク（あなたとワークスペースのみアクセス可能）です。

ファイルではなく、リンクで成果物を共有しましょう。 エージェントが HTML を作成するとき、厄介なのはその後のことです。ノート PC から取り出し、スマートフォンに送り、ほかの人に見せることです。htmlbook は、その部分を担う保管場所です。

• 🌐 ウェブサイト： https://htmlbook.io
• 🔌 MCP エンドポイント： https://htmlbook.io/api/mcp
• 📡 REST 公開： POST https://htmlbook.io/api/docs
• 💬 コミュニティ： Discord

---

クイックスタート

1. エージェントを接続する

https://htmlbook.io → Settings で API キーを取得し、MCP サーバーを追加します。

Claude Code（ブラウザーログイン、キー不要）：

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

Claude Code（API キーを使用）：

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

Cursor — ~/.cursor/mcp.json：

{
  "mcpServers": {
    "htmlbook": {
      "url": "https://htmlbook.io/api/mcp",
      "headers": { "Authorization": "Bearer hb_live_REPLACE_WITH_YOUR_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml：

[mcp_servers.htmlbook]
url = "https://htmlbook.io/api/mcp"
bearer_token_env_var = "HTMLBOOK_API_KEY"

claude.ai / Claude Desktop — URL https://htmlbook.io/api/mcp を使ってカスタムコネクターを追加します（OAuth — 貼り付けるキーは不要です）。

すべてのクライアントについては、docs/getting-started.md をご覧ください。

2. ドキュメントを公開する

エージェントに頼むだけです。MCP サーバーが接続されていれば、エージェントが publish ツールを呼び出します。

You: Write up the Q3 numbers as a dashboard and put it on htmlbook.

Agent: htmlbook → publish
       ✓ shelved (hbdoc) · acme/q3-dashboard · v1 · read: https://htmlbook.io/app/p/acme/q3-dashboard

文章（レポート、計画、メモ）には Markdown が最適です。htmlbook は .md を信頼できる原本として保持し、テーマを適用した閲覧ビューを生成します。

{
  "tool": "publish",
  "project": "acme",
  "markdown": "# Q3 Review\n\nRevenue is up 8% QoQ...\n\n## Highlights\n- ..."
}

3. 共有する

ドキュメントはデフォルトで非公開です。リンクを誰でも開けるようにするには、公開にします。

Agent: htmlbook → set_access  (visibility: public)
       ✓ acme/q3-dashboard is now public · https://htmlbook.io/d/a1b2c3

これで一連の流れは完了です。生成 → 公開 → 共有。

---

公開できるもの

形式	用途	htmlbook の処理
Markdown	文章：レポート、計画、メモ、仕様書	.md を信頼できる原本として保持し、テーマを適用した閲覧ビュー（目次、表、コールアウト、タスクリスト）を生成します。Markdown としてダウンロードおよび編集もできます
hb-doc HTML	リッチなドキュメント：ダッシュボード、KPI、インライン SVG チャート	hb-* クラスと --hb-* トークンだけでスタイルを指定する <article class="hb-doc"> フラグメントです。閲覧側でスタイルシートを適用し、テーマ（ペーパー／セピア／ダーク、幅、フォントサイズ）を変更します
Bundle	独自の CSS/JS を含む自己完結型ページ	そのまま保存し、サンドボックス化された iframe で表示します。スクリプトは実行され、スタイルはそのまま保持されます。小規模な静的サイト向けに、相対リンクが機能する複数ファイル構成（index.html + サブページ + アセット、≤10MB）にも対応しています

形式は公開時に自動判別されます。形式を指定する必要はありません。Markdown、hb-doc フラグメント、完全に独立した HTML ページを送信すると、htmlbook が適切に処理します。

docs/publishing.md および docs/hb-doc-contract.md をご覧ください。

---

htmlbook を選ぶ理由

• ノート PC の外へ。 エージェントが生成した HTML は、生成したマシンから離れられません。 htmlbook を使えば、スマートフォンに表示して、共有可能なリンクにできます。
• どこでも読みやすい。 hb-doc 自体は CSS を含まないため、閲覧者がテーマを適用します。同じドキュメントが、暗い場所で使うスマートフォンでも、明るい場所で使うデスクトップでも適切に表示されます。
• バージョン管理。 公開するたび、また閲覧画面で編集するたびに、新しい変更不可のバージョンが作成されます。履歴パネルでは変更者と変更内容を確認でき、どのバージョンにも復元できます。
• Markdown は Markdown のまま。 Markdown をプッシュしても、情報を失う形で HTML に変換されることはありません。元の .md が信頼できる唯一の情報源であり、ダウンロード時にも元の形式に戻ります。
• デフォルトで非公開。 公開設定を切り替えるまでは、何も公開されません。共有モードは 3 種類あります。公開（誰でもアクセス可能）、パスワード保護（ログイン不要で、パスワードを知っている人なら誰でもアクセス可能。パスワードを変更すると、それまでのアクセス権は無効になります）、またはワークスペースでセッション認証されたシークレットリンクです。
• トークンを節約。 大きなドキュメントは、REST API 経由でファイルとしてプッシュできるため、そのデータがエージェントのコンテキストを通ることはありません。詳しくはdocs/rest-api.mdをご覧ください。

---

MCP ツール

htmlbook MCP サーバーは 10 個のツールを提供します。詳しいリファレンスは docs/mcp-tools.mdをご覧ください。

ツール	用途
publish	ドキュメント（HTML または Markdown）をホストされた URL に保存します。すでに存在する場合は新しいバージョンを作成します
guide	HTML を手作業で作成する前に、作成時の仕様（hb-doc のクラス、トークン、コンポーネント）を取得します
list	ライブラリを参照します。プロジェクトで絞り込むこともできます
get	ドキュメントのメタデータと現在の本文を取得します（Markdown の場合は .md ソース）
search	保存したすべてのドキュメントを全文検索します（再導出する前に情報を再確認できます）
organize	タイトル、タグ、パスの設定、プロジェクト間の移動、名前の変更を行います
set_access	ドキュメントを公開、パスワード保護、または非公開に設定します
cite	ドキュメント内の特定のセクション（見出し）への共有可能なディープリンクを取得します
restore	ドキュメントを以前のバージョンに戻します
delete	ドキュメントをゴミ箱に移動します

---

対応クライアント

クライアント	認証
Claude Code	MCP 経由の API キー、またはブラウザログイン。REST にも対応
Cursor	MCP 経由の API キー
Codex CLI	MCP 経由の API キー。REST にも対応
claude.ai	OAuth（カスタムコネクター）
Claude Desktop	OAuth（カスタムコネクター）
任意の MCP クライアント	Streamable HTTP + Bearer キーまたは OAuth 2.1

---

ドキュメント

• はじめに — 各クライアントの接続方法とキーの取得方法
• 公開 — 3 つの形式、publish ツール、使用例
• Markdown — 信頼できる唯一の情報源、フロントマター、フォルダー同期
• hb-doc の仕様 — クラス、トークン、コンポーネント
• 共有とアクセス — 公開、パスワード、シークレットリンク、ワークスペース
• MCP ツールリファレンス — 10 個すべてのツールと呼び出し例
• REST API — POST /api/docs、トークンを節約するファイルプッシュ
• examples/ — レポート、ダッシュボード、フォルダー同期の設定例

---

Streamize が開発しています。ドキュメントは MIT ライセンスです。 htmlbook 自体は htmlbook.io で提供されるホスト型サービスです。