{"id":"4b27429e-5bba-4cdc-bc44-44ca5a5be932","slug":"artifact-site","kind":"mcp","name":"artifact-site","summary":"A self-hosted home for your team’s AI-generated pages and documents. Publish HTML, build folders, ZIPs and PDFs as sandboxed, versioned links. CLI + remote MCP for AI agents.","owner":"lexmount","repoUrl":"https://github.com/lexmount/artifact-site","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":18,"match":null,"fewStars":false,"format":"mcp","createdAt":"2026-09-14T06:00:45.000Z","addedAt":"2026-10-14T05:04:24.139Z","logoUrl":"https://avatars.githubusercontent.com/u/231927209?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","browser-web","developer-tools"],"tags":["ai-agents","artifacts","claude-artifacts","nextjs","self-hosted","static-hosting","claude-code","docker"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T03:14:31.392Z","sample":false,"url":"https://conduits.dev/tools/artifact-site","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"

\n \n \n \n \"artifact-site\n \n

\n\n

artifact-site

\n\n

\n English |\n 简体中文 |\n 日本語 |\n Deutsch |\n Français |\n Español\n

\n\n

\n \"CI\"\n \"License:\n \"Node\n \"Roadmap\"\n \"npm\"\n \"GitHub\n

\n\nThere are now so many AI agents to choose from, but their output is scattered across your computer, chat histories and different platforms’ clouds, making it hard to organize, share and revisit.\n\n**artifact-site is a self-hosted workspace for individuals and teams, similar to Claude Artifacts or OpenAI Sites.** Your various agents create the work; artifact-site brings it together, turning pages and documents into links for sharing, comments and feedback, access control and version history. The agents you already use can keep editing, publishing, searching and updating that work through the CLI or MCP.\n\nYou can self-host artifact-site or use the cloud version hosted by Lexmount.\n\n> **[Use the cloud version](https://yours.lexmount.com/artifact-site)** — hosted by Lexmount, with no deployment required. Drag and drop a file to publish it and get a shareable link. Upload without signing in, or **sign in with Google or GitHub** to keep your sites, organize them in folders and control who can open each link.\n>\n> Anonymous uploads expire after a few days.\n\n

\"Dropping

\n

Drop a file, get a link, share it. View your published work online and choose who can open it in the sharing settings.

\n\n## Why artifact-site\n\n- **Keep work in one place.** Organize pages and documents in folders and find them with full-text search, including Chinese. Team members and agents can find the work they have permission to access.\n- **Drop it in and share it.** Upload HTML, a build folder, a ZIP or a document to get a link. Large sites upload in chunks. Share with everyone, signed-in users, named people or passcode holders.\n- **Keep improving published work.** Edit HTML text or source in the browser, or let an agent update the whole site. Each change keeps a version, with rollback and the option to save a copy.\n- **Let agents pick up where they left off.** Publish and update through the guide, CLI or MCP, then search by content and read extractable text. For example, find a previous report and update it at the same address for your team to view.\n\n## How it compares\n\n| For your team | Claude Artifacts / Claude Code Artifacts | ChatGPT Sites (OpenAI) | artifact-site |\n| --- | --- | --- | --- |\n| Hosting | Anthropic-managed | OpenAI-managed | **Your server**, with local or S3-compatible file storage |\n| Publishing workflow | Within Claude / Claude Code | Within ChatGPT Sites | **Any tool** via file upload, CLI or remote MCP |\n| Content focus | Interactive artifacts | Hosted websites and apps | Static HTML, build folders, ZIPs, PDF and Office documents¹ |\n| Identity | Claude accounts | ChatGPT accounts | **Your OIDC provider**, such as Google, Keycloak or Okta |\n\n¹ Office online preview requires Gotenberg. artifact-site hosts finished files; it does not run application backends or build jobs.\n\nClaude Artifacts and ChatGPT Sites combine creation and hosted sharing. artifact-site complements those workflows with a shared home on your own infrastructure for pages and documents produced by different tools.\n\nProduct scope and sharing vary by plan and evolve; see the official [Claude Artifacts](https://support.claude.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them) and [ChatGPT Sites](https://learn.chatgpt.com/docs/sites) guides.\n\n## Contents\n\n- [What you can publish](#what-you-can-publish)\n- [Quick start (local deployment)](#quick-start-local-deployment)\n- [Connect a coding agent](#connect-a-coding-agent)\n- [Deploy for your team](#deploy-for-your-team)\n- [How it works](#how-it-works)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [License](#license)\n\n## What you can publish\n\n| Content | What you can do |\n| --- | --- |\n| HTML, static site folders, ZIPs | Upload and preview single-page or multi-page sites, including build output such as `dist/`. HTML pages support visual text editing and source editing. |\n| PDF | Read online, search and extract text. |\n| Office documents, such as PPTX and DOCX | Store and download originals; enable Gotenberg for online preview. |\n\nBuild web projects into static files before uploading; the platform does not run application backends or build jobs. PDF and Office documents do not support visual HTML editing, and scanned images are not automatically OCRed.\n\nHosted pages run in a sandbox and cannot use the platform's login session. External API connections require an origin allowlist. See the [runtime limits](src/content/publish-skill.md) and [security design](SECURITY.md).\n\n## Quick start (local deployment)\n\nYou can use the [cloud version](https://yours.lexmount.com/artifact-site) without installing anything. To deploy locally, run the three commands below. You need Git, Make, Bash, Docker 24+ and the Compose plugin 2.24+. On macOS, use Docker Desktop; on Windows, run the commands inside WSL2 with Docker Desktop’s WSL integration enabled. No Node installation, domain or identity provider is needed.\n\n```bash\ngit clone https://github.com/lexmount/artifact-site.git && cd artifact-site\ncp .env.example .env\nmake build up\n```\n\nOnce started, open **http://127.0.0.1:4300** and drop in HTML, a static site folder or a PDF to view your work. New sites are private by default; change main-link access in Sharing before sending it to someone else.\n\nThe first run downloads dependencies and builds the image, then starts the app and Postgres. Use these commands in a fresh clone. The service is local-only by default; `make down` stops it and retains data. To make it reachable by your team, follow [Deploy for your team](#deploy-for-your-team).\n\n
\nNeed a file to try? Create a sample page\n\n```bash\nprintf 'Hello

Hello, artifact-site!

' > hello.html\n```\n\nDrop `hello.html` onto the home page (or choose **Upload**). You should see “Hello, artifact-site!”. Copy a link from the sharing settings; local-deployment links only open on the same machine.\n\n
\n\n## Connect a coding agent\n\nChoose the entry point that fits your agent:\n\n- **Skill**: `npx skills add lexmount/artifact-site` — install the [agent skill](skills/artifact-site/SKILL.md) and give your agent your server URL.\n- **CLI**: `npm install -g @artifact-site/cli` — requires Node 24+; use the commands below.\n- **MCP**: `https://your-server/mcp` — connect ChatGPT, Claude or another MCP client through the server’s OAuth sign-in; no CLI installation required. A client that only starts local MCP servers can run the CLI’s `artifact-site mcp` instead.\n\n**CLI and MCP create private artifacts by default, without independent share links.** Use `artifact-site visibility unlisted` or MCP `artifact_site_set_visibility` when the user asks to share the main link.\n\n

\"A

\n

Or let your coding agent do it. With the agent guide (/for-agents.md), the CLI or the MCP server, \"publish this and give me a link\" is one instruction — and the site can be updated, searched and read the same way.

\n\nGive this instruction to Claude Code, Cursor, Codex or another coding agent that can read URLs, using a server address it can reach. The home page also provides a copy button with your server address filled in:\n\n```text\nPublish this project's output to artifact-site. Publishing guide: https://your-server/for-agents.md\n```\n\nCLI examples (`login` requires OIDC):\n\n```bash\nartifact-site login --base https://your-server # one-time device sign-in\nartifact-site publish dist/ --title \"Q3 dashboard\" # publish and return links\nartifact-site find \"quota\" # search by content\nartifact-site read YOUR_SITE_SLUG # replace with a site slug to read its text\n```\n\n
\nAuthentication details\n\nOpen **Agent guide** on your deployment to choose the prompt, CLI or MCP path. `/for-agents#cli` and `/for-agents#mcp` provide server-specific commands, authentication steps and client configuration. Remote MCP authenticates every request: ChatGPT, Claude and other OAuth-capable clients sign in through the server's own consent page, other clients carry a personal token. Publishing is private by default; open main-link access explicitly with the visibility operation. Advanced independent links are opt-in.\n\nTeam deployments with OIDC support device sign-in approval; the anonymous local setup above does not require it. The agent follows the guide and the server's publishing policy to choose authentication. A cloud agent cannot directly reach `127.0.0.1` on your computer.\n\nThe login example requires OIDC. Remote MCP is a separate, complete entry point at\n`https://your-server/mcp`: no CLI installation is required. ChatGPT, Claude and any client that\nimplements MCP authorization connect with the address alone and sign in through the server's\nOAuth consent page; for other clients, the deployment's `/for-agents#mcp` page creates a\npersonal token and copies the authenticated configuration. It supports publishing, updating,\nsearch, read, sharing, versions, export and deletion, including binary files and directory\nuploads through MCP tools.\n\nSee [CLI commands](cli/README.md) and [remote MCP setup and tools](docs/MCP.md).\n\n
\n\n## Deploy for your team\n\nStart from [.env.example](.env.example) and follow [SELFHOST.md](SELFHOST.md) for a production deployment. Use a stable public address for `ARTIFACT_PUBLIC_URL`: sign-in callbacks, request-origin checks and the address given to agents derive from it:\n\n- Set a reachable `ARTIFACT_PUBLIC_URL` and configure a reverse proxy, or set `ARTIFACT_WITH_CADDY=on` with `ARTIFACT_DOMAIN` to enable Caddy and automatic certificates.\n- Choose a publishing policy. `login` requires OIDC; `token` serves scripts or agents with a Bearer token; `open` lets anyone who can reach the service publish and suits trusted internal networks. Anonymous publishing supports separate quotas and expiry.\n- Connect Google or an OIDC provider such as Keycloak, Logto, Authentik, Okta or Auth0. Accounts own sites and folders; agents can receive long-lived tokens through device sign-in. The default `ARTIFACT_ENFORCE_OWNERSHIP=on` enables account-based access control once OIDC is configured. Add administrators' verified sign-in emails to `ARTIFACT_ADMIN_EMAILS` to enable the admin console.\n- Enable Office preview with `ARTIFACT_WITH_GOTENBERG=on`. The admin console manages take-downs, quotas, anonymous-site expiry and policy switches. Choose default visibility and schedule backups.\n\nThe app ships as one Docker image with bundled Postgres in the single-host setup. To use an available prebuilt image, set `ARTIFACT_IMAGE` and run `make pull`. `make doctor` checks configuration; `make backup` and `make restore` handle backups and recovery. For multiple replicas, external Postgres and S3-compatible storage, see [DEPLOY.md](DEPLOY.md).\n\n## How it works\n\n- **Application and storage.** Next.js serves the UI and API, Postgres stores metadata, and files live on local disk or S3-compatible storage. External database and object storage support multiple app replicas.\n- **Immutable versions.** Each upload or edit writes a new file version, preserving historical content. Optimistic locking (`expected_version`) detects concurrent update conflicts.\n- **Content isolation.** Previews use sandboxed iframes without `allow-same-origin` and a restrictive CSP to isolate uploaded content from the platform. Path checks and decompression limits defend against path traversal and ZIP bombs.\n\nSee [ARCHITECTURE.md](ARCHITECTURE.md) for the architecture, data model and request flows.\n\n## Documentation\n\n| Document | What it covers |\n| --- | --- |\n| [SELFHOST.md](SELFHOST.md) | Single-machine deployment with `make up`, backups, upgrades, FAQ |\n| [DEPLOY.md](DEPLOY.md) | Multi-replica deployment: external Postgres, object storage, OIDC |\n| [.env.example](.env.example) | Every setting, grouped and explained |\n| [ARCHITECTURE.md](ARCHITECTURE.md) | System shape, data model, request paths, the sandbox |\n| [SECURITY.md](SECURITY.md) | Threat model and how to report a vulnerability |\n| [cli/README.md](cli/README.md) | The CLI |\n| [src/content/publish-skill.md](src/content/publish-skill.md) | The API contract and hosting limits, as served to agents |\n| [ROADMAP.md](ROADMAP.md) | What comes next: semantic search, comments on sites, and more |\n| [CHANGELOG.md](CHANGELOG.md) | What changed, release by release |\n\n## Contributing\n\nLocal development requires Node 24+ and Docker:\n\n```bash\nnpm install\nmake dev # start a disposable Postgres and the development server\nnpm test # unit tests, no external services needed\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution process, DCO sign-off and CI requirements. Report bugs and ideas in [issues](https://github.com/lexmount/artifact-site/issues); ask questions in [discussions](https://github.com/lexmount/artifact-site/discussions).\n\nIf artifact-site is useful to you, a ⭐ helps others find it. Using it with your team? Say hi in [Discussions](https://github.com/lexmount/artifact-site/discussions) — we’d love to list you.\n\n## License\n\nLicensed under either of\n\n- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))\n- MIT license ([LICENSE-MIT](LICENSE-MIT))\n\nat your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you shall be dual-licensed as above, without any additional terms or conditions.\n\n© 2025–2026 LexMount. Third-party components are listed in [NOTICE](NOTICE).\n"}