Connect a hosted agent
Connecting is the primary way to use an agent. A hosted agent runs on FindAgent and is reachable over MCP — there is nothing to download and nothing to keep running locally. You add its server URL as a remote connector in your AI client and sign in once.
https://mcp.findagent.cloud/agents/<slug>. If you'd rather run everything — including credentials — on your own machine, install locally instead.How connecting works
- Pick your client, then add the server. On the agent's page, choose your client. For Cursor / VS Code / LM Studio / Claude, click Add to…. For any other client, copy the server URL and paste it where your client adds a remote MCP server or custom connector.
- Approve the server. Confirm the server in your client when it opens (or after you paste the URL).
- Sign in once. The first time you connect, your client opens a FindAgent sign-in page. Approve once and you're connected — no API key or token to copy. Access is tied to your FindAgent account and you can revoke it anytime from your dashboard.
Add the connector in your client
A hosted agent is served over a client-agnostic MCP gateway URL, so it works with EVERY MCP-capable client — you are never locked to a subset. A few examples:
- Claude (web & desktop): one-click Add to Claude, or Settings → Connectors → Add custom connector.
- Cursor · VS Code · LM Studio: one-click Add to… opens the client with the server pre-filled.
- ChatGPT (Plus / Pro): Settings → Connectors → add a remote MCP server, then paste the URL.
- Windsurf · Cline · Continue · Zed · Gemini CLI · Goose · JetBrains · Warp: add it to the client's MCP config file (the agent page shows the exact snippet).
- Any other MCP-capable client: add the URL as a remote / streamable-HTTP MCP server.
Config file clients
For clients configured by file — Cursor, VS Code, Windsurf, Claude Desktop, Gemini CLI — add the server to your mcp.json (in Claude Desktop: Settings → Developer → Edit Config):
{
"mcpServers": {
"findagent-atlas": {
"url": "https://mcp.findagent.cloud/agents/atlas"
}
}
}
Terminal / coding agents
Claude Code can add a remote server straight from the terminal:
claude mcp add --transport http findagent-atlas https://mcp.findagent.cloud/agents/atlas
Adding the server isn't enough on its own — you still have to sign in. Type /mcp inside Claude Code, pick the server (e.g. findagent-atlas), choose Authenticate, and approve the FindAgent sign-in page that opens. After that the agent's tools appear automatically.
Other CLI agents (for example Codex) add a remote MCP server with the same URL in their own MCP config, then run their own connect/authenticate step.
Which clients support remote MCP
15+ MCP clients can connect to a hosted FindAgent agent (this list is driven from the same registry the agent pages render, so it stays current):
| Client | One-click | How to add |
|---|---|---|
| Claude (web & desktop) | Yes | One-click “Add to…” or copy URL |
| ChatGPT (Plus / Pro) | — | Settings → Connectors (paste URL) |
| Cursor | Yes | One-click “Add to…” or copy URL |
| VS Code (Copilot) | Yes | One-click “Add to…” or copy URL |
| Claude Code | — | Terminal command (claude mcp add) |
| Gemini CLI | — | Config file (~/.gemini/settings.json) |
| Windsurf | — | Config file (~/.codeium/windsurf/mcp_config.json) |
| Cline | — | Config file (cline_mcp_settings.json) |
| Continue | — | Config file (.continue/config.yaml) |
| Zed | — | Config file (settings.json) |
| LM Studio | Yes | One-click “Add to…” or copy URL |
| Goose | Yes | One-click “Add to…” or copy URL |
| JetBrains AI Assistant | — | Config file (mcp.json) |
| Warp | — | Config file (Warp → MCP servers) |
| Postman | — | Settings → Connectors (paste URL) |