[{"data":1,"prerenderedAt":487},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmcp\u002Fquick-start":3,"docs-navigation":408,"docs-surround-\u002Fdocs\u002Fmcp\u002Fquick-start":484},{"id":4,"title":5,"body":6,"description":399,"extension":400,"icon":401,"meta":402,"navigation":403,"path":404,"seo":405,"stem":406,"__hash__":407},"docs\u002Fdocs\u002F2.mcp\u002F1.quick-start.md","Quick start",{"type":7,"value":8,"toc":391},"minimark",[9,13,17,39,44,232,239,243,246,254,258,261,271,290,299,303,306,311,325,329,337,354,358,387],[10,11,5],"h1",{"id":12},"quick-start",[14,15,16],"p",{},"Pick the path that matches your client. Each one ends with the same result: an MCP-capable agent that can publish files to a public HTTPS URL.",[18,19,21],"callout",{"type":20},"warning",[14,22,23,27,28,32,33,38],{},[24,25,26],"strong",{},"AI agents can make mistakes."," Review tool calls before approving destructive ones (",[29,30,31],"code",{},"delete_site",", overwrite deploys). You are responsible for the content your agent publishes. Hostsmith and ops42 OU are not liable for damages caused by AI-generated actions - see the ",[34,35,37],"a",{"href":36},"\u002Fterms-of-service","Terms of Service",".",[40,41,43],"h2",{"id":42},"_1-install-the-server","1. Install the server",[45,46,47,77,180],"tabs",{},[48,49,51],"tabs-item",{"label":50},"Claude Desktop",[52,53,54,61,74],"ol",{},[55,56,57,58,38],"li",{},"Open ",[24,59,60],{},"Settings → Connectors → Add custom connector",[55,62,63,64],{},"Paste the URL:",[65,66,71],"pre",{"className":67,"code":69,"language":70},[68],"language-text","https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\n","text",[29,72,69],{"__ignoreMap":73},"",[55,75,76],{},"Save. Claude Desktop opens your browser to authorize the connector against your Hostsmith account.",[48,78,80,88,177],{"label":79},"Claude Code \u002F Cursor \u002F Cline \u002F Windsurf \u002F Zed",[14,81,82,83,87],{},"Add this entry to your client's MCP config (file location varies by client - see the ",[34,84,86],{"href":85},"\u002Fdocs\u002Fmcp\u002Fclients","client setup page","):",[65,89,93],{"className":90,"code":91,"language":92,"meta":73,"style":73},"language-json shiki shiki-themes github-dark","{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@hostsmith\u002Fmcp-server\"]\n    }\n  }\n}\n","json",[29,94,95,104,114,122,138,159,165,171],{"__ignoreMap":73},[96,97,100],"span",{"class":98,"line":99},"line",1,[96,101,103],{"class":102},"s95oV","{\n",[96,105,107,111],{"class":98,"line":106},2,[96,108,110],{"class":109},"sDLfK","  \"mcpServers\"",[96,112,113],{"class":102},": {\n",[96,115,117,120],{"class":98,"line":116},3,[96,118,119],{"class":109},"    \"hostsmith\"",[96,121,113],{"class":102},[96,123,125,128,131,135],{"class":98,"line":124},4,[96,126,127],{"class":109},"      \"command\"",[96,129,130],{"class":102},": ",[96,132,134],{"class":133},"sU2Wk","\"npx\"",[96,136,137],{"class":102},",\n",[96,139,141,144,147,150,153,156],{"class":98,"line":140},5,[96,142,143],{"class":109},"      \"args\"",[96,145,146],{"class":102},": [",[96,148,149],{"class":133},"\"-y\"",[96,151,152],{"class":102},", ",[96,154,155],{"class":133},"\"@hostsmith\u002Fmcp-server\"",[96,157,158],{"class":102},"]\n",[96,160,162],{"class":98,"line":161},6,[96,163,164],{"class":102},"    }\n",[96,166,168],{"class":98,"line":167},7,[96,169,170],{"class":102},"  }\n",[96,172,174],{"class":98,"line":173},8,[96,175,176],{"class":102},"}\n",[14,178,179],{},"The first tool call opens your browser to authorize the server against your Hostsmith account.",[48,181,183,186,229],{"label":182},"Other Streamable-HTTP client",[14,184,185],{},"Point your client directly at the hosted server:",[65,187,189],{"className":90,"code":188,"language":92,"meta":73,"style":73},"{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"url\": \"https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\"\n    }\n  }\n}\n",[29,190,191,195,201,207,217,221,225],{"__ignoreMap":73},[96,192,193],{"class":98,"line":99},[96,194,103],{"class":102},[96,196,197,199],{"class":98,"line":106},[96,198,110],{"class":109},[96,200,113],{"class":102},[96,202,203,205],{"class":98,"line":116},[96,204,119],{"class":109},[96,206,113],{"class":102},[96,208,209,212,214],{"class":98,"line":124},[96,210,211],{"class":109},"      \"url\"",[96,213,130],{"class":102},[96,215,216],{"class":133},"\"https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\"\n",[96,218,219],{"class":98,"line":140},[96,220,164],{"class":102},[96,222,223],{"class":98,"line":161},[96,224,170],{"class":102},[96,226,227],{"class":98,"line":167},[96,228,176],{"class":102},[14,230,231],{},"The client handles OAuth automatically.",[14,233,234,235,38],{},"If you prefer self-hosting, see ",[34,236,238],{"href":237},"\u002Fdocs\u002Fmcp\u002Fclients#local-http-self-hosted","Local HTTP",[40,240,242],{"id":241},"_2-authorize","2. Authorize",[14,244,245],{},"The first time your agent calls a Hostsmith tool, your browser opens a Hostsmith consent screen. Sign in (or create a free account), confirm the scopes, and approve. The session lives in your client; you do not paste an API key anywhere.",[14,247,248,249,253],{},"You only do this once per client. See ",[34,250,252],{"href":251},"\u002Fdocs\u002Fmcp\u002Fauthentication","Authentication"," for what's happening under the hood.",[40,255,257],{"id":256},"_3-create-a-site","3. Create a site",[14,259,260],{},"In your agent, prompt:",[262,263,264],"blockquote",{},[14,265,266,267,270],{},"List the domains I can host on, then create a site under the shared ",[29,268,269],{},"us.hostsmith.link"," domain.",[14,272,273,274,277,278,281,282,285,286,289],{},"The agent will call ",[29,275,276],{},"list_domains"," to confirm the domain, then ",[29,279,280],{},"create_site"," with ",[29,283,284],{},"domain: \"us.hostsmith.link\"",". The response contains the new ",[29,287,288],{},"siteId"," and the public URL.",[14,291,292,293,296,297,38],{},"Pick a different shared domain (",[29,294,295],{},"eu.hostsmith.link",") or one of your custom domains if you prefer - both appear in ",[29,298,276],{},[40,300,302],{"id":301},"_4-deploy-a-file","4. Deploy a file",[14,304,305],{},"Now ship something:",[262,307,308],{},[14,309,310],{},"Generate a one-page HTML profile of {your topic} and deploy it to that site.",[14,312,313,314,317,318,281,321,324],{},"The agent generates ",[29,315,316],{},"index.html"," and calls ",[29,319,320],{},"deploy_files",[29,322,323],{},"{ siteId, files: [{ fileName: \"index.html\", content: \"...\" }] }",". Within seconds, the URL from step 3 is live.",[40,326,328],{"id":327},"_5-optional-iterate","5. (Optional) Iterate",[14,330,331,332,336],{},"Ask the agent to update the page, add a stylesheet, or attach a custom domain. The same MCP tools handle it - see the ",[34,333,335],{"href":334},"\u002Fdocs\u002Fmcp\u002Frecipes","recipes"," for end-to-end examples.",[18,338,340],{"type":339},"tip",[14,341,342,343,346,347,350,351,353],{},"For files larger than ~1 MB or any binary content (PDF, image, video, zip), the agent will use ",[29,344,345],{},"deploy_create_upload"," + ",[29,348,349],{},"deploy_finalize"," instead of ",[29,352,320],{},". The MCP server picks the right path based on the size you give it - you don't need to ask.",[40,355,357],{"id":356},"whats-next","What's next",[359,360,361,370,378],"ul",{},[55,362,363,369],{},[24,364,365],{},[34,366,368],{"href":367},"\u002Fdocs\u002Fmcp\u002Ftools","Tools reference"," for the full list of what your agent can do.",[55,371,372,377],{},[24,373,374],{},[34,375,376],{"href":334},"Recipes"," for ready-made prompts (custom domain, multi-file, partition switch, private sites).",[55,379,380,386],{},[24,381,382],{},[34,383,385],{"href":384},"\u002Fdocs\u002Fmcp\u002Flimits-and-errors","Limits and errors"," for quotas and how to interpret failures.",[388,389,390],"style",{},"html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":73,"searchDepth":106,"depth":106,"links":392},[393,394,395,396,397,398],{"id":42,"depth":106,"text":43},{"id":241,"depth":106,"text":242},{"id":256,"depth":106,"text":257},{"id":301,"depth":106,"text":302},{"id":327,"depth":106,"text":328},{"id":356,"depth":106,"text":357},"Install the Hostsmith MCP server in your client and ship your first deploy in under a minute.","md","solar:rocket-2-bold",{},null,"\u002Fdocs\u002Fmcp\u002Fquick-start",{"title":5,"description":399},"docs\u002F2.mcp\u002F1.quick-start","Xdx-WbZK2_rikkKikls5W_nJEGfsn2LVQkuVmt4t7o0",[409],{"title":410,"path":411,"stem":412,"children":413,"page":483},"Docs","\u002Fdocs","docs",[414,441,465],{"title":415,"path":416,"stem":417,"children":418,"page":-1,"icon":420},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002Findex",[419,421,425,429,433,437],{"title":415,"path":416,"stem":417,"icon":420},"solar:rocket-bold",{"title":422,"path":423,"stem":424},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":426,"path":427,"stem":428},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F2.quick-start",{"title":430,"path":431,"stem":432},"Sites","\u002Fdocs\u002Fgetting-started\u002Fsites","docs\u002F1.getting-started\u002F3.sites",{"title":434,"path":435,"stem":436},"Custom Domains","\u002Fdocs\u002Fgetting-started\u002Fcustom-domains","docs\u002F1.getting-started\u002F4.custom-domains",{"title":438,"path":439,"stem":440},"Support","\u002Fdocs\u002Fgetting-started\u002Fsupport","docs\u002F1.getting-started\u002F5.support",{"title":442,"path":443,"stem":444,"children":445,"page":-1,"icon":447},"MCP","\u002Fdocs\u002Fmcp","docs\u002F2.mcp\u002Findex",[446,448,449,452,454,457,459,461],{"title":442,"path":443,"stem":444,"icon":447},"solar:plug-circle-bold",{"title":5,"path":404,"stem":406},{"title":450,"path":85,"stem":451},"Clients","docs\u002F2.mcp\u002F2.clients",{"title":252,"path":251,"stem":453},"docs\u002F2.mcp\u002F3.authentication",{"title":455,"path":367,"stem":456},"Tools","docs\u002F2.mcp\u002F4.tools",{"title":376,"path":334,"stem":458},"docs\u002F2.mcp\u002F5.recipes",{"title":385,"path":384,"stem":460},"docs\u002F2.mcp\u002F6.limits-and-errors",{"title":462,"path":463,"stem":464},"FAQ","\u002Fdocs\u002Fmcp\u002Ffaq","docs\u002F2.mcp\u002F7.faq",{"title":466,"path":467,"stem":468,"children":469,"page":-1,"icon":471},"Developers","\u002Fdocs\u002Fdevelopers","docs\u002F3.developers\u002Findex",[470,472,475,479],{"title":466,"path":467,"stem":468,"icon":471},"solar:code-bold",{"title":252,"path":473,"stem":474},"\u002Fdocs\u002Fdevelopers\u002Fauthentication","docs\u002F3.developers\u002F1.authentication",{"title":476,"path":477,"stem":478},"API Explorer","\u002Fdocs\u002Fdevelopers\u002Fapi-explorer","docs\u002F3.developers\u002F2.api-explorer",{"title":480,"path":481,"stem":482},"Node.js SDK","\u002Fdocs\u002Fdevelopers\u002Fsdk","docs\u002F3.developers\u002F3.sdk",false,[485,486],{"title":442,"path":443,"stem":444,"icon":447,"children":-1},{"title":450,"path":85,"stem":451,"children":-1},1778091981932]