# Connect an agent (/docs/agents/connect-an-agent)



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.

<Callout type="info" title="What you need">
  Node.js installed (the connector runs through `npx`), and the SimpliGen app open while the agent works.
</Callout>

## One-click install [#one-click-install]

Most clients (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Gemini CLI, OpenClaw, Zed) install in one click:

1. Click the client, optionally set a cloud spend cap, and click **Install**.
2. SimpliGen writes its connector into that client's config for you, leaving any other servers you have set up untouched.
3. **Restart the client** so it picks up the change.

That is it. The agent can now reach SimpliGen.

## Guided setup [#guided-setup]

A few clients (OpenAI Codex, Goose, 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 [#manual-setup]

For any other MCP client, choose **Manual setup**. SimpliGen creates a token and shows the config to paste:

```json
{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": { "SIMPLIGEN_TOKEN": "sg-agent-..." }
    }
  }
}
```

Restart the client afterwards.

<Callout type="warn" title="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.
</Callout>

## Managing connected agents [#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](/docs/agents/using-an-agent) for what it can actually do.