## Connect your AI client to Levr MCP

Connect to `https://mcp.levr.ai/mcp` using remote **Streamable HTTP** MCP. Sign in with your Levr account through **OAuth with PKCE**. An External API key, the REST API URL, and a bare `/mcp` path are not MCP connection credentials.

### Before you start

Use the URL for the intended Levr environment. Hosted clients need a reachable HTTPS URL; localhost works only for a client on the same computer. Your client must support remote HTTP MCP and interactive OAuth. Your plan or workspace administrator may restrict custom connections.

### Choose your client

Client instructions checked against the linked vendor documentation on 2026-10-01. Labels and availability can change; use the vendor link if your interface differs.

#### ChatGPT / ChatGPT Work

You can connect Levr from ChatGPT on the web; the desktop app is not required. Open the **Plugins directory**, which is separate from **Settings → Plugins** (`https://chatgpt.com/settings/plugins-settings`). The Settings page manages installed plugins and permissions; select **Browse directory** there to reach the directory.

1. Open [ChatGPT Plugins](https://chatgpt.com/plugins) directly in your browser.
2. Select the plus button, then **Add custom MCP server**. Name the connection **Levr** and enter `https://mcp.levr.ai/mcp` as the **Server URL**.
3. Choose **OAuth**, sign in to Levr, and approve access. Use the default OAuth client setup; do not enter an External API key or invent a client secret.
4. Review the risk warning and select **Create as a plugin**.
5. Find Levr in your personal or workspace plugins, open it, and select the plus button to **install** it.
6. Start a new chat, type `@` in the prompt box, and select **Levr**. Use the read-only verification below to check the connection.

The current Plugins flow does not require a Developer mode step. Some accounts still show **Settings → Apps → Advanced settings → Developer mode** and **Create app**. If **Add custom MCP server** is missing from the Plugins directory, check your account's availability and workspace permissions, including Lockdown restrictions.

ChatGPT instructions checked on 2026-10-08. Sources: [OpenAI custom MCP setup](https://developers.openai.com/api/docs/guides/custom-mcp-server), [plugin installation and use](https://learn.chatgpt.com/docs/plugins).

#### Codex

Run:

```sh
codex mcp add levr --url https://mcp.levr.ai/mcp
codex mcp login levr
```

Complete the browser sign-in. Use `/mcp` in Codex to inspect the active server. In the IDE extension, **MCP servers → Add server** also supports Streamable HTTP and an Authenticate action.

Source: [Codex MCP setup](https://developers.openai.com/codex/mcp).

#### Claude

Open **Customize → Connectors → Add → Add custom connector**, name it **Levr**, and enter `https://mcp.levr.ai/mcp`. Connect and complete Levr's browser authorization. Team and Enterprise workspaces may require an owner or authorized administrator to add the connector first.

Source: [Claude custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

#### Claude Code

Run `claude mcp add --transport http levr https://mcp.levr.ai/mcp`, then use `/mcp` to authenticate with Levr.

Source: [Claude Code MCP setup](https://code.claude.com/docs/en/mcp).

#### VS Code / GitHub Copilot

Run **MCP: Add Server** from the Command Palette, choose HTTP, and enter `https://mcp.levr.ai/mcp`. Follow the trust and OAuth sign-in prompts. These instructions cover interactive VS Code; other Copilot surfaces have separate capabilities.

Source: [VS Code MCP servers](https://code.visualstudio.com/docs/agent-customization/mcp-servers).

#### Cursor

Add this entry to your personal `~/.cursor/mcp.json` or the project's `.cursor/mcp.json`, then complete the client's OAuth sign-in:

```json
{"mcpServers":{"levr":{"url":"https://mcp.levr.ai/mcp"}}}
```

Source: [Cursor MCP integrations](https://prod.cursor.com/help/customization/mcp).

#### Gemini CLI

Add a `levr` entry under `mcpServers` in your Gemini CLI settings with `"httpUrl": "https://mcp.levr.ai/mcp"`. Use `/mcp auth levr` to complete OAuth sign-in.

Source: [Gemini CLI MCP servers](https://geminicli.com/docs/tools/mcp-server/).

### Verify the connection

Ask your client: “List the Levr Portals I can access. Do not change anything.” A successful read through Levr confirms the connection works. A configured URL or successful authorization alone does not confirm that a tool call succeeded. An empty Portal list can be a valid result for an account with no Portal access.

Your client discovers available tools from Levr. Do not infer tool names from the REST API or configure a saved tool catalog. The connection uses your current Levr permissions.

### Troubleshoot or disconnect

- Missing custom-connection controls: check your client plan and workspace policy.
- Sign-in or discovery failure: check the complete environment-specific URL, then reconnect and authorize again.
- Missing tools or Portals: check the signed-in Levr account and its permissions.
- Continuing failure: contact [Levr support](mailto:support@levr.ai) with the client name, URL, and error. Do not send passwords, authorization codes, tokens, or secrets.

Review or revoke access in Levr **Account settings → Security → Connected MCP apps**.

### Give your AI a goal

Open **Connect** on a business, Project, or Deal and copy its instructions into your connected AI client. Add the outcome you want—for example, “Find the missing answers in this application and help me complete them. Do not submit it.” The instructions identify the record and link to its documentation.

### Choose your task

- [Businesses and intake](https://docs.levr.ai/mcp/resources/businesses.md): organize a client and complete intake.
- [Projects](https://docs.levr.ai/mcp/resources/projects.md): work toward a funding goal.
- [Matchmaking](https://docs.levr.ai/mcp/resources/matchmaking.md): review recommendations and create Deals.
- [Deals and applications](https://docs.levr.ai/mcp/resources/deals.md): complete an application for a recipient.
- [Lead sources](https://docs.levr.ai/mcp/resources/source_channels.md): configure how clients enter your Portal.
- [Application forms](https://docs.levr.ai/mcp/resources/application_definitions.md): prepare questions for future applications.

Your live connection determines which tools are available. Read the guide and tool contracts relevant to your task instead of loading every contract.