---
title: "Connect an AI assistant"
url: https://docs.corefinity.com/mcp/connect
type: page
last_updated: 2026-11-13
feature: mcp
---
# Connect an AI assistant

Add the Corefinity MCP server to Claude Code, Claude, ChatGPT, Codex, Cursor, VS Code or another client.

Add this server address to your client, then sign in through your browser.

```text
https://manage.corefinity.com/api/mcp
```

A client that supports OAuth needs no token: you approve it on a Corefinity page. Any other client uses a personal token.

[Sign in and tokens](/mcp/sign-in-and-tokens) says who can connect.

## Sign in with OAuth

**Claude Code**

1. Run:

   ```bash
   claude mcp add --transport http --scope user corefinity https://manage.corefinity.com/api/mcp
   ```

2. In Claude Code, run `/mcp`, choose **corefinity**, then **Authenticate**.

**Claude**

In claude.ai or Claude Desktop, open **Customize › Connectors**, choose **+ Add**, then **Add custom connector**. Paste the server address and sign in.

**ChatGPT**

In ChatGPT, open **Plugins**, choose **+** and **Add custom MCP server**. Paste the server address under **Connection**, choose **OAuth** and sign in.

**Codex**

1. Run:

   ```bash
   codex mcp add corefinity --url https://manage.corefinity.com/api/mcp
   ```

2. Sign in:

   ```bash
   codex mcp login corefinity
   ```

**Cursor**

1. Add to `~/.cursor/mcp.json`:

   ```json
   {
     "mcpServers": {
       "corefinity": {
         "url": "https://manage.corefinity.com/api/mcp"
       }
     }
   }
   ```

2. In **Cursor Settings › Tools & MCP**, choose **corefinity** and sign in.

**VS Code**

1. Add to your user `mcp.json` (Command Palette: **MCP: Open User Configuration**):

   ```json
   {
     "servers": {
       "corefinity": {
         "type": "http",
         "url": "https://manage.corefinity.com/api/mcp"
       }
     }
   }
   ```

2. Start the server from the editor. VS Code opens the sign-in.

**Another client**

Use a personal token, as described next.

Your browser opens Corefinity's approval page. Choose what the app may do, where it works and how long it keeps access, then enter your two-factor code and approve.

The app then appears under **Active** on the **MCP & API Access** card of your organisation. [Scopes](/mcp/scopes) and [Limit a grant](/mcp/limit-a-grant) explain the choices.

## Connect with a personal token

claude.ai, Claude Desktop and ChatGPT connect with OAuth only.

1. **Create a token**

   Create a token in the Control Panel and copy it: [MCP and API access](/guides/organisation/developers/mcp-and-api-access) has the steps. It is shown once.

2. **Store it in an environment variable**

   Add this line to `~/.zshrc` or `~/.bashrc` with a text editor, then open a new terminal:

   ```bash
   export COREFINITY_MCP_TOKEN='YOUR_TOKEN'
   ```

   On Windows, add a user environment variable named `COREFINITY_MCP_TOKEN` instead.

3. **Point your client at the variable**

   **Claude Code**

   ```bash
   claude mcp add-json --scope user corefinity '{"type":"http","url":"https://manage.corefinity.com/api/mcp","headers":{"Authorization":"Bearer ${COREFINITY_MCP_TOKEN}"}}'
   ```

   The single quotes keep the reference literal: Claude Code reads the token from the environment when it connects.

   **Codex**

   Add to `~/.codex/config.toml`:

   ```toml
   [mcp_servers.corefinity]
   url = "https://manage.corefinity.com/api/mcp"
   bearer_token_env_var = "COREFINITY_MCP_TOKEN"
   ```

   **Cursor**

   Add to `~/.cursor/mcp.json` (your user file, never a project's):

   ```json
   {
     "mcpServers": {
       "corefinity": {
         "url": "https://manage.corefinity.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${env:COREFINITY_MCP_TOKEN}"
         }
       }
     }
   }
   ```

   **VS Code**

   Add to your user `mcp.json` (Command Palette: **MCP: Open User Configuration**):

   ```json
   {
     "servers": {
       "corefinity": {
         "type": "http",
         "url": "https://manage.corefinity.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${env:COREFINITY_MCP_TOKEN}"
         }
       }
     }
   }
   ```

   **Another client**

   Send the token as a header on every request, read from the variable:

   ```http
   POST /api/mcp HTTP/1.1
   Host: manage.corefinity.com
   Authorization: Bearer ${COREFINITY_MCP_TOKEN}
   Content-Type: application/json
   Accept: application/json, text/event-stream
   ```

   The server speaks MCP `2026-07-28` over Streamable HTTP and also accepts `2025-11-25` and `2025-06-18`.

> **Warning:** Never put the token in a project file or paste it into a command.

## Check it works

Ask the assistant:

```text
List my Corefinity sites.
```

It calls `corestack_site_list` and answers with your sites.
