NanoSite
Build, edit and publish your website or online store from any AI chat, and run store products, orders and discounts.
Hosted MCP Server
npx add-mcp 'https://nanosite.ai/api/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Connect your AI agent
Connect NanoSite to the AI agent you already use (Claude, ChatGPT, Cursor, VS Code, Gemini CLI or any other app that supports MCP) and run your store or website from that chat. The agent can do what the AI builder in NanoSite does: start a new store or website, add and edit products, look at orders, manage add-ons, change pages, sections and text, create and polish images, show you a draft and publish. You don't download anything, and you don't need to be a developer. Everything happens on your NanoSite project.
What you need
- A NanoSite account. You don't need a project yet: the agent can create one for you.
- An AI app that supports remote MCP servers. The steps for the most common ones are below.
Every app uses the same connector:
| URL | https://nanosite.ai/api/mcp |
| Transport | Streamable HTTP |
| Sign-in | OAuth: your app opens a NanoSite page where you log in and click Allow |
You can also copy the URL from Account settings → Connected apps and devices on NanoSite.
Claude (claude.ai and Claude Desktop)
- In Claude, open Settings → Connectors.
- Click Add custom connector.
- Name it
NanoSite, pastehttps://nanosite.ai/api/mcpas the URL and click Add. - Click Connect, log in to NanoSite if you need to, and click Allow.
- In a chat, turn on NanoSite in the tools menu.
A connector you add on claude.ai also shows up in Claude Desktop and the mobile apps. If you don't see Add custom connector, your plan may not include custom connectors, or your organization's admin has to add it.
Claude Code
claude mcp add --transport http nanosite https://nanosite.ai/api/mcp
Then run /mcp, pick nanosite and choose Authenticate.
ChatGPT
- Open Settings → Apps & Connectors. Custom connectors may need Developer mode, under Advanced settings, depending on your plan.
- Click Create, name it
NanoSite, pastehttps://nanosite.ai/api/mcpand choose OAuth. - Sign in to NanoSite and click Allow.
- In a chat, add NanoSite from the tools menu.
Cursor
Add NanoSite to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"nanosite": { "url": "https://nanosite.ai/api/mcp" }
}
}
Open Cursor Settings → MCP and click Login next to nanosite.
VS Code (GitHub Copilot)
Add NanoSite to .vscode/mcp.json, or run MCP: Add Server from the command palette:
{
"servers": {
"nanosite": { "type": "http", "url": "https://nanosite.ai/api/mcp" }
}
}
Start the server from the file or the MCP Servers view and sign in when asked. Use Copilot Chat in Agent mode.
Gemini CLI
Add NanoSite to ~/.gemini/settings.json:
{
"mcpServers": {
"nanosite": { "httpUrl": "https://nanosite.ai/api/mcp" }
}
}
Then run /mcp auth nanosite in Gemini CLI.
Any other MCP app
Add a remote MCP server with the URL https://nanosite.ai/api/mcp (Streamable HTTP). If your app supports MCP sign-in (OAuth), it finds the NanoSite login page on its own, and you click Allow.
If your app can't sign in with OAuth, use an access token instead:
- On NanoSite, open Account settings → Connected apps and devices and click Create access token.
- Give it a name you'll recognize, click Create token and copy it. It's shown only once.
- In your app, add the connector URL and send the token in a header:
{
"mcpServers": {
"nanosite": {
"url": "https://nanosite.ai/api/mcp",
"headers": { "Authorization": "Bearer <your access token>" }
}
}
}
The header setting has a different name in each app. An access token works only with the connector (it can't publish or push code on its own), and it stops working after 90 days without use. Keep it private like a password, and revoke it on NanoSite if it leaks.
Start a new store or website
Ask the agent to create a project, for example "Start a new store called Candle Co". It shows you the templates you can start from, asks which one you want and what to call it, and then creates the project on your account, the same as New project in NanoSite. A new store starts with the template's demo products, so you can see it working right away.
The agent then gives you two links: the project in NanoSite and a draft link. It can start editing the new project in the same chat. Nothing is live until you publish.
Your plan decides which kind of project you can create and how many. If your plan doesn't include it, the agent tells you and gives you the link to upgrade.
Images
The agent has the same image tools as the AI builder:
- Create or edit an image for your pages, like a hero banner, an illustration or a background, or change one that's already in your project (swap its background, recolor it, add or remove something). Each image uses one of your plan's image credits, the same as in the builder.
- Resize an image to the size it's shown at, so pages load fast. The original is kept.
- Enhance a product photo in your store: put it on a clean white background, improve the lighting, fix colors or sharpen and upscale it. Color, detail and upscale are free. The background and lighting styles use one image credit per version, and the agent can make a few for you to choose from. Your product keeps its old photo until you pick a new one and the agent puts it on the product.
When the connector is added on claude.ai or in ChatGPT's settings (it then also shows up in their desktop and mobile apps, and in Claude Code), creating images and the AI background and lighting styles aren't available: those apps' connector directories don't allow AI image generation. Resizing and the free color, detail and upscale fixes still work. To create images, use the AI builder in NanoSite, or add the connector directly in an app like Claude Code (claude mcp add), Cursor, VS Code or Gemini CLI.
Images you add to a chat in your AI app can't be sent to NanoSite yet. To work with your own photo, upload it in NanoSite first (to the product, or in the builder), then ask the agent.
What to ask
Start by saying which project you mean. The agent can list your projects if you're not sure.
- "Create a new store for my candles from a template you think fits, and call it Candle Co."
- "In my Candle Co store, add a product: Lavender soy candle, $24, 30 in stock."
- "Which orders from this week haven't shipped yet?"
- "Add a 10% off code SPRING for the next two weeks."
- "Make the homepage hero full width and change the headline to 'Hand-poured in Lisbon'."
- "Add a short FAQ section to the About page of my website."
- "Make a wide hero image of a sunlit candle workshop and use it on the homepage."
- "Put the photos of my three newest products on a white background and show me the options."
- "Show me the draft, then publish it."
NanoSite marks every tool that changes or deletes something, so apps that ask before acting (most do) ask you first. Turning an add-on on or off always needs your clear yes in the chat.
See your changes
After every change to your pages, the agent gets a draft link and checks that the build passes. Open the link to see your site with the change before anyone else does. Nothing is live until you publish.
Store data, like products, prices and discount codes, is not part of the draft: it changes right away, the same as when you edit it in NanoSite.
Let the agent look at the draft too. The agent can open the draft link itself, check the page on desktop and mobile, and fix what it finds. For that it needs a browser tool. The Playwright MCP server works in any MCP app that runs local servers (Claude Desktop, Claude Code, Cursor, VS Code, Gemini CLI). It needs Node.js on your computer. Add it next to NanoSite:
{
"mcpServers": {
"playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] }
}
}
- Claude Desktop: paste this into Settings → Developer → Edit Config and restart.
- Claude Code:
claude mcp add playwright -- npx -y @playwright/mcp@latest - Cursor, VS Code, Gemini CLI: add it to the same file as NanoSite (VS Code uses
"servers"and"type": "stdio"). - claude.ai in Chrome: use the Claude in Chrome extension instead.
Then ask: "Open the draft link, check it on mobile, and fix anything that looks broken."
Without a browser tool, the agent can still read the page's HTML and checks that the build passes. It just can't see the layout.
Publish
Ask the agent to publish when you're happy with the draft. It builds your site first and publishes exactly the latest saved version, the one in the draft. If the build fails, the agent tells you why and nothing goes live. Only the project's owner can publish; you can always publish from NanoSite too.
Works together with the AI builder
Your agent and the AI builder in NanoSite work on the same project. Changes the agent makes show up in the builder's chat, and you can undo them from the builder's restore list like any other change.
Your account and safety
- The agent only reaches the projects you're a member of, with the permissions you allowed.
- Draft links the agent gets stop working when you disconnect it.
- Payment keys and other secrets are never shown to the agent. When one is needed, NanoSite asks you to enter it on nanosite.ai.
To disconnect, remove the connector in your app, or revoke it under Account settings → Connected apps and devices on NanoSite. Each connection is listed by the app's name. If you connected the same app on more than one computer, each one is listed and revoked separately.
Troubleshooting
| Problem | Fix |
|---|---|
| The agent says it has no NanoSite tools | Turn on NanoSite in the chat's tools menu, or check the app's MCP settings. |
| The approval page says the request is invalid or expired | Connect again from your app; the page is valid for a few minutes. |
| "Project not found, or you don't have access to it" | Log in to NanoSite with the account that owns the project, then reconnect. |
| "Image generation limit reached" | You've used this period's image credits. They reset with your billing period, or upgrade for more. |
| The agent can't create a project | Your plan may not include that kind of project, or you've reached your project limit. Follow the upgrade link the agent gives you. If the agent has no tool to create one, reconnect NanoSite and allow access. |
| "NanoSite's AI builder is working on this project right now" | The builder is in the middle of a change. Try again in a minute. |
| The app keeps asking to sign in | Disconnect and connect again. If you revoked it on NanoSite, that's expected. |
| The agent can't see the draft | Add a browser tool (see See your changes), or open the link yourself. |
| A draft link shows "Site not found" | The app that made it was disconnected, or the link is older than 7 days. Ask the agent for a new link. |
Help and support
Something not working, or a question about the connector? Email [email protected] and tell us which AI app you use. You can also browse the help center. How we handle your data when an AI app is connected is described in our privacy policy.
Related
- Your store also has a separate, read-only catalog MCP on its own domain, for agents that only need to look up products.
- If you're a developer and want the code on your computer, see Develop locally.