# Connect CortexPlus to any AI

This is the complete setup for connecting CortexPlus to an AI client. One URL is all it takes:

```
https://mcp.cortexplus.io/mcp
```

The user does not need an account or an API key first — the account is created inside the conversation (see "No account yet?" below). Human-readable version of this page: https://cortexplus.io/connect.

## ChatGPT

Custom connectors require Developer mode. Whether it is available depends on the user's plan and workspace policy — on some accounts an admin must enable it.

1. Open Settings → Security and login → Developer mode and turn it on.
2. Go to https://chatgpt.com/plugins and click the + button.
3. Give the connector a name and a description.
4. In Connection, paste: https://mcp.cortexplus.io/mcp

## Claude (web, desktop, mobile)

Add CortexPlus as a custom connector. Available on Free, Pro, Max, Team and Enterprise plans; Free users are limited to one custom connector. On Team and Enterprise an owner adds it first under Organization settings → Connectors.

1. Open Customize → Connectors in Claude's settings.
2. Click +, then "Add custom connector".
3. Paste: https://mcp.cortexplus.io/mcp
4. Click Connect — Claude handles sign-in via OAuth.

Reference: https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp

## Claude Code and other CLIs

Any MCP-capable CLI can use the same URL. For Claude Code:

```sh
claude mcp add --transport http cortexplus https://mcp.cortexplus.io/mcp
```

## VS Code

One-click install via the official MCP installation URL handler (vscode:mcp/install?{url-encoded JSON}):

```
vscode:mcp/install?%7B%22name%22%3A%22cortexplus%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.cortexplus.io/mcp%22%7D
```

Equivalent configuration:

```json
{ "name": "cortexplus", "type": "http", "url": "https://mcp.cortexplus.io/mcp" }
```

## Cursor

One-click install via the Cursor MCP deeplink:

```
cursor://anysphere.cursor-deeplink/mcp/install?name=cortexplus&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmNvcnRleHBsdXMuaW8vbWNwIn0=
```

(The config parameter is the base64 encoding of {"type":"http","url":"https://mcp.cortexplus.io/mcp"}.)

## Gemini

There is no self-serve path in the Gemini app today: "Connected Apps" is a curated list chosen by Google and does not accept third-party MCP servers. Alternatives:

- Any MCP-capable CLI (for example Gemini CLI's mcpServers settings) using the same URL.
- The CortexPlus REST API: https://cortexplus.io/docs

## Any other MCP client

Point the client at the URL as a Streamable HTTP (remote HTTP) server:

```
https://mcp.cortexplus.io/mcp
Authorization: Bearer cortex_...
```

Clients with OAuth support discover everything automatically via https://mcp.cortexplus.io/.well-known/oauth-protected-resource — dynamic client registration and PKCE are already supported, so no key needs to be pasted.

## No account yet?

The user does not need to create an account or generate an API key beforehand:

1. Call the signup tool with the user's email address.
2. CortexPlus emails the user an authentication key — ask the user for it.
3. Call the connect tool with that key. It returns a CortexPlus API key (cortex_...) — store it in the client's connector configuration, or show it to the user once if it cannot be stored.

In clients with OAuth, none of this is needed: the authorization flow itself signs the user up or in.