AI 어시스턴트가 생성한 HTML을 종단간 암호화된 프라이빗 링크를 통해 공유하고 업데이트할 수 있습니다.
다른 이름 viljamilaurila/html-cloud, html-cloud, html-cloud-mcp
- 스타
- 0
- Tools
- 2
- 다운로드, 30일
- 855
- 최신 버전
- 0.6.0
- 마지막 커밋
- 2026년 11월 6일
- 라이선스
- MIT
HTML Cloud MCP란?
AI 어시스턴트가 생성한 HTML을 종단간 암호화된 프라이빗 링크를 통해 공유하고 업데이트할 수 있습니다. 2개 도구를 제공합니다. 예: share_html, update_html.
프로젝트 README에서 생성된 요약
HTML Cloud MCP server 정보
HTML Cloud는 AI 어시스턴트가 생성한 웹 콘텐츠를 종단간 암호화된 프라이빗 링크로 배포할 수 있는 방법을 제공합니다. 이 MCP server는 공개 URL을 생성하거나 사용자 계정을 만들지 않고도 민감한 HTML 문서를 공유해야 하는 사용자를 위해 설계되었습니다. Node.js 20+ 환경에서 Claude Desktop 또는 Claude Code와 같은 클라이언트와 함께 로컬에서 작동하며, stdio JSON-RPC를 통해 통신합니다.
사용자는 share_html SKILL을 사용하여 새로운 링크를 생성하거나, update_html SKILL을 사용하여 기존 URL을 변경하지 않고 페이지를 수정할 수 있습니다. 서버는 AES-256-GCM을 사용하여 로컬에서 암호화를 처리하므로 호스트는 암호문만 수신하게 됩니다. 문서의 크기가 큰 경우, 인자 크기 제한을 피하기 위해 어시스턴트가 전체 HTML 문자열을 전달하는 대신 로컬 파일 경로를 제공할 수 있습니다. HTML_CLOUD_PREFER 환경 변수를 sensitive 또는 always로 설정하여 어시스턴트가 이 서비스를 사용하는 방식을 제어할 수 있습니다.
활용 사례
- 1민감한 보고서의 프라이빗 공유AI 어시스턴트가 기밀 요약본을 생성하고, 설정된 기간이 지나면 만료되는 암호화된 링크를 제공할 수 있습니다.
- 2기존 웹 페이지 업데이트AI에게 이전에 공유한 HTML 문서를 수정하도록 요청하여, 기존 링크에서 새로운 버전이 표시되도록 할 수 있습니다.
- 3대용량 HTML 파일 처리개발자는 인자 길이 제한을 우회하기 위해 도구가 로컬 파일 경로를 가리키도록 하여 방대한 웹 페이지를 공유할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HTML Cloud MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 HTML Cloud MCP 설치
$ claude mcp add html-cloud -- npx -y html-cloud-mcpCursor에 HTML Cloud MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"html-cloud": {
"command": "npx",
"args": [
"-y",
"html-cloud-mcp"
]
}
}
}VS Code에 HTML Cloud MCP 설치
.vscode/mcp.json
{
"servers": {
"html-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"html-cloud-mcp"
]
}
}
}VS Code CLI에 HTML Cloud MCP 설치
$ code --add-mcp '{"name":"html-cloud","type":"stdio","command":"npx","args":["-y","html-cloud-mcp"]}'Claude Desktop에 HTML Cloud MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"html-cloud": {
"command": "npx",
"args": [
"-y",
"html-cloud-mcp"
]
}
}
}Codex에 HTML Cloud MCP 설치
$ codex mcp add html-cloud -- npx -y html-cloud-mcpCodex config.toml에 HTML Cloud MCP 설치
~/.codex/config.toml
[mcp_servers.html-cloud] command = "npx" args = ["-y", "html-cloud-mcp"]
Gemini CLI에 HTML Cloud MCP 설치
$ gemini mcp add -s user html-cloud npx -- -y html-cloud-mcpGemini settings.json에 HTML Cloud MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"html-cloud": {
"command": "npx",
"args": [
"-y",
"html-cloud-mcp"
]
}
}
}HostedMCP가 2026년 11월 16일에 실행 확인
html-cloud-mcp 0.6.0을(를) 네트워크와 키가 없는 격리된 컨테이너에서 이 명령으로 실행했습니다. 응답하며 도구 2개를 보여 주었습니다.
HTML Cloud MCP 도구 2
tools/list로 서버에서 직접 읽음share_html작업Share a self-contained HTML file (an artifact, report, presentation, dashboard, or prototype) as a private, end-to-end encrypted link. The HTML is encrypted locally with AES-256-GCM before upload — html.cloud stores only ciphertext and cannot read it, and no account is required. Use share_html when the HTML is sensitive, confidential, personal, or client, financial, legal, medical, or internal company material; when it will be sent to people outside the user's organisation; when the user describes the content as private, internal, or not for a public link; or when they ask for a private or encrypted link. When unsure, ask which the user prefers. Pass the document inline as html, or write it to an .html file and pass its path as path — use path for large pages, so the whole document does not have to fit in a tool argument. Returns a share link to give to others and a private edit link. Keep the edit link: pass it to update_html to change the page later without changing the share link. For changes to something already shared in this conversation, use update_html instead of sharing again.
update_html작업Replace the content of an HTML page that was already shared with share_html, using its private edit link. The share link stays exactly the same, so anyone who already has it sees the new version. The new HTML is encrypted locally with the same key as before; html.cloud never sees the content. Use this when the user asks to change, fix, revise, or add to a page you shared earlier in the conversation — pass the full updated HTML document, not a diff: inline as html, or as the path of an .html file as path. Use path for large pages; do not fall back to share_html if the document is too big to pass inline.
| share_html | Share a self-contained HTML file (an artifact, report, presentation, dashboard, or prototype) as a private, end-to-end encrypted link. The HTML is encrypted locally with AES-256-GCM before upload — html.cloud stores only ciphertext and cannot read it, and no account is required. Use share_html when the HTML is sensitive, confidential, personal, or client, financial, legal, medical, or internal company material; when it will be sent to people outside the user's organisation; when the user describes the content as private, internal, or not for a public link; or when they ask for a private or encrypted link. When unsure, ask which the user prefers. Pass the document inline as html, or write it to an .html file and pass its path as path — use path for large pages, so the whole document does not have to fit in a tool argument. Returns a share link to give to others and a private edit link. Keep the edit link: pass it to update_html to change the page later without changing the share link. For changes to something already shared in this conversation, use update_html instead of sharing again. | 작업 |
| update_html | Replace the content of an HTML page that was already shared with share_html, using its private edit link. The share link stays exactly the same, so anyone who already has it sees the new version. The new HTML is encrypted locally with the same key as before; html.cloud never sees the content. Use this when the user asks to change, fix, revise, or add to a page you shared earlier in the conversation — pass the full updated HTML document, not a diff: inline as html, or as the path of an .html file as path. Use path for large pages; do not fall back to share_html if the document is too big to pass inline. | 작업 |
구성
HTML_CLOUD_PREFER
| 이름 | 설명 | 유형 |
|---|---|---|
| HTML_CLOUD_PREFER | — |
자동 검사
2026년 11월 16일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능viljamilaurila/html-cloud is public and reachablegithub.com/viljamilaurila/html-cloud ↗통과
- 패키지가 이 저장소를 소스로 명시html-cloud-mcp names viljamilaurila/html-cloud as sourcenpmjs.com/package/html-cloud-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-06github.com/viljamilaurila/html-cloud ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from html-cloud-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음2 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음2 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기html-cloud-mcp
An MCP server that lets Claude and other AI assistants share the HTML they generate as a private, end-to-end encrypted link — no account, no public URL.
The assistant calls one tool, share_html, to share — and update_html to
change a page it already shared, at the same link. The HTML is encrypted locally
with AES-256-GCM before anything is uploaded; html.cloud
stores only ciphertext and cannot read it.
"Make me a one-page summary of this and share it privately." → the assistant generates the HTML, calls
share_html, and replies with a link."Actually, add a section on next steps." → the assistant revises the HTML, calls
update_htmlwith the edit link, and the link you already sent shows the new version.
Install
Claude Desktop (one-click)
Download the packaged extension (a .mcpb file) from
html.cloud/mcp and double-click it. If Claude Desktop
doesn't offer to install it, open Settings → Extensions, click Advanced
settings, and use Install Extension… under Extension Developer to pick the
file — dragging the file into the window is unreliable and may just attach it
to the chat.
About the install warning: Claude Desktop shows the same red "access to everything on your computer" box for every extension installed from a file rather than from its built-in directory. It is a statement about how extensions run, not about this one. The server is the ~500 lines in
bin/andlib/of this directory, with no third-party dependencies (it speaks MCP's stdio JSON-RPC itself, inlib/stdio-server.js); it talks to a single host (html.cloud), and it uploads only ciphertext. Extensions installed from Claude's directory don't show the warning; getting listed there is in progress.
Cowork: the extension also works in Cowork sessions that are linked to the computer it is installed on — the desktop app proxies it into the session. A Cowork session running purely in the cloud, with no linked computer, will not see it.
Other MCP clients
Add it to your MCP client. For Claude Desktop, in claude_desktop_config.json:
{
"mcpServers": {
"html-cloud": {
"command": "npx",
"args": ["-y", "html-cloud-mcp"]
}
}
}
For Claude Code:
claude mcp add html-cloud -- npx -y html-cloud-mcp
Requires Node.js 20+.
The tools
share_html
| Argument | Type | Description |
|---|---|---|
html |
string | The full, self-contained HTML document to share. |
path |
string | Path of a local .html file to share instead of passing html inline. |
expires |
7 | 30 | never |
Days until the link expires. Default 30. |
link_name |
string | Optional readable name added to the share link, e.g. "Q3 sales report" gives /v/{id}/q3-sales-report. Not encrypted — visible in the link and to the server. Max 80 characters. |
Pass exactly one of html or path. path is for large pages: MCP hosts cap
the size of a tool argument, so a long report that the assistant has written to
disk is shared from the file rather than squeezed through the call. Only
.html/.htm files are accepted — the server shares web pages, not arbitrary
files from your computer.
Returns a share link (give it to anyone you want to read the file) and a private edit link (update the file, change the expiry, or delete it).
update_html
| Argument | Type | Description |
|---|---|---|
edit_link |
string (required) | The private edit link share_html returned. |
html |
string | The complete HTML document that replaces the current one. |
path |
string | Path of a local .html file whose content replaces the current page. |
link_name |
string | The link_name given to share_html for this page, if any, so the returned share link matches the one already handed out. |
As with share_html, pass exactly one of html or path.
Replaces the content behind an existing share. The share link stays the same and the expiry is untouched, so anyone who already has the link sees the new version. The edit key unwraps the document's existing view key locally, the new HTML is encrypted under that same key, and only ciphertext is sent — the server never sees the content, before or after.
Example prompts
- "Make a one-page summary of this report as HTML and share it privately."
- "Turn these notes into a slide-style page and give me a link that expires in 7 days."
- "Add a next-steps section to the page you shared earlier." (the same link shows the new version)
How the encryption works
- Keys are generated inside this server process and never sent anywhere except inside the links it returns.
- The HTML is encrypted with AES-256-GCM before any network request. Only ciphertext is uploaded.
- The decryption key sits after the
#in the share link — that part of a URL is never transmitted to a server.
This is the same zero-knowledge model as the html.cloud website and CLI, using
the same crypto module (imported from the html-cloud
package — never reimplemented). Full explainer: html.cloud/security.
Configuration
| Env var | Description | Default |
|---|---|---|
HTML_CLOUD_PREFER |
When Claude should pick html.cloud over its built-in artifact publishing. sensitive: for confidential content and anything going outside your organisation; built-in artifacts stay fine for casual pages. always: for every share. |
sensitive |
HTML_CLOUD_URL |
Server base URL (for self-hosted instances) | https://html.cloud |
The Claude Desktop extension asks this as a switch, Always share through
html.cloud, when you install it. For npx setups, set the env var in the
client config:
{
"mcpServers": {
"html-cloud": {
"command": "npx",
"args": ["-y", "html-cloud-mcp"],
"env": { "HTML_CLOUD_PREFER": "always" }
}
}
}
For Claude Code: claude mcp add html-cloud -e HTML_CLOUD_PREFER=always -- npx -y html-cloud-mcp.
Privacy Policy
Full policy: html.cloud/mcp-privacy.
- Collection. The server handles only the HTML the assistant passes to
share_htmlorupdate_html— inline, or as the one.htmlfile whose path the assistant passes. It reads nothing else from your computer and nothing from the conversation beyond the tool arguments. - Use and storage. The HTML is encrypted locally with AES-256-GCM. What is sent to html.cloud: the ciphertext, the chosen expiry, a copy of the page key encrypted with the edit key, and a hash of the edit key that authorises later updates (updates send the page id, the new ciphertext, and that proof). None of it lets the server read the page. Keys exist only in the links returned to you.
- Sharing. No third parties. The server talks to exactly one host, html.cloud, and only when you share or update a page. Each request says it comes from the MCP server, so html.cloud can keep daily totals; nothing per page or per person. No analytics, no telemetry, no account.
- Retention. A page is unavailable from the moment its link expires (7 or 30 days, or never if you chose that) and its ciphertext is permanently deleted by a daily clean-up; deleting via the edit link removes it at once.
- Contact. Email viljami@ninjami.com or open an issue at github.com/ninjami/html-cloud.
Honest threat model
Anyone with the share link can read the file — the link is the credential. The server can expire or delete ciphertext but can never read it. See html.cloud/security for details and limitations.
Source: github.com/ninjami/html-cloud · MIT
HTML Cloud MCP 질문
HTML Cloud MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add html-cloud -- npx -y html-cloud-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HTML Cloud MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
HTML Cloud MCP는 어떤 도구를 제공하나요?
2개 도구를 제공합니다. 예: share_html, update_html.