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

  1. The agent calls zexl_connect_start. It shows you a link and a code, like KX4P-9QRM.
  2. You open the link. Sign up or sign in (email or Google).
  3. The page shows the same code. Check that it matches. If it does not, or you did not ask for this, press Deny.
  4. Choose a workspace (or make a new one) and an environment. Development is the usual choice for a laptop. Press Approve.
  5. The agent calls zexl_connect_finish. On your machine, it:
    • writes ZEXL_API_KEY into the project's .env file. The agent only sees a masked form like zx_ab12…;
    • makes the salt locally. If the project already had a Zexl key, it keeps that salt so earlier calls still match;
    • adds .env to .gitignore when git would otherwise commit it;
    • saves a read key for the MCP tools in ~/.config/zexl/credentials.json, readable only by you.
  6. The agent follows zexl_setup_guide: it adds zexl to your dependencies, adds import zexl.auto at the entry point, and suggests feature labels. Review the diff.
  7. You run the app once. The agent calls zexl_check_connection and tells you what arrived.

What the agent gets

Two keys, both visible and revocable in Settings > API keys:

KeyCanCannot
Send key (in .env)Send call metadata for this project, filed under the environment you choseRead anything
Read key (for the MCP tools)Read this workspace's figuresSend 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.