Do I need to install anything locally to use Zephex?
For editor Mode 1, setup writes MCP config — often via `npx -y zephex@latest setup --cursor` (stdio bridge uses npx). For terminal Mode 2, install once with `npm install -g zephex` then `mcpcli init`. Web terminal needs only a browser login at /dashboard/terminal (public GitHub repos).
Which editors do you support?
Cursor, Claude Code, VS Code, Windsurf, JetBrains, and 20+ MCP-compatible clients. See /docs/supported-editors and /docs/connect-mcp for flags like --cursor, --vscode, --claude-code.
How long does setup take?
Most users connect in under 5 minutes — browser OAuth via mcpcli setup, config write, restart editor once. Terminal-only: mcpcli init then overview in a project folder.
What is Mode 1 vs Mode 2?
Mode 1 is editor MCP (agent gets lean JSON). Mode 2 is the terminal CLI (you get plain-English answer cards). Same API key and https://zephex.dev/mcp. Multi-turn keep_thinking sessions are editor-only; terminal think is one-shot. See /docs/how-it-works.
Why did `structure` open architecture instead of my folder tree?
CLI dispatch policy: bare `structure` maps to architecture. For layout topics use `get-context --topic structure`. Same idea for bare `env` (env-check) vs `get-context --topic env`. See /docs/cli-commands and docs/cli-dispatch-policy.md in the repo.
Can I use the VS Code Marketplace extension instead of manual MCP JSON?
Yes. Install Zephex from the VS Code Marketplace (works in VS Code, Cursor, and Windsurf), run Zephex: Sign In from the Command Palette, then enable Zephex MCP in agent mode. The extension handles OAuth and key storage — or run npx -y zephex@latest setup --vscode for stdio config. See /docs/editors/vscode-extension.
What is the Zephex web terminal?
The web terminal at /dashboard/terminal runs Mode 2 mcpcli tools in your browser — paste a public GitHub repo URL and run overview, get-context, find-code, supply scans, and more without npm install. It uses a web-terminal-* API key and shares your plan quota. Private repos are not cloned server-side. See /docs/web-terminal.
How do I roll Zephex out to my team?
Use one hosted endpoint (https://zephex.dev/mcp) with separate API keys per developer and per environment (dev/staging/prod). Do not commit keys to git. Standardize on npx -y zephex@latest setup globally, document editor restart requirements, and use dashboard usage analytics for quota visibility. Full checklist: /docs/team-rollout.
Can I use Zephex with my private GitHub repository?
Yes for local Mode 2 and stdio editor setups: tools use files on disk via inline_files / local path — the repo does not need to be public. The dashboard web terminal only clones public GitHub URLs. Hosted remote github:owner/repo paths need server-side GitHub access for private repos.
How is a hosted/remote MCP server different from running local stdio MCP servers?
Local stdio servers run on your machine and are fast/private but create N×M config drift across editors, machines, and teammates. A hosted MCP gateway (remote HTTP) like Zephex gives every editor and every teammate the same 10 tools through one key and one endpoint. You get central usage analytics, key rotation, and production-grade tools (package CVE scanning, header audits, stateful keep_thinking) without shipping heavy scanners to every laptop. The tradeoff is one network hop and the rate limits of your plan.
What is the difference between Zephex and running MCP servers locally?
Running MCP servers locally means managing Node processes, updating packages, and configuring each client separately. Zephex hosts the proxy for you — same endpoint, same access controls, no local infrastructure.