Skip to content
Documentation menu
Using agents

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.

Where the URL comes from
Each agent's page shows its hosted MCP server URL in the form https://mcp.findagent.cloud/agents/<slug>. If you'd rather run everything — including credentials — on your own machine, install locally instead.

How connecting works

  1. Copy the server URL. A hosted agent's page shows a remote MCP server URL.
  2. Add it as a connector. Paste the URL wherever your client adds a remote MCP server or custom connector.
  3. 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):

mcp.json
{
  "mcpServers": {
    "findagent-atlas": {
      "url": "https://mcp.findagent.cloud/agents/atlas"
    }
  }
}

Terminal / coding agents

Claude Code can add a remote server straight from the terminal:

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

ClientRemote MCP connectorHow to add
Claude (web & desktop)YesSettings → Connectors
ChatGPT (Plus / Pro)YesSettings → Connectors
Claude CodeYesclaude mcp add
Cursor · VS Code · WindsurfYesmcp.json
Gemini CLIYesmcp.json
Install vs connect
Connecting needs no local runtime, which is what makes a hosted agent reachable from web and mobile clients. If you'd rather keep everything — including credentials — on your own machine, install locally instead.