> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote MCP (Custom Connectors)

> Connect to Generect MCP via Custom Connectors - no local installation required

Remote MCP servers extend AI capabilities beyond your local environment, providing access to internet-hosted tools and data sources. By connecting to Generect's remote MCP server, you can access lead search, company search, and email generation directly in your AI conversations without any local installation.

<Note>
  Remote MCP works with Claude (web and Desktop) and other MCP-compatible
  clients. For local installation via npx, see{" "}
  <a href="quick-start">Local MCP (npx)</a>.
</Note>

***

## Server Information

| Property        | Value                          |
| --------------- | ------------------------------ |
| **Registry ID** | `com.generect/generect-mcp`    |
| **Remote URL**  | `https://mcp.generect.com/mcp` |
| **Transport**   | Streamable HTTP                |
| **Auth**        | OAuth 2.1 or API Key           |

***

## Claude Desktop — Custom Connectors

<Warning>
  Claude documentation states:
  **Custom connectors are available for users with paid plans (Pro, Max, Team, or Enterprise).**

  This may change in the future, but for now this restriction applies.
</Warning>

<Steps>
  <Step title="Navigate to Connector Settings">
    Open [Claude Desktop](https://claude.ai/download). Click on your profile icon and select **Settings** from the dropdown menu. Then click on **Connectors** in the sidebar.
  </Step>

  <Step title="Add a Custom Connector">
    Scroll to the bottom and click **Add custom connector**.

    Enter the Generect MCP server URL:

    ```
    https://mcp.generect.com/mcp
    ```

    Leave Advanced settings empty.

    <img src="https://mintcdn.com/generect/X6p5e4jggJuPFyIO/media/remote-mcp-url.png?fit=max&auto=format&n=X6p5e4jggJuPFyIO&q=85&s=9d799d54ffe45902c6db08ba83f9bf8b" alt="enter-url" className="rounded-lg" width="3420" height="1968" data-path="media/remote-mcp-url.png" />

    Click **Add** to proceed.
  </Step>

  <Step title="Complete Authentication">
    Then click on "Connect". You will be redirected to login page.

    <img src="https://mintcdn.com/generect/X6p5e4jggJuPFyIO/media/mcp-connect-button.png?fit=max&auto=format&n=X6p5e4jggJuPFyIO&q=85&s=2f4f539b75514397258c35e82fe36e54" alt="click-connect" className="rounded-lg" width="3420" height="2144" data-path="media/mcp-connect-button.png" />

    Get your API key from <a href="https://beta.generect.com" target="_blank">beta.generect.com</a> and enter it on the login page.

    <img src="https://mintcdn.com/generect/X6p5e4jggJuPFyIO/media/mcp-oauth-login.png?fit=max&auto=format&n=X6p5e4jggJuPFyIO&q=85&s=1e51783749419f4de08751995475ea61" alt="click-connect" className="rounded-lg" width="3420" height="2144" data-path="media/mcp-oauth-login.png" />
  </Step>

  <Step title="Connector is ready">
    Now you can use Generect MCP server. Make sure that you have enabled it in Connectors tab.

    <img src="https://mintcdn.com/generect/9e6ewBZcnqnRB2k9/media/response-example.png?fit=max&auto=format&n=9e6ewBZcnqnRB2k9&q=85&s=7671db7fbdd85a4c8fa691163dea2323" alt="response-example" className="rounded-lg" width="1075" height="1280" data-path="media/response-example.png" />
  </Step>
</Steps>

***

## Other Clients (Cursor, OpenAI, etc.)

Integration with other MCP-compatible clients follows the same pattern:

1. **Find the MCP/Connector settings** in your client
2. **Add a remote MCP server** with URL: `https://mcp.generect.com/mcp`
3. **Configure authentication** with your API key (see formats below)

<Note>
  Each client has its own configuration method — look for "MCP", "Connectors",
  or "Tools" in settings. Some clients may require editing a config file, others
  provide a UI.
</Note>

### Supported `Authorization` header formats

If your client passes the API key directly via an `Authorization` header (no OAuth flow), the server accepts any of:

```
Authorization: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
Authorization: Token YOUR_API_KEY
Authorization: Bearer Token YOUR_API_KEY   (legacy, still supported)
```

Pick whichever format your client makes easiest. Example for `mcp-remote`:

```json theme={null}
{
  "mcpServers": {
    "generect": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.generect.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
```

***

## Remote MCP vs Local MCP

| Feature        | Remote MCP                | Local MCP (npx)              |
| -------------- | ------------------------- | ---------------------------- |
| Installation   | None required             | Requires Node.js & npx       |
| Configuration  | URL or registry ID        | Command + args in config     |
| Access         | Any MCP-compatible client | Requires local setup         |
| Offline access | Not available             | Available (with cached data) |
| Updates        | Automatic                 | Manual (`@latest`)           |

Choose **Remote MCP** for simplicity and accessibility. Choose **Local MCP** if you need offline capabilities or have network restrictions.

***

## Available Tools

The MCP integration provides access to the following `Generect API` functions:

* `search_leads`: Search for leads by ICP filters
* `search_companies`: Search for companies by ICP filters
* `generate_email`: Generate an email using first/last name and domain
* `get_lead_by_url`: Get LinkedIn lead by profile URL
* `health`: Quick health check against the API

***

## MCP Registry

Generect MCP is registered in the official MCP Registry:

```
com.generect/generect-mcp
```

* **Registry**: `com.generect/generect-mcp`
* **Repository**: [github.com/generect/generect\_mcp](https://github.com/generect/generect_mcp)