TOOLS/LIST IS EMPTY OR ZEPHEX MISSING
- Confirm config file path for your editor (see editor guide).
- Restart the editor after saving config — many only load MCP on startup.
- For stdio: ensure `npx` works in a terminal (`which npx`).
- For HTTP: URL must be https://zephex.dev/mcp with Bearer header.
401 UNAUTHORIZED
- Key must start with your issued prefix (mcp_sk_ or mcp_live_...).
- Header format: Authorization: Bearer YOUR_KEY (HTTP only).
- Stdio: ZEPHEX_API_KEY in env block, not only in shell profile.
- Revoke leaked keys and create a new one in the dashboard.
429 RATE LIMIT EXCEEDED
- 1 request = 1 tool call. Heavy sessions burn quota fast.
- Check tier limits on /docs/plans. Limits reset monthly.
- Upgrade at /pricing or wait for Retry-After from the API.
WORKS LOCALLY BUT NOT FOR TEAMMATE
- Hosted MCP removes machine drift — both should use the same endpoint + key policy.
- Do not commit API keys to git. Use per-user keys.
- See /docs/team-rollout for rollout patterns.