zephex
⌘K
Get StartedPricingMCP ToolsDocs
←Back×Sign in
Get StartedPricingMCP ToolsDocs

Documentation

Start with the endpoint and API key flow, then branch into editor setup or tool reference.

GET STARTED

What is MCP?IntroductionQuickstartAPI ReferenceUniversal RequirementsZephex vs Local MCPBest PracticesToken EfficiencyCLAUDE.md TemplateAGENTS.md TemplateMCP EcosystemMarkdown Access

EDITORS

OpenCodeOAuthVS CodeClaude CodeCursorWindsurfJetBrainsKiro CLIOAuthZedOAuthGemini CLIOAuthClineOAuthGooseCodex CLIOAuthFactory AIOAuth

OPERATING SYSTEMS

macOSWindowsLinux

TOOLS

get_project_contextread_codefind_codecheck_packageaudit_packageexplain_architectureZephex_dev_infoscope_taskaudit_headersthinking

SUPPORT

PlansPro & Max GuideUsage & AnalyticsConnection IssuesRate LimitsBillingSecurityFAQChangelog

Cursor

Cursor should use the native stdio MCP configuration in `.cursor/mcp.json`.

OVERVIEW

Cursor uses `.cursor/mcp.json` or `~/.cursor/mcp.json` for MCP servers. For Zephex, the reliable setup is the stdio block below running `npx -y zephex` with `ZEPHEX_API_KEY` in the env block.

CONFIG FILE LOCATION

Create this file: .cursor/mcp.json in your project root directory. If the .cursor folder does not exist, create it.

PREREQUISITES
  1. Cursor installed. Version 0.43 or later is the safest baseline for HTTP MCP support.
  2. An active Zephex account and API key.
  3. Write access to the project root so you can create the .cursor folder if it does not exist.
CONFIG

Paste the JSON exactly as shown. Keep the server name as zephex so the connection is easy to verify in screenshots, support requests, and tool lists.

Replace `mcp_sk_your_key_here` with the real key from Dashboard -> API Keys.

.cursor/mcp.json
{  "mcpServers": {    "zephex": {      "command": "npx",      "args": ["-y", "zephex"],      "env": { "ZEPHEX_API_KEY": "mcp_sk_your_key_here" }    }  }}
RESTART
  1. Save the config file.
  2. Fully quit Cursor with Cmd+Q on macOS or Ctrl+Q on Windows/Linux.
  3. Reopen Cursor. Do not rely on window reload alone.
  4. Open a new chat session instead of reusing an old one.
VERIFY

After restart, verify the connection from Cursor itself before you start asking the agent to edit code.

  1. Open Settings → Tools & MCPs.
  2. You should see "zephex" listed with status "Connected".
  3. You should also see 10 tools available under that server entry.
COMMON ISSUES

"zephex" shows 0 tools

You probably reloaded the window instead of fully quitting Cursor. Quit the app completely, reopen it, and start a new chat session.

Connection failed

Check that the config uses `command`, `args`, and `env` exactly as shown above instead of the older hosted HTTP fields.

JSON syntax error

Verify the file is exactly .cursor/mcp.json at the project root. Remove trailing commas and comments, then validate that the JSON parses cleanly.

"zephex" does not appear in the Tools list at all

The config file is usually in the wrong place. Make sure .cursor/mcp.json is inside the root of the project currently open in Cursor, not in a parent folder or sibling repo.

If the editor still does not connect, return to Quickstart or check Connection Issues.