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
- Copy the server URL. A hosted agent's page shows a remote MCP server URL.
- Add it as a connector. Paste the URL wherever your client adds a remote MCP server or custom connector.
- 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
- Claude (web & desktop): Settings → Connectors → Add custom connector.
- ChatGPT (Plus / Pro): Settings → Connectors → add a remote MCP server.
- Gemini (Gemini CLI and compatible clients): add it as an MCP server.
- 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
| Client | Remote MCP connector | How to add |
|---|---|---|
| Claude (web & desktop) | Yes | Settings → Connectors |
| ChatGPT (Plus / Pro) | Yes | Settings → Connectors |
| Claude Code | Yes | claude mcp add |
| Cursor · VS Code · Windsurf | Yes | mcp.json |
| Gemini CLI | Yes | mcp.json |