Get started
Connect with your AI agent
Let Claude Code, Cursor or another coding agent add Zexl to your project. You approve one link; the agent does the rest. The key never passes through the chat.
1. Add the Zexl MCP server to your agent
Claude Code:
bash
claude mcp add zexl -- uvx zexl-mcp
Claude Desktop, Cursor and other tools with a JSON config:
json
{
"mcpServers": {
"zexl": { "command": "uvx", "args": ["zexl-mcp"] }
}
}uvx comes with uv.
2. Ask
Add Zexl to this project.
3. What happens
- The agent calls
zexl_connect_start. It shows you a link and a code, likeKX4P-9QRM. - You open the link. Sign up or sign in (email or Google).
- The page shows the same code. Check that it matches. If it does not, or you did not ask for this, press Deny.
- Choose a workspace (or make a new one) and an environment. Development is the usual choice for a laptop. Press Approve.
- The agent calls
zexl_connect_finish. On your machine, it:- writes
ZEXL_API_KEYinto the project's.envfile. The agent only sees a masked form likezx_ab12…; - makes the salt locally. If the project already had a Zexl key, it keeps that salt so earlier calls still match;
- adds
.envto.gitignorewhen git would otherwise commit it; - saves a read key for the MCP tools in
~/.config/zexl/credentials.json, readable only by you.
- writes
- The agent follows
zexl_setup_guide: it addszexlto your dependencies, addsimport zexl.autoat the entry point, and suggests feature labels. Review the diff. - You run the app once. The agent calls
zexl_check_connectionand tells you what arrived.
What the agent gets
Two keys, both visible and revocable in Settings > API keys:
| Key | Can | Cannot |
|---|---|---|
Send key (in .env) | Send call metadata for this project, filed under the environment you chose | Read anything |
| Read key (for the MCP tools) | Read this workspace's figures | Send data, change budgets, keys, prices or members |
A request lasts 15 minutes and gives keys once.
After that
Ask the agent questions such as:
- "What did we waste last week, and how do I fix the biggest one?"
- "Why was Tuesday so expensive?"
- "Will we stay within budget this month?"
See MCP server for every tool.