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.
https://manage.corefinity.com/api/mcpA 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
-
Run:
claude mcp add --transport http --scope user corefinity https://manage.corefinity.com/api/mcp -
In Claude Code, run
/mcp, choose corefinity, then Authenticate.
In claude.ai or Claude Desktop, open Customize › Connectors, choose + Add, then Add custom connector. Paste the server address and sign in.
In ChatGPT, open Plugins, choose + and Add custom MCP server. Paste the server address under Connection, choose OAuth and sign in.
-
Run:
codex mcp add corefinity --url https://manage.corefinity.com/api/mcp -
Sign in:
codex mcp login corefinity
-
Add to
~/.cursor/mcp.json:{ "mcpServers": { "corefinity": { "url": "https://manage.corefinity.com/api/mcp" } } } -
In Cursor Settings › Tools & MCP, choose corefinity and sign in.
-
Add to your user
mcp.json(Command Palette: MCP: Open User Configuration):{ "servers": { "corefinity": { "type": "http", "url": "https://manage.corefinity.com/api/mcp" } } } -
Start the server from the editor. VS Code opens the sign-in.
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 and Limit a grant explain the choices.
Connect with a personal token
claude.ai, Claude Desktop and ChatGPT connect with OAuth only.
Create a token
Create a token in the Control Panel and copy it: MCP and API access has the steps. It is shown once.
Store it in an environment variable
Add this line to
~/.zshrcor~/.bashrcwith a text editor, then open a new terminal:export COREFINITY_MCP_TOKEN='YOUR_TOKEN'On Windows, add a user environment variable named
COREFINITY_MCP_TOKENinstead.Point your client at the variable
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.
Add to
~/.codex/config.toml:[mcp_servers.corefinity] url = "https://manage.corefinity.com/api/mcp" bearer_token_env_var = "COREFINITY_MCP_TOKEN"Add to
~/.cursor/mcp.json(your user file, never a project's):{ "mcpServers": { "corefinity": { "url": "https://manage.corefinity.com/api/mcp", "headers": { "Authorization": "Bearer ${env:COREFINITY_MCP_TOKEN}" } } } }Add to your user
mcp.json(Command Palette: MCP: Open User Configuration):{ "servers": { "corefinity": { "type": "http", "url": "https://manage.corefinity.com/api/mcp", "headers": { "Authorization": "Bearer ${env:COREFINITY_MCP_TOKEN}" } } } }Send the token as a header on every request, read from the variable:
POST /api/mcp HTTP/1.1 Host: manage.corefinity.com Authorization: Bearer ${COREFINITY_MCP_TOKEN} Content-Type: application/json Accept: application/json, text/event-streamThe server speaks MCP
2026-07-28over Streamable HTTP and also accepts2025-11-25and2025-06-18.
Never put the token in a project file or paste it into a command.
Check it works
Ask the assistant:
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.
Build a configuration
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.
{
"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.
Grant only what the job needs. An assistant acts on what it reads, including text inside your sites and tickets. Start with read.