Factory AI's Droid agent reads `.factory/mcp.json` from your project root automatically. Use the stdio config below instead of the older HTTP URL-only entry.
OVERVIEW
Factory AI's Droid is an autonomous AI software engineer that operates on your codebase. For Zephex, the reliable setup is the stdio MCP config in `.factory/mcp.json` or `~/.factory/mcp.json`, running `npx -y zephex` with your key in the env block.
CONFIG FILE LOCATION
.factory/mcp.json in the project root, or ~/.factory/mcp.json for a user-level config.
Create a `.factory/` directory in your project root and add `mcp.json` with the content shown.
Replace `mcp_sk_your_key_here` with your real Zephex API key before saving.
{ "mcpServers": { "zephex": { "type": "stdio", "command": "npx", "args": ["-y", "zephex"], "env": { "ZEPHEX_API_KEY": "mcp_sk_your_key_here" } } }}Confirm the server is connected inside a Droid session before relying on Zephex tools.
Make sure `.factory/mcp.json` is in the project root (not a subdirectory) and that Droid was started from that same root directory. The file path is case-sensitive on Linux.
Install Node.js so Droid can launch `npx`, or switch to absolute executable paths if your environment does not inherit PATH correctly.
Check that the config uses `type: stdio`, `command: npx`, and `args: ["-y", "zephex"]` exactly as shown.
If the editor still does not connect, return to Quickstart or check Connection Issues.