Connect Docklet to Claude
The Docklet connector lets Claude publish the HTML artifacts it creates — interactive guides, microsites, demos, reports, dashboards, landing pages — straight to a live, shareable URL. You ask Claude to build something; Claude publishes it to your Docklet account and hands you the link. Follow-up edits update the same link instead of creating a new one.
This page is the setup and usage guide for the connector. For data handling see our Privacy Policy; for the rules that govern published content see our Terms of Service (acceptable use and enforcement are in section 7 and section 13).
Contents
1. Before you start
- A free Docklet account.
- Claude with connector support (Claude.ai on a plan that allows adding connectors, or Claude Desktop). The connector speaks the Model Context Protocol (MCP) over HTTPS.
- The Docklet MCP endpoint:
https://app.docklet.io/mcp
2. Option A — connect with OAuth (recommended)
OAuth is the simplest and safest way to connect: you sign in to Docklet in a browser window and approve access — no tokens to copy or store.
- In Claude, open Settings → Connectors and choose Add custom connector (wording varies by client).
- Enter the Docklet MCP URL:
https://app.docklet.io/mcp - Claude opens a Docklet sign-in and consent page. Sign in and click Approve.
- You're connected. Claude will list Docklet's tools and is ready to publish.
Behind the scenes Docklet uses the standard OAuth 2.0 authorization-code flow with PKCE and explicit user consent. You can revoke access at any time from the Docklet console (API tokens) or by removing the connector in Claude.
3. Option B — connect with a personal access token
If your client only lets you set a URL and headers, use a personal access token instead.
- In the Docklet console, open API tokens → Create token, name it (e.g. Claude), and copy the secret. It is shown once and stored only as a hash.
- Add the connector with the token in the
Authorizationheader:
{
"mcpServers": {
"docklet": {
"url": "https://app.docklet.io/mcp",
"headers": { "Authorization": "Bearer docklet_pat_xxxxxxxx" }
}
}
}
Clients that cannot send custom headers may pass the token as a query
parameter instead: https://app.docklet.io/mcp?token=docklet_pat_xxxxxxxx.
Treat the token like a password; revoke it any time from the console.
4. What Claude can do
Once connected, Claude has these Docklet tools:
| Tool | What it does | Changes data? |
|---|---|---|
whoami | Confirms which Docklet account is connected. | Read-only |
list_websites | Lists your Docklets with their ids, public URLs, and review status. | Read-only |
publish_website | Publishes a new Docklet and returns its live URL. | Creates |
update_website | Publishes a new version of an existing Docklet (same URL). | Updates |
set_website_status | Sets review status: draft, under_review, or agreed. | Updates |
delete_website | Deletes a Docklet by id. | Destructive |
Each tool is annotated so Claude knows which ones only read versus which change or remove content — Claude will confirm before destructive actions like deleting.
5. Example prompts
Try these once the connector is active:
"Build a one-page interactive product changelog as a polished HTML page and publish it to Docklet, then give me the link."
Claude designs the page and calls publish_website,
then returns the live URL.
"Update the changelog Docklet you just made — add a dark-mode toggle and a new 'v2.0' section."
Claude calls list_websites to find it, then
update_website — the link stays the same.
"List my Docklets and mark the changelog one as under review."
Claude calls list_websites, then
set_website_status with under_review.
6. Visibility & who can see your Docklets
New Docklets are created with restricted visibility by default — they are not public until you choose to make them so. From the Docklet console (or the owner-only Share menu on a published page) you can set each Docklet to:
- Public — anyone with the link.
- Any signed-in user — must have a Docklet account.
- Selected users — only the email addresses you allow.
Visibility is enforced at the edge before any file is served. Changing visibility is done in the console — it is intentionally not exposed as a Claude tool, so the AI can't widen who sees your content.
7. Troubleshooting
| Symptom | Fix |
|---|---|
| "No Docklet API token found on this connection." | The connector isn't authenticated. Reconnect with OAuth, or
check the Authorization: Bearer header / ?token= value. |
| Claude created a second URL instead of updating. | Ask it to "update the existing Docklet" — it should use
list_websites then update_website. A fresh
publish_website always makes a new URL. |
| Publish fails on a large artifact. | Each Docklet is capped at 10 MB total across all files. Trim assets or split content. |
| OAuth window won't complete. | Make sure pop-ups are allowed and you're signed in to Docklet, then retry adding the connector. |
8. Support & security
Questions or problems: hello@docklet.io. Security or abuse reports: security@docklet.io. You control your data and can delete any Docklet — or your whole account — at any time; see the Privacy Policy for how we handle and retain data.