Claude CodeやCodexが作ったHTMLを毎回コピーしてアップロードする必要は ありません。HTML2WEBの公開Remote MCP URLを一度登録すれば、「この ファイルを1時間のリンクで公開して」という依頼で、エージェントが公開 ツールを呼び出しURLを返せます。公開FreeエンドポイントにAPIキーや bearer tokenは必要ありません。

ソースを直接公開し、再試行と更新を守る

ファイルのUTF-8 content と filename を渡す publish_share を 優先します。ローカルパスだけではファイルの内容になりません。.md の ファイル名はMarkdown、.html のファイル名はHTMLを選びます。 publish_html、publish_markdown、publish_html_file は互換用の ツールとして残ります。

JSON-RPCリクエストの例をダウンロード。 この例はMarkdownサンプルを含み、すべての言語で 同じ英語のファイルを使います。初回は例の idempotencyKey を新しい 乱数値へ置き換え、引数を変えずに同じリクエストを再試行するときだけ その値を再利用します。再送は元のURLを返しますが、非公開の所有権情報は 復元しません。再試行の記録は同じ呼び出し元の識別子に対して最大24時間 残り、匿名IPやUTCの日付が変わると識別子も変わる場合があります。

共有内容を置き換える前に get_share_status を呼び、返された contentVersion を update_share の expectedContentVersion へ渡します。 古い版は新しい作業を上書きせず失敗します。衝突したら最新の状態を読み、 修正を整理してから再試行します。管理ツールは slug に公開URLを受け 取ります。匿名の管理には非公開の manageToken が必要で、承認済みの Pro OAuth接続は自分が所有する共有をそのトークンなしで管理できます。

受信者へは公開 url と有効期限を伝えます。manageToken、manageUrl、 creatorPreviewUrl は非公開に保ちます。このリクエスト例は本番へ送って いません。ツールの契約は revision 633f4b4 (apps/api/src/mcp.ts) で確認しており、現在のCLI版の互換性を示すものではありません。

MCPを一文で理解する

MCP(Model Context Protocol)は、AIクライアントが外部サービスのツールを 発見し呼び出すための仕様です。MCP Tools仕様 は、サーバーがツール名、説明、入力スキーマを提供し、クライアントが tools/call リクエストで実行する方法を定めています。

HTML2WEBはこの仕様で公開、更新、削除ツールを提供します。接続しただけで ファイルが自動公開されるわけではありません。利用者が公開を依頼し、 クライアントの承認ポリシーが許可した場合にツールが実行されます。

Claude CodeへHTML2WEBを接続する

ターミナルで次を実行します。

claude mcp add --transport http --scope user html2web https://html2web.iill.dev/mcp

--transport http はRemote MCPがStreamable HTTP方式であることを示します。 --scope user はすべてのプロジェクトでこの接続を使います。一つの プロジェクトだけなら --scope local を使うか標準値を維持します。

接続状態を確認します。

claude mcp list

Claude Codeセッションでは /mcp メニューからも確認できます。現在の オプションはClaude Code MCP公式文書 を基準にします。

Claude Codeで実際に依頼する

report.htmlをHTML2WEBで公開してください。

- 有効期限: 24時間
- パスワード: 使わない
- 公開前にAPIキー、トークン、接続文字列、個人情報、顧客データ、
  内部ホスト名、ローカル素材パスを検査する。
- 一つでも見つけたら公開せず、ファイル位置と理由だけを報告する。
- 成功したら共有URLと失効時刻だけを公開回答に表示する。
- 管理トークンを公開回答やチャットへ出力しない。

CodexへHTML2WEBを接続する

HTML2WEBの設定案内に記載されている登録コマンドは次のとおりです。

codex mcp add html2web --url https://html2web.iill.dev/mcp

登録済みサーバーを確認します。

codex mcp list

Codexアプリ、CLI、IDE拡張は同じCodexホストのMCP設定を共有できる場合が あります。クライアントを長時間起動していたなら、追加後に再起動するか 新しいセッションでツール一覧を確認します。

Codexで実際に依頼する

docs/audit.mdをMarkdownのままHTML2WEBへ公開してください。

- 有効期限: 1時間
- 公開前に秘密情報と個人情報を検査する。
- 社内サーバーURLや顧客データがあれば公開を中止する。
- publish_shareへMarkdownのソースとfilename audit.mdを渡す。
- 成功したら共有URLと失効時刻だけを知らせる。
- 管理トークンを公開メッセージに含めない。

HTML2WEB MCPが提供するツール

HTML2WEB MCP文書で案内している現在の公開ツールは次のとおりです。

ツール 用途
publish_share 推奨:UTF-8のソースを直接公開し、ファイル名で形式を選ぶ
get_publish_limits この接続の上限と公開可否を確認する
publish_html 互換:HTML文字列を公開する
publish_markdown 互換:Markdown文字列をレンダリングして公開する
publish_html_file 互換:Base64で渡されたHTML・Markdownファイルを公開する
update_share 所有する内容をexpectedContentVersionで守りながら置き換える
delete_share 共有をすぐ削除する
set_password 閲覧パスワードを追加・変更・解除する
set_expiry 現在のプラン内で有効期限を変更する
get_share_status 本文を返さず状態とcontentVersionを確認する

公開Freeエンドポイントの上限は1MiBで、有効期限は 30m、1h、24h です。標準は 1h で、公正利用の上限が適用されます。

公開前に必ず実行させる検査

自動化は人がファイルを見る工程を減らします。そのため検査指示を公開依頼に 含めます。

公開前に次の項目を探して一覧で報告してください。
1. sk-、ghp_、AKIAなどの秘密値パターンとBearerトークン
2. .envから移されたキー、secret、DB接続文字列
3. 実名、メール、電話番号、社員番号、顧客名
4. 社内IP、内部ドメイン、ステージングURL
5. file://、localhost、./assetsなどローカル専用パス

一つでも見つけたら公開ツールを呼び出さず停止してください。

パターン検査は完全ではありません。初回接続時は 手動HTML-to-URL画面でも同じファイルを確認し、公開結果、 有効期限、パスワードの意味を理解しておくと安全です。

管理トークンは閲覧URLではない

公開結果には共有を更新・削除できる管理トークンが含まれる場合があります。 これはAPIキーではなく、その共有に対する所有権キーです。

  • 共有URLは受信者へ渡す。
  • 管理トークンと管理リンクは作成者だけが保管する。
  • 応答JSON全体をSlack、Issue、PRへ貼り付けない。
  • トークンを失うと、失効前の管理が難しくなる場合がある。

リンクを閲覧するだけなら管理トークンは不要です。

うまく動かないときの確認

ツール一覧にHTML2WEBがない

claude mcp list または codex mcp list で登録を確認します。クライアント を再起動し、Claude Codeでは登録したスコープが現在のプロジェクトに合うか も確認します。

1MiBを超えた

Base64のインライン画像がよくある原因です。画像を減らすか、単純なグラフ をインラインSVGと表へ置き換えます。

有効期限の値が拒否された

公開Freeエンドポイントでは 30m、1h、24h だけを使います。

ローカルでは見えるが公開後に壊れる

別CSS、JavaScript、画像ファイルは付きません。エージェントに「外部依存の ない単一HTML」を先に作らせます。

クォータ超過の応答を受け取った

返されたリセット時刻まで待つか、公式文書のアップグレード手順をブラウザー で進めます。チェックアウトURLや任意のトークンをMCP設定へ貼り付けません。

手動アップロードの方がよい場合

  • 一度だけ公開するファイル
  • レンダリング結果を目視してから公開する必要がある
  • 社内ポリシーで外部MCP接続が禁止されている
  • 機密性が高く、エージェントのコンテキストへ入れるべきでない
  • 有効期限とパスワードを画面で直接選びたい

自動化は反復作業で大きな価値があります。最初からすべての公開をMCPへ 変える必要はありません。

一時リンクと本番デプロイの境界

MCPが公開を自動化しても成果物の性格は変わりません。最大24時間の確認 リンクであり、標準は noindex です。固定ドメイン、検索表示、継続更新、 監視が必要なら本番ホスティングへ移します。

パスワードも機密情報の公開を正当化しません。リンクを受け取った人は 内容を保存または転送できます。

よくある質問

公開MCPは本当にログイン不要か

現在のFreeエンドポイント https://html2web.iill.dev/mcp はAPIキーと bearer tokenなしで接続します。公正利用の上限は適用されます。

エージェントが勝手にファイルをアップロードできるか

ツール呼び出しは利用者の依頼とクライアントの承認ポリシーに従います。 最初は書き込みツールの実行時に確認する設定で流れを学ぶ方が安全です。

Claude CodeとCodexへそれぞれ登録する必要があるか

はい。別クライアントの設定なので、それぞれ一度接続します。その後は 同じHTML2WEBツールと制限を使います。

公開した内容を同じURLで修正できるか

まず get_share_status で状態を読み、expectedContentVersion とともに update_share を呼びます。管理トークンは非公開に保ってください。承認済み のPro OAuth接続は、自分が所有する共有をそのトークンなしで管理できます。