Connect Claude Code
Add the remote MCP server to Claude Code.
Set up with your AI assistant
Paste the prompt into Claude Code. It includes setup steps and a read-only connection check.
Claude Code — Terminal (CLI): sign in with LeadsAgent (recommended)
The claude command in a terminal.
- Add LeadsAgent for all your projects. Use --scope project instead to share it through the project’s .mcp.json.Terminal
claude mcp add --transport http --scope user leadsagent https://leadsagent.io/mcp/v1 - Start sign-in. Or, inside Claude Code, type /mcp, choose leadsagent and choose Authenticate.Terminal
claude mcp login leadsagent - A browser opens. Sign in with your LeadsAgent account and approve access.
- Check it. /mcp shows ✔ Connected.Terminal
claude mcp get leadsagent
Claude Code — Terminal (CLI): use an API key
- On the LeadsAgent setup page, select “Create an API key”. Name it for this app and set its expiry and limits. Copy it once; it starts with la_.
- Set LEADSAGENT_API_KEY in the environment used by this app. Restart the app so it reads the variable. Keep the value out of chats and shared files.Terminal
LEADSAGENT_API_KEY - Merge this server into your project’s .mcp.json. Claude Code fills in ${LEADSAGENT_API_KEY} from the environment, so the key stays out of the file..mcp.json · project
{ "mcpServers": { "leadsagent": { "type": "http", "url": "https://leadsagent.io/mcp/v1", "headers": { "X-API-Key": "${LEADSAGENT_API_KEY}" } } } } - Check it. /mcp shows ✔ Connected.Terminal
claude mcp get leadsagent
Claude Code — Desktop app (Code tab): sign in with LeadsAgent (recommended)
The Code tab of the Claude desktop app. It reads the same configuration as the terminal.
- Easiest: add LeadsAgent once in Claude under Customize → Connectors (see the Claude connector page). Connectors from your Claude account show in the Code tab.
- Or run the terminal command once. The Code tab reads ~/.claude.json, the same file the terminal writes.Terminal
claude mcp add --transport http --scope user leadsagent https://leadsagent.io/mcp/v1 - In the Code tab, click + next to the prompt box, open Connectors, find leadsagent and connect it.
- A browser opens. Sign in with your LeadsAgent account and approve access.
- Start a new session. Ask Claude to check your LeadsAgent account.
Claude Code — Desktop app (Code tab): use an API key
- On the LeadsAgent setup page, select “Create an API key”. Name it for this app and set its expiry and limits. Copy it once; it starts with la_.
- Set LEADSAGENT_API_KEY in the environment used by this app. Restart the app so it reads the variable. Keep the value out of chats and shared files.System environment
LEADSAGENT_API_KEY - Merge this server into the project’s .mcp.json. The Code tab reads it when you open that project folder..mcp.json · project
{ "mcpServers": { "leadsagent": { "type": "http", "url": "https://leadsagent.io/mcp/v1", "headers": { "X-API-Key": "${LEADSAGENT_API_KEY}" } } } } - Restart the Claude desktop app so it reads the variable, then start a new session in the Code tab.
Claude Code — VS Code / JetBrains: sign in with LeadsAgent (recommended)
The Claude Code extension in VS Code or JetBrains. It reads the same configuration as the terminal.
- In the Claude Code panel, type /mcp and choose Add (VS Code extension 2.1.261 or later). Or run the terminal command in the editor’s terminal.Terminal
claude mcp add --transport http --scope user leadsagent https://leadsagent.io/mcp/v1 - In the panel, type /mcp, choose leadsagent and choose Authenticate.In Claude Code
/mcp - A browser opens. Sign in with your LeadsAgent account and approve access.
- Start a new conversation. MCP changes apply to new conversations only.
Claude Code — VS Code / JetBrains: use an API key
- On the LeadsAgent setup page, select “Create an API key”. Name it for this app and set its expiry and limits. Copy it once; it starts with la_.
- Set LEADSAGENT_API_KEY in the environment used by this app. Restart the app so it reads the variable. Keep the value out of chats and shared files.Editor environment
LEADSAGENT_API_KEY - Merge this server into the project’s .mcp.json..mcp.json · project
{ "mcpServers": { "leadsagent": { "type": "http", "url": "https://leadsagent.io/mcp/v1", "headers": { "X-API-Key": "${LEADSAGENT_API_KEY}" } } } } - Restart the editor so it reads the variable. In the panel, /mcp shows Connected.
Source: Claude Code docs: connect to MCP servers · Open in Connectors