Platform
Use this page when your editor runs directly on Windows and you need the right file paths, PowerShell verification steps, and Windows-specific gotchas before opening the editor guide.
HOSTED ENDPOINT
Zephex always uses https://zephex.dev/mcp with the same Bearer header. The operating system only changes file paths, restart flow, and shell commands.
WHAT CHANGES
Windows swaps Unix home shortcuts for %USERPROFILE% and backslash paths. If the editor is actually running in WSL, follow the Linux guide for the WSL environment instead of the Windows host.
PLATFORM SUMMARY
On Windows, the endpoint and Bearer auth are identical to every other platform. What usually breaks the setup is saving JSON into the wrong directory, mixing Windows host paths with WSL paths, or accidentally creating files like mcp.json.txt from Explorer.
This one-liner is the Mode 2 terminal installer — the same zephex shell you type / in. It is not the editor MCP wizard on the homepage (npx -p zephex mcpcli setup). Same account and API key later; different first command.
irm https://zephex.dev/install.ps1 | iex~/.zephex (or %USERPROFILE%\.zephex on Windows) — not into your project.~/.zephex/node.zephex npm tarball only (~3 MB today, ~13 MB unpacked) into ~/.zephex/npm-global and links zephex + mcpcli. It does not run npm install -g — that would also pull unused server libraries (~260 MB).zephex init --terminal so you can sign in in the browser. It does not write Cursor / Claude / VS Code MCP config. Editor wiring is zephex connect --cursor (or npx -y zephex@latest setup --cursor).Windows — do not pipe the bash installer in cmd.exe. Use PowerShell:
irm https://zephex.dev/install.ps1 | iexWSL or Git Bash: use the macOS/Linux curl line inside that Linux environment. Mixing C:\Users\…\.zephex with /home/you/.zephex is the usual break.
~/.zephex/node instead of failing. Do not use npx zephex setup there unless node -v is already 22.5+.zephex binary. Use the web terminal in Safari, or SSH into a Mac/Linux box that already has the CLI.win-arm64 Node build. WSL on ARM uses the Linux arm64 curl line.install.sh / install.ps1. The CLI itself comes from the npm registry, not from Railway.zephex.dev/cli/auth (Vercel). Your user_id and key name are written to Supabase. The API key is stored only in ~/.zephex/credentials.json (mode 0600)./overview, /architecture, …) go to the hosted MCP proxy on Railway (https://zephex.dev/mcp is the public URL). Credits and tool names are stored per user_id in usage_events.zephex process does not send your repo to Sentry.source ~/.zephex/env.shcd your-appzephex# type /overview or /helpHosted tools need a live API key (dashboard keys or the browser sign-in the installer opens). /help and /learn work without a key. /frontend /auth /database /overview do not.
The curl script always installs npm zephex@latest (unless you pin ZEPHEX_VERSION). Re-run it, or:
zephex update # or re-run the installer (installs npm zephex@latest into ~/.zephex)curl -fsSL https://zephex.dev/cli/install.sh | bash # pin a versionZEPHEX_VERSION=2.5.13 curl -fsSL https://zephex.dev/cli/install.sh | bashCheck what you have: zephex info or zephex --version. If which zephex points at an old global npm (not ~/.zephex/bin/zephex), source ~/.zephex/env.sh or reopen the terminal.
curl -fsSL https://zephex.dev/cli/install.sh | bash — install the terminal (Mode 2). No Node required on the machine first.npx -p zephex mcpcli setup — editor MCP wizard (Mode 1). Needs Node already. Writes Cursor / Claude config.zephex connect --cursor when you want the editor.zephex uninstall # PATH + credentialszephex uninstall --full # delete entire ~/.zephexcommand not found: zephex — source ~/.zephex/env.sh, then open a new tab.source line.zephex.dev— never a random gist.More paths: all install methods · macOS · Linux · Windows · terminal CLI
REQUIRED
RULE OF THUMB
If the editor runs on this operating system, keep the config on this operating system too. If the editor actually runs in WSL, SSH, or a container, follow the guide for that runtime instead of the host desktop.
Use Windows paths for editors running on Windows. Do not mix these with WSL or remote Linux paths unless the editor process is also running there.
| Editor | Location | Scope | Notes |
|---|---|---|---|
| Cursor | .cursor\mcp.json | Project | Keep the file in the repo root that Cursor opened on Windows. |
| VS Code | .vscode\mcp.json | Project | The workspace root matters more than the drive letter. |
| Claude Code | %USERPROFILE%\.claude.json | User | This is the Windows user profile, not a WSL home directory. |
| Windsurf | %USERPROFILE%\.codeium\windsurf\mcp_config.json | User | Create the nested directories before saving the config file. |
| JetBrains | Settings → AI Assistant → MCP Servers | App UI | JetBrains keeps MCP setup in the IDE settings UI. |
Run this in PowerShell on the same Windows machine as the editor. It verifies the hosted endpoint before you spend time on UI debugging.
DEBUG RULE
If this request succeeds but the editor still shows 0 tools, your API key and network are fine. The remaining problem is the editor config location, JSON shape, or restart flow.
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codeium\windsurf" | Out-Null $body = @{ jsonrpc = "2.0" id = 1 method = "tools/list" params = @{}} | ConvertTo-Json -Compress Invoke-RestMethod -Method Post "https://zephex.dev/mcp" ` -Headers @{ Authorization = "Bearer YOUR_API_KEY" "Content-Type" = "application/json" } ` -Body $bodyAfter the PowerShell request succeeds, verify the editor with a true reload or full restart.
These pages cover the exact JSON shape, restart flow, and UI verification steps for each editor after you have picked the right file location for this operating system.
| Editor | Use This When | Guide |
|---|---|---|
| Cursor | Best when you want the cleanest repo-local JSON file for Windows projects. | Open guide → |
| VS Code | Use this if you want VS Code to prompt for the API key instead of hardcoding it. | Open guide → |
| Claude Code | Use this when the server should be available across repos from one user config file. | Open guide → |
| Windsurf | Use this for the exact global JSON shape under the Codeium directory. | Open guide → |
| JetBrains | Use this for AI Assistant MCP settings in IntelliJ-based IDEs. | Open guide → |
Explorer may hide known extensions. Turn on file extensions or confirm the final filename exactly matches mcp.json or mcp_config.json with no extra .txt suffix.
If the editor is launched from WSL or a remote Linux environment, Windows profile paths will not be used. Follow the Linux guide for the environment that actually runs the editor process.
Keep JSON keys and strings in standard double quotes and do not add comments. For PowerShell verification, keep the backticks at the line ends exactly as shown.
If PowerShell cannot reach https://zephex.dev/mcp, resolve the network policy first. The editor cannot work until Windows itself can complete the HTTPS request.
Use irm https://zephex.dev/install.ps1 | iex. The installer now picks win-arm64. WSL on ARM should use the Linux curl line inside WSL, not PowerShell.
If the platform setup still does not connect, return to Quickstart or check Connection Issues.