CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 2 of 16

Connect an AI assistant

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

On this page

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 says who can connect.

Sign in with OAuth

  1. Run:

    Terminal
    claude mcp add --transport http --scope user corefinity https://manage.corefinity.com/api/mcp
  2. In Claude Code, run /mcp, choose corefinity, then Authenticate.

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 and 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 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:

    Terminal
    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

    Terminal
    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.

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.

One-click install

Cursor and VS Code can add the server for you. Each opens the app and asks before it adds anything.

Add to CursorAdd to VS Code

Build a configuration

Sign in with
Browser sign-in, or a personal token.
What it may do
  • readSee your clusters, sites, environments, logs, usage and files. Changes nothing.
  • writeCreate or change sites, environments and settings; remove settings. No commands.
  • execRun shell, WP-CLI, Artisan, Composer and database commands, on production too.
  • destructiveDelete clusters, sites, environments and snapshots, or overwrite production.
~/.cursor/mcp.json
{
  "mcpServers": {
    "corefinity": {
      "url": "https://manage.corefinity.com/api/mcp"
    }
  }
}

Scopes are chosen when you approve the connection in the Control Panel, not in this file.

Add to Cursor

Grant only what the job needs. An assistant acts on what it reads, including text inside your sites and tickets. Start with read.

Was this helpful?
Open in ClaudeOpen in ChatGPT