Connect an agent
Install the SimpliGen connector into Claude Code, Cursor, and other AI clients.
Open the app and go to Settings -> Connect an agent. You will see a grid of supported clients, with a "detected" badge on the ones already installed on your machine. Local generation is always free; cloud generation only happens if you connect SimpliGen Cloud and allow it.
What you need
Node.js installed (the connector runs through npx), and the SimpliGen app open while the agent works.
One-click install
Most clients (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Gemini CLI, OpenAI Codex, OpenClaw, Zed) install in one click:
- Click the client, optionally set a cloud spend cap, and click Install.
- SimpliGen creates a token and writes its connector, token included, into that client's config for you, leaving any other servers you have set up untouched. There is no key to copy or paste; the new entry under Connected agents is that token.
- Fully quit and reopen the client so it re-reads its config. Closing the window is not enough for clients that keep running in the system tray (Codex and Claude Desktop do): right-click the tray icon, choose Quit, then open it again.
That is it. The agent can now reach SimpliGen.
OpenAI Codex
Codex keeps its config in ~/.codex/config.toml (or $CODEX_HOME/config.toml), shared by the Codex app, the CLI and the IDE extension, so one install covers all three. SimpliGen adds a [mcp_servers.simpligen] table and leaves the rest of the file as it is. If the file cannot be written, the panel shows the exact block to paste at the end of it.
Guided setup
Goose and Hermes use config formats we do not write automatically. For these, SimpliGen shows numbered steps with the exact command or snippet to paste, including your token. Follow the steps in order, then restart the client.
Manual setup
For any other MCP client, choose Manual setup. SimpliGen creates a token and shows the config to paste:
{
"mcpServers": {
"simpligen": {
"command": "npx",
"args": ["-y", "@simpligen/mcp"],
"env": { "SIMPLIGEN_TOKEN": "sg-agent-..." }
}
}
}Restart the client afterwards.
Your token is shown once
Copy it before you close the panel. If you lose it, just create a new one; it costs nothing and you can have as many as you like.
Managing connected agents
The Connected agents list shows every agent you have set up, its spend cap and spend so far, and when it was last used. Click Remove to revoke its token and clean SimpliGen out of that client's config. Revoking takes effect immediately, so it is a safe way to cut off an agent you no longer use.
Next: see Using an agent for what it can actually do.