Skip to content

connector.mdx

Latest commit

 

History

History
229 lines (182 loc) · 9.44 KB

connector.mdx

File metadata and controls

229 lines (182 loc) · 9.44 KB
Raw
title Install the Connector (MCP)
sidebarTitle Connector (MCP)
description Connect Vibe Prospecting to Claude, Gemini CLI, or any MCP-compatible client and start prospecting with live B2B data in minutes.
icon plug

The Vibe Prospecting connector is a remote MCP (Model Context Protocol) server that gives any compatible AI client live access to Explorium's B2B data — 150M+ companies and 800M+ professionals across 50+ data sources. Once connected, you can search companies, discover contacts, enrich records, and export lead lists directly from your chat.

**Connector or plugin?** The connector is the fastest way to use Vibe Prospecting in chat-based clients like Claude.ai and Gemini CLI. If you work in **Claude Code** or **OpenAI Codex** and want file I/O, CSV workflows, and repeatable multi-step automations, use the [Vibe Prospecting Plugin](/installation/plugin) instead.

Prerequisites

  • A Vibe Prospecting account — sign up free at vibeprospecting.ai
  • An MCP-compatible client (Claude.ai, Claude Desktop, Gemini CLI, Cursor, and others)

Authentication is handled via OAuth in your browser. No API key is required.

Connector URL

If your client asks for a remote MCP server URL, use:

https://vibeprospecting.explorium.ai/mcp

Installation

Vibe Prospecting is listed in Claude's connectors directory, so setup takes under a minute. 
<Steps>
  <Step title="Open connector settings">
    In [Claude.ai](https://claude.ai), go to **Settings → Connectors**.
  </Step>
  <Step title="Find Vibe Prospecting">
    Click **Browse connectors** and search for **Vibe Prospecting**.
  </Step>
  <Step title="Connect and authorize">
    Click **Connect**. A browser window opens for OAuth — sign in with your Vibe Prospecting account and approve access.
  </Step>
  <Step title="Enable it in your chat">
    In a conversation, open the tools menu and make sure **Vibe Prospecting** is toggled on.
  </Step>
</Steps>

<Tip>
  Can't find it in the directory? Add it manually via **Settings → Connectors → Add custom connector** and paste the connector URL above.
</Tip>
In Claude Desktop, go to **Settings → Connectors**. Search the directory for **Vibe Prospecting**, or choose **Add custom connector** and paste: 
    ```text
    https://vibeprospecting.explorium.ai/mcp
    ```
  </Step>
  <Step title="Authorize">
    Complete the OAuth sign-in in your browser when prompted.
  </Step>
</Steps>
Install the extension directly from the open-source repository: 
```bash
gemini extensions install https://github.com/explorium-ai/vibeprospecting-mcp
```

For local development, link a cloned copy instead:

```bash
gemini extensions link /path/to/vibeprospecting-mcp
```

The extension is loaded and managed automatically by Gemini CLI, and OAuth authentication is handled on first use. See the [Gemini CLI extensions documentation](https://geminicli.com/docs/extensions/) for more.
Connect Vibe Prospecting from Manus's built-in connectors UI — no local server or API key needed. 
<Steps>
  <Step title="Open the connectors menu">
    In Manus, open the **connectors** menu (or choose **\+ Add connectors**).
  </Step>
  <Step title="Find Vibe Prospecting">
    Search for **`vibe`**. Under **Apps**, select **Vibe Prospecting** ("Build B2B lead lists and enrich companies and contacts").
  </Step>
  <Step title="Connect and sign in">
    Confirm the connector details (MCP by Explorium), then click **Try it out** / connect and complete the browser sign-in.
  </Step>
</Steps>

Once connected, use Vibe Prospecting from any Manus chat with prompts like the ones in [Try these prompts](#try-these-prompts).
Hermes uses the same remote endpoint, but its CLI needs the server written to config plus an explicit OAuth login. 
<Steps>
  <Step title="Register the server">
    Write **both** keys directly under `mcp_servers:` — the namespace that `hermes mcp login` (and the runtime) read from:

    ```bash
    hermes config set mcp_servers.vibe_prospecting.url "https://vibeprospecting.explorium.ai/mcp"
    hermes config set mcp_servers.vibe_prospecting.auth oauth
    ```

    <Warning>
      Don't use `hermes mcp add`: in a non-interactive shell it can fail mid-way and save a disabled, half-written entry under `mcp_servers:` — `auth` set but `url` dropped — which then fails at login. Setting both keys yourself avoids this, and if you already hit it, the same two commands repair it. (A `url` showing up elsewhere in config doesn't count — `hermes mcp login` only reads `mcp_servers:`.)
    </Warning>
  </Step>
  <Step title="Sign in">
    This opens your browser to authenticate:

    ```bash
    hermes mcp login vibe_prospecting
    ```

    <Note>
      On a **remote, SSH, or Docker** host, the browser can't reach the local callback after you approve — that's expected. Copy the **full URL** from the address bar and paste it back at the Hermes prompt.
    </Note>
  </Step>
  <Step title="Verify and use">
    Run `hermes mcp list` — `vibe_prospecting` should show as authenticated. Start a **new chat** so the `mcp_vibe_prospecting_*` tools load, then try a prompt from [Try these prompts](#try-these-prompts). To get a CSV, ask Hermes to **"export and download"** (exports return a link, not the file itself).
  </Step>
</Steps>

<Tip>
  Connection drops on the first call? The default MCP discovery timeout is too short for the OAuth handshake — raise it with `hermes config set mcp_discovery_timeout 10`.
</Tip>
Any client that supports **remote MCP servers with OAuth** can connect. Add the server to your client's MCP configuration. For example, in Cursor (`~/.cursor/mcp.json`): 
```json
{
  "mcpServers": {
    "vibe-prospecting": {
      "url": "https://vibeprospecting.explorium.ai/mcp"
    }
  }
}
```

Restart the client and complete the OAuth prompt on first use. Refer to your client's documentation for the exact configuration format.

Verify the connection

Send a simple prospecting prompt in a new chat:

Find 5 B2B SaaS companies in the US with 200–1,000 employees
If the assistant calls Vibe Prospecting tools (such as `fetch-entities`) and returns a sample of real companies with a cost estimate, you're connected.

Try these prompts

Who should I contact for a partnership with monday.com? Bring me all the contact details you can find.

Get the engineering leadership team at Palo Alto Networks.

Find CTOs at fintech companies in New York that raised funding in the last 90 days.

Troubleshooting

Make sure the connector is enabled for the current conversation (check the tools menu), then start a new chat. In Gemini CLI, restart the CLI after installing the extension. Disconnect the connector in your client's settings, reconnect, and complete the OAuth flow again. In Hermes, run `hermes mcp login vibe_prospecting` again. Confirm you're signing in with the account registered at [vibeprospecting.ai](https://www.vibeprospecting.ai). Your filters may be too narrow. Broaden the criteria or reduce the number of required filters — see [Best Practices](/vibe-prospecting/best-practices). Check the general [Troubleshooting](/vibe-prospecting/troubleshooting) guide, or contact [support@vibeprospecting.ai](mailto:support@vibeprospecting.ai).

Connector vs. plugin

Connector (MCP) Plugin
Runs in Claude.ai, Claude Desktop, Gemini CLI, other MCP clients Claude Code, OpenAI Codex
Best for Conversational prospecting, research, quick lists File-based workflows, CSV enrichment, repeatable automations
Setup One-click connect + OAuth CLI install + OAuth login
Output In-chat results and exports CSV/JSON files, CRM-ready exports

Next steps

Learn how to structure queries and run your first search. Target with 20\+ business and prospect attributes. Use Vibe Prospecting inside Claude Code and Codex. Get better results and use credits efficiently.