[{"data":1,"prerenderedAt":420},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmcp\u002Ffaq":3,"docs-navigation":336,"docs-surround-\u002Fdocs\u002Fmcp\u002Ffaq":417},{"id":4,"title":5,"body":6,"description":327,"extension":328,"icon":329,"meta":330,"navigation":331,"path":332,"seo":333,"stem":334,"__hash__":335},"docs\u002Fdocs\u002F2.mcp\u002F7.faq.md","FAQ",{"type":7,"value":8,"toc":310},"minimark",[9,13,18,28,32,35,43,47,50,65,68,72,115,119,122,136,152,160,178,192,196,202,206,235,239,250,254,266,270,273,277],[10,11,5],"h1",{"id":12},"faq",[14,15,17],"h2",{"id":16},"why-oauth-only-can-i-just-use-an-api-key","Why OAuth-only - can I just use an API key?",[19,20,21,22,27],"p",{},"The MCP server is designed for human-in-the-loop agent workflows, where the user explicitly approves what the agent can do. OAuth gives per-user consent, short-lived tokens, and revocability without rotating shared secrets. If you need non-interactive automation, use the ",[23,24,26],"a",{"href":25},"\u002Fdocs\u002Fdevelopers\u002Fauthentication","REST API"," directly with OAuth-issued tokens.",[14,29,31],{"id":30},"how-do-i-rotate-tokens","How do I rotate tokens?",[19,33,34],{},"You don't need to. Access tokens last 1 hour and your MCP client refreshes them silently. Refresh tokens rotate on every refresh - the old one is invalidated automatically.",[19,36,37,38,42],{},"To force a fresh token, ",[23,39,41],{"href":40},"\u002Fdocs\u002Fmcp\u002Fauthentication#revoking-access","revoke access"," and reconnect.",[14,44,46],{"id":45},"where-are-my-mcp-credentials-stored","Where are my MCP credentials stored?",[19,48,49],{},"In your client's local credential store, not in your MCP config file. Exact paths vary by client; common locations:",[51,52,53,57],"ul",{},[54,55,56],"li",{},"Claude Desktop: macOS Keychain \u002F Windows Credential Manager \u002F Linux Secret Service.",[54,58,59,60,64],{},"stdio clients (Claude Code, Cursor, etc.): ",[61,62,63],"code",{},"~\u002F.config\u002F\u003Cclient>\u002F\u003Cserver>\u002Foauth.json"," or similar.",[19,66,67],{},"The MCP server itself is stateless - it does not store credentials.",[14,69,71],{"id":70},"where-do-i-find-logs-to-troubleshoot","Where do I find logs to troubleshoot?",[51,73,74,81,91,105],{},[54,75,76,80],{},[77,78,79],"strong",{},"Claude Desktop:"," the connector view shows recent MCP traffic; system logs are in the macOS Console app or the equivalent on Windows \u002F Linux.",[54,82,83,86,87,90],{},[77,84,85],{},"stdio clients:"," most clients write MCP server stderr to a log file (e.g. Claude Code: ",[61,88,89],{},"~\u002F.claude\u002Flogs\u002F","). Check your client's docs.",[54,92,93,100,101,104],{},[77,94,95,96,99],{},"Self-hosted (",[61,97,98],{},"npx @hostsmith\u002Fmcp-server http","):"," logs go to the terminal where you started the process. Set ",[61,102,103],{},"DEBUG=*"," for verbose output.",[54,106,107,110,111,114],{},[77,108,109],{},"Inspect interactively:"," ",[61,112,113],{},"npx @modelcontextprotocol\u002Finspector npx -y @hostsmith\u002Fmcp-server http"," opens a UI for tool calls.",[14,116,118],{"id":117},"eu-vs-us-which-partition-should-i-use","EU vs US - which partition should I use?",[19,120,121],{},"Both partitions offer the same product. Pick based on where you need the user's data to live:",[51,123,124,130],{},[54,125,126,129],{},[77,127,128],{},"EU partition"," for GDPR-sensitive workloads or any user request that says \"EU residency\".",[54,131,132,135],{},[77,133,134],{},"US partition"," for everything else, including users with no specific residency requirement.",[19,137,138,139,142,143,146,147,151],{},"Your home partition is set when you sign up. Per-call, pass ",[61,140,141],{},"partition: \"us\""," or ",[61,144,145],{},"partition: \"eu\""," to override. See ",[23,148,150],{"href":149},"\u002Fdocs\u002Fmcp\u002Fauthentication#data-partition-selection","Data partition selection",".",[14,153,155,156,159],{"id":154},"my-custom-domain-isnt-active-what-now","My custom domain isn't ",[61,157,158],{},"active"," - what now?",[19,161,162,163,166,167,142,170,173,174,177],{},"Custom domains require DNS validation: you add records at your registrar, and Hostsmith provisions an ACM certificate and CDN routing. Until that completes, ",[61,164,165],{},"list_domains"," shows the domain as ",[61,168,169],{},"validating",[61,171,172],{},"provisioning"," and ",[61,175,176],{},"create_site"," will refuse it.",[19,179,180,181,184,185,187,188,191],{},"Status flow: ",[61,182,183],{},"VALIDATING → PROVISIONING → ACTIVE | FAILED",". Track progress in the Hostsmith app. Only call ",[61,186,176],{}," against domains in ",[61,189,190],{},"ACTIVE"," status.",[14,193,195],{"id":194},"can-i-use-the-mcp-server-in-ci","Can I use the MCP server in CI?",[19,197,198,199,201],{},"Technically yes, but only after a one-time interactive OAuth in the same environment. CI is a poor fit for OAuth-with-browser-redirect; use the ",[23,200,26],{"href":25}," directly with a stored OAuth token instead.",[14,203,205],{"id":204},"how-do-i-disconnect-reconnect","How do I disconnect \u002F reconnect?",[51,207,208,213,222],{},[54,209,210,212],{},[77,211,79],{}," Settings → Connectors → remove and re-add the connector.",[54,214,215,217,218,221],{},[77,216,85],{}," delete the cached OAuth credentials and remove the ",[61,219,220],{},"hostsmith"," entry from your MCP config; the next first call re-authorizes.",[54,223,224,227,228,234],{},[77,225,226],{},"Globally:"," sign in to ",[23,229,233],{"href":230,"rel":231},"https:\u002F\u002Fhostsmith.net",[232],"nofollow","hostsmith.net",", revoke the OAuth client from account settings - this kills tokens for that client across every machine.",[14,236,238],{"id":237},"does-the-mcp-server-have-access-to-my-filesystem","Does the MCP server have access to my filesystem?",[19,240,241,242,245,246,249],{},"No. The MCP server is a process that talks to your client over stdio (or HTTP) and to the Hostsmith API over HTTPS. Your agent reads local files and passes their contents to ",[61,243,244],{},"deploy_files"," (inline) or to ",[61,247,248],{},"deploy_create_upload"," + direct S3 PUT (out of band). The MCP server never touches your disk.",[14,251,253],{"id":252},"do-mcp-deploys-overwrite-existing-content","Do MCP deploys overwrite existing content?",[19,255,256,257,142,259,261,262,265],{},"Yes. A successful ",[61,258,244],{},[61,260,248],{}," + ",[61,263,264],{},"deploy_finalize"," replaces the previous version of the site. Confirm overwrite with the user before deploying anything you don't want to lose.",[14,267,269],{"id":268},"what-about-access-controls-passwords-allowlists","What about access controls (passwords, allowlists)?",[19,271,272],{},"Configure them once in the Hostsmith app. They persist across deploys. The MCP server does not currently expose access-control tools.",[14,274,276],{"id":275},"where-do-i-report-issues","Where do I report issues?",[51,278,279,289,298],{},[54,280,281,110,284,151],{},[77,282,283],{},"Bugs in the MCP server itself:",[23,285,288],{"href":286,"rel":287},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fmcp-server\u002Fissues",[232],"github.com\u002Fhostsmith\u002Fmcp-server\u002Fissues",[54,290,291,110,294,151],{},[77,292,293],{},"Account \u002F billing \u002F API issues:",[23,295,297],{"href":296},"\u002Fdocs\u002Fgetting-started\u002Fsupport","Support",[54,299,300,303,304,309],{},[77,301,302],{},"Security:"," see ",[23,305,308],{"href":306,"rel":307},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fmcp-server\u002Fblob\u002Fmain\u002FSECURITY.md",[232],"SECURITY.md"," in the MCP server repo.",{"title":311,"searchDepth":312,"depth":312,"links":313},"",2,[314,315,316,317,318,319,321,322,323,324,325,326],{"id":16,"depth":312,"text":17},{"id":30,"depth":312,"text":31},{"id":45,"depth":312,"text":46},{"id":70,"depth":312,"text":71},{"id":117,"depth":312,"text":118},{"id":154,"depth":312,"text":320},"My custom domain isn't active - what now?",{"id":194,"depth":312,"text":195},{"id":204,"depth":312,"text":205},{"id":237,"depth":312,"text":238},{"id":252,"depth":312,"text":253},{"id":268,"depth":312,"text":269},{"id":275,"depth":312,"text":276},"Common questions about the Hostsmith MCP server.","md","solar:question-circle-bold",{},null,"\u002Fdocs\u002Fmcp\u002Ffaq",{"title":5,"description":327},"docs\u002F2.mcp\u002F7.faq","UIecRG_wEphT3x_svtP02psW9xnkVCWGvXKlIF5lJTA",[337],{"title":338,"path":339,"stem":340,"children":341,"page":416},"Docs","\u002Fdocs","docs",[342,367,399],{"title":343,"path":344,"stem":345,"children":346,"page":-1,"icon":348},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002Findex",[347,349,353,357,361,365],{"title":343,"path":344,"stem":345,"icon":348},"solar:rocket-bold",{"title":350,"path":351,"stem":352},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":354,"path":355,"stem":356},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F2.quick-start",{"title":358,"path":359,"stem":360},"Sites","\u002Fdocs\u002Fgetting-started\u002Fsites","docs\u002F1.getting-started\u002F3.sites",{"title":362,"path":363,"stem":364},"Custom Domains","\u002Fdocs\u002Fgetting-started\u002Fcustom-domains","docs\u002F1.getting-started\u002F4.custom-domains",{"title":297,"path":296,"stem":366},"docs\u002F1.getting-started\u002F5.support",{"title":368,"path":369,"stem":370,"children":371,"page":-1,"icon":373},"MCP","\u002Fdocs\u002Fmcp","docs\u002F2.mcp\u002Findex",[372,374,378,382,386,390,394,398],{"title":368,"path":369,"stem":370,"icon":373},"solar:plug-circle-bold",{"title":375,"path":376,"stem":377},"Quick start","\u002Fdocs\u002Fmcp\u002Fquick-start","docs\u002F2.mcp\u002F1.quick-start",{"title":379,"path":380,"stem":381},"Clients","\u002Fdocs\u002Fmcp\u002Fclients","docs\u002F2.mcp\u002F2.clients",{"title":383,"path":384,"stem":385},"Authentication","\u002Fdocs\u002Fmcp\u002Fauthentication","docs\u002F2.mcp\u002F3.authentication",{"title":387,"path":388,"stem":389},"Tools","\u002Fdocs\u002Fmcp\u002Ftools","docs\u002F2.mcp\u002F4.tools",{"title":391,"path":392,"stem":393},"Recipes","\u002Fdocs\u002Fmcp\u002Frecipes","docs\u002F2.mcp\u002F5.recipes",{"title":395,"path":396,"stem":397},"Limits and errors","\u002Fdocs\u002Fmcp\u002Flimits-and-errors","docs\u002F2.mcp\u002F6.limits-and-errors",{"title":5,"path":332,"stem":334},{"title":400,"path":401,"stem":402,"children":403,"page":-1,"icon":405},"Developers","\u002Fdocs\u002Fdevelopers","docs\u002F3.developers\u002Findex",[404,406,408,412],{"title":400,"path":401,"stem":402,"icon":405},"solar:code-bold",{"title":383,"path":25,"stem":407},"docs\u002F3.developers\u002F1.authentication",{"title":409,"path":410,"stem":411},"API Explorer","\u002Fdocs\u002Fdevelopers\u002Fapi-explorer","docs\u002F3.developers\u002F2.api-explorer",{"title":413,"path":414,"stem":415},"Node.js SDK","\u002Fdocs\u002Fdevelopers\u002Fsdk","docs\u002F3.developers\u002F3.sdk",false,[418,419],{"title":395,"path":396,"stem":397,"children":-1},{"title":400,"path":401,"stem":402,"icon":405,"children":-1},1778091982298]