[{"data":1,"prerenderedAt":542},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmcp\u002Fclients":3,"docs-navigation":456,"docs-surround-\u002Fdocs\u002Fmcp\u002Fclients":539},{"id":4,"title":5,"body":6,"description":447,"extension":448,"icon":449,"meta":450,"navigation":451,"path":452,"seo":453,"stem":454,"__hash__":455},"docs\u002Fdocs\u002F2.mcp\u002F2.clients.md","Clients",{"type":7,"value":8,"toc":440},"minimark",[9,13,26,31,59,62,66,69,158,161,238,241,245,248,291,294,298,301,320,362,377,381,436],[10,11,5],"h1",{"id":12},"clients",[14,15,16,17,21,22,25],"p",{},"The Hostsmith MCP server is published as ",[18,19,20],"code",{},"@hostsmith\u002Fmcp-server"," on npm and hosted at ",[18,23,24],{},"https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp",". Every supported client uses one of four transports.",[27,28,30],"h2",{"id":29},"claude-desktop","Claude Desktop",[32,33,34,43,56],"ol",{},[35,36,37,38,42],"li",{},"Open ",[39,40,41],"strong",{},"Settings → Connectors → Add custom connector",".",[35,44,45,46],{},"Paste the URL:",[47,48,53],"pre",{"className":49,"code":51,"language":52},[50],"language-text","https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\n","text",[18,54,51],{"__ignoreMap":55},"",[35,57,58],{},"Save. Claude Desktop runs the OAuth flow in your browser to authorize the connector against your Hostsmith account.",[14,60,61],{},"To revoke, remove the connector from Claude Desktop. To force a re-auth, remove and re-add it.",[27,63,65],{"id":64},"stdio-claude-code-cursor-cline-windsurf-zed","Stdio (Claude Code, Cursor, Cline, Windsurf, Zed)",[14,67,68],{},"Add this entry to your client's MCP config:",[47,70,74],{"className":71,"code":72,"language":73,"meta":55,"style":55},"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",[18,75,76,85,95,103,119,140,146,152],{"__ignoreMap":55},[77,78,81],"span",{"class":79,"line":80},"line",1,[77,82,84],{"class":83},"s95oV","{\n",[77,86,88,92],{"class":79,"line":87},2,[77,89,91],{"class":90},"sDLfK","  \"mcpServers\"",[77,93,94],{"class":83},": {\n",[77,96,98,101],{"class":79,"line":97},3,[77,99,100],{"class":90},"    \"hostsmith\"",[77,102,94],{"class":83},[77,104,106,109,112,116],{"class":79,"line":105},4,[77,107,108],{"class":90},"      \"command\"",[77,110,111],{"class":83},": ",[77,113,115],{"class":114},"sU2Wk","\"npx\"",[77,117,118],{"class":83},",\n",[77,120,122,125,128,131,134,137],{"class":79,"line":121},5,[77,123,124],{"class":90},"      \"args\"",[77,126,127],{"class":83},": [",[77,129,130],{"class":114},"\"-y\"",[77,132,133],{"class":83},", ",[77,135,136],{"class":114},"\"@hostsmith\u002Fmcp-server\"",[77,138,139],{"class":83},"]\n",[77,141,143],{"class":79,"line":142},6,[77,144,145],{"class":83},"    }\n",[77,147,149],{"class":79,"line":148},7,[77,150,151],{"class":83},"  }\n",[77,153,155],{"class":79,"line":154},8,[77,156,157],{"class":83},"}\n",[14,159,160],{},"Config file locations:",[162,163,164,177],"table",{},[165,166,167],"thead",{},[168,169,170,174],"tr",{},[171,172,173],"th",{},"Client",[171,175,176],{},"Config path",[178,179,180,196,206,214,224],"tbody",{},[168,181,182,186],{},[183,184,185],"td",{},"Claude Code",[183,187,188,191,192,195],{},[18,189,190],{},"~\u002F.claude.json"," or ",[18,193,194],{},".mcp.json"," in the project root",[168,197,198,201],{},[183,199,200],{},"Cursor",[183,202,203],{},[18,204,205],{},"~\u002F.cursor\u002Fmcp.json",[168,207,208,211],{},[183,209,210],{},"Cline",[183,212,213],{},"VS Code settings - \"Cline: MCP Servers\"",[168,215,216,219],{},[183,217,218],{},"Windsurf",[183,220,221],{},[18,222,223],{},"~\u002F.codeium\u002Fwindsurf\u002Fmcp_config.json",[168,225,226,229],{},[183,227,228],{},"Zed",[183,230,231,234,235],{},[18,232,233],{},"assistant"," settings in ",[18,236,237],{},"~\u002F.config\u002Fzed\u002Fsettings.json",[14,239,240],{},"The first tool call triggers an OAuth flow in your browser to authorize the server against your Hostsmith account. The token is cached locally; subsequent calls reuse it.",[27,242,244],{"id":243},"remote-url-other-streamable-http-clients","Remote URL (other Streamable-HTTP clients)",[14,246,247],{},"Any MCP client that supports remote Streamable HTTP transport can point directly at the hosted server:",[47,249,251],{"className":71,"code":250,"language":73,"meta":55,"style":55},"{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"url\": \"https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\"\n    }\n  }\n}\n",[18,252,253,257,263,269,279,283,287],{"__ignoreMap":55},[77,254,255],{"class":79,"line":80},[77,256,84],{"class":83},[77,258,259,261],{"class":79,"line":87},[77,260,91],{"class":90},[77,262,94],{"class":83},[77,264,265,267],{"class":79,"line":97},[77,266,100],{"class":90},[77,268,94],{"class":83},[77,270,271,274,276],{"class":79,"line":105},[77,272,273],{"class":90},"      \"url\"",[77,275,111],{"class":83},[77,277,278],{"class":114},"\"https:\u002F\u002Fmcp.hostsmith.net\u002Fmcp\"\n",[77,280,281],{"class":79,"line":121},[77,282,145],{"class":83},[77,284,285],{"class":79,"line":142},[77,286,151],{"class":83},[77,288,289],{"class":79,"line":148},[77,290,157],{"class":83},[14,292,293],{},"The client handles the OAuth flow automatically - you'll be redirected to Hostsmith to authorize access.",[27,295,297],{"id":296},"local-http-self-hosted","Local HTTP (self-hosted)",[14,299,300],{},"Run the server in HTTP mode locally and have your MCP client perform OAuth against it:",[47,302,306],{"className":303,"code":304,"language":305,"meta":55,"style":55},"language-bash shiki shiki-themes github-dark","npx @hostsmith\u002Fmcp-server http\n","bash",[18,307,308],{"__ignoreMap":55},[77,309,310,314,317],{"class":79,"line":80},[77,311,313],{"class":312},"svObZ","npx",[77,315,316],{"class":114}," @hostsmith\u002Fmcp-server",[77,318,319],{"class":114}," http\n",[47,321,323],{"className":71,"code":322,"language":73,"meta":55,"style":55},"{\n  \"mcpServers\": {\n    \"hostsmith\": {\n      \"url\": \"http:\u002F\u002Flocalhost:3100\u002Fmcp\"\n    }\n  }\n}\n",[18,324,325,329,335,341,350,354,358],{"__ignoreMap":55},[77,326,327],{"class":79,"line":80},[77,328,84],{"class":83},[77,330,331,333],{"class":79,"line":87},[77,332,91],{"class":90},[77,334,94],{"class":83},[77,336,337,339],{"class":79,"line":97},[77,338,100],{"class":90},[77,340,94],{"class":83},[77,342,343,345,347],{"class":79,"line":105},[77,344,273],{"class":90},[77,346,111],{"class":83},[77,348,349],{"class":114},"\"http:\u002F\u002Flocalhost:3100\u002Fmcp\"\n",[77,351,352],{"class":79,"line":121},[77,353,145],{"class":83},[77,355,356],{"class":79,"line":142},[77,357,151],{"class":83},[77,359,360],{"class":79,"line":148},[77,361,157],{"class":83},[14,363,364,365,368,369,376],{},"Useful when you want to inspect MCP traffic locally or pin to a specific server version. Set ",[18,366,367],{},"MCP_BASE_URL"," to override the public URL the server advertises in OAuth metadata. See the ",[370,371,375],"a",{"href":372,"rel":373},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fmcp-server#environment-variables",[374],"nofollow","README"," for the full env var list.",[27,378,380],{"id":379},"troubleshooting","Troubleshooting",[382,383,384,390,399,413,423],"ul",{},[35,385,386,389],{},[39,387,388],{},"Tool calls return 401."," The OAuth session expired. Reconnect from your client to re-authorize.",[35,391,392,395,396,398],{},[39,393,394],{},"OAuth redirect loops"," (self-hosted only). Confirm ",[18,397,367],{}," matches the URL your MCP client uses to reach the server.",[35,400,401,404,405,408,409,42],{},[39,402,403],{},"Wrong partition."," Tool calls accept an explicit ",[18,406,407],{},"partition"," argument; if you omit it, the partition is inferred from your access token. See ",[370,410,412],{"href":411},"\u002Fdocs\u002Fmcp\u002Fauthentication#data-partition-selection","Authentication",[35,414,415,418,419,422],{},[39,416,417],{},"Inspect tools interactively."," Run ",[18,420,421],{},"npx @modelcontextprotocol\u002Finspector npx -y @hostsmith\u002Fmcp-server http"," to browse the tool surface in a local UI.",[35,424,425,428,429,191,432,435],{},[39,426,427],{},"Stale npm cache."," If you keep getting an old version, run ",[18,430,431],{},"npx clear-npx-cache",[18,433,434],{},"npm cache clean --force"," and try again.",[437,438,439],"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);}html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}",{"title":55,"searchDepth":87,"depth":87,"links":441},[442,443,444,445,446],{"id":29,"depth":87,"text":30},{"id":64,"depth":87,"text":65},{"id":243,"depth":87,"text":244},{"id":296,"depth":87,"text":297},{"id":379,"depth":87,"text":380},"One-time setup for every supported MCP client - Claude Desktop, stdio clients, remote URL, and self-hosted.","md","solar:devices-bold",{},null,"\u002Fdocs\u002Fmcp\u002Fclients",{"title":5,"description":447},"docs\u002F2.mcp\u002F2.clients","5XTb5x7w9FllogW4uPRHo8vBN7cug06eWsKfgESAeSo",[457],{"title":458,"path":459,"stem":460,"children":461,"page":538},"Docs","\u002Fdocs","docs",[462,489,520],{"title":463,"path":464,"stem":465,"children":466,"page":-1,"icon":468},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002Findex",[467,469,473,477,481,485],{"title":463,"path":464,"stem":465,"icon":468},"solar:rocket-bold",{"title":470,"path":471,"stem":472},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":474,"path":475,"stem":476},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F2.quick-start",{"title":478,"path":479,"stem":480},"Sites","\u002Fdocs\u002Fgetting-started\u002Fsites","docs\u002F1.getting-started\u002F3.sites",{"title":482,"path":483,"stem":484},"Custom Domains","\u002Fdocs\u002Fgetting-started\u002Fcustom-domains","docs\u002F1.getting-started\u002F4.custom-domains",{"title":486,"path":487,"stem":488},"Support","\u002Fdocs\u002Fgetting-started\u002Fsupport","docs\u002F1.getting-started\u002F5.support",{"title":490,"path":491,"stem":492,"children":493,"page":-1,"icon":495},"MCP","\u002Fdocs\u002Fmcp","docs\u002F2.mcp\u002Findex",[494,496,500,501,504,508,512,516],{"title":490,"path":491,"stem":492,"icon":495},"solar:plug-circle-bold",{"title":497,"path":498,"stem":499},"Quick start","\u002Fdocs\u002Fmcp\u002Fquick-start","docs\u002F2.mcp\u002F1.quick-start",{"title":5,"path":452,"stem":454},{"title":412,"path":502,"stem":503},"\u002Fdocs\u002Fmcp\u002Fauthentication","docs\u002F2.mcp\u002F3.authentication",{"title":505,"path":506,"stem":507},"Tools","\u002Fdocs\u002Fmcp\u002Ftools","docs\u002F2.mcp\u002F4.tools",{"title":509,"path":510,"stem":511},"Recipes","\u002Fdocs\u002Fmcp\u002Frecipes","docs\u002F2.mcp\u002F5.recipes",{"title":513,"path":514,"stem":515},"Limits and errors","\u002Fdocs\u002Fmcp\u002Flimits-and-errors","docs\u002F2.mcp\u002F6.limits-and-errors",{"title":517,"path":518,"stem":519},"FAQ","\u002Fdocs\u002Fmcp\u002Ffaq","docs\u002F2.mcp\u002F7.faq",{"title":521,"path":522,"stem":523,"children":524,"page":-1,"icon":526},"Developers","\u002Fdocs\u002Fdevelopers","docs\u002F3.developers\u002Findex",[525,527,530,534],{"title":521,"path":522,"stem":523,"icon":526},"solar:code-bold",{"title":412,"path":528,"stem":529},"\u002Fdocs\u002Fdevelopers\u002Fauthentication","docs\u002F3.developers\u002F1.authentication",{"title":531,"path":532,"stem":533},"API Explorer","\u002Fdocs\u002Fdevelopers\u002Fapi-explorer","docs\u002F3.developers\u002F2.api-explorer",{"title":535,"path":536,"stem":537},"Node.js SDK","\u002Fdocs\u002Fdevelopers\u002Fsdk","docs\u002F3.developers\u002F3.sdk",false,[540,541],{"title":497,"path":498,"stem":499,"children":-1},{"title":412,"path":502,"stem":503,"children":-1},1778091981955]