Add Locus to an MCP client

If you haven’t installed the Locus plugin, add the Locus MCP server to your client directly. You paste one URL, sign in through your browser, and your agent can use the tools you’ve turned on.

How it works

Use your client’s browser sign-in flow and leave authorization headers empty. The client manages authentication for you. Choose Streamable HTTP if your client asks for a transport.

MCP server URL

https://api.paywithlocus.com/api/credits/mcp

The plain MCP connection gives your agent the Locus tools. The three Locus skills add guidance for setup, tool use, and Workflows. Some clients below show how to add them.

Set up your client

Open Customize → Connectors → Yours → Add connector → Add custom connector. Name it Locus, enter the MCP server URL above, choose Connect, and complete browser sign-in.Then open Customize → Skills → Yours → Add skill → Upload skill and upload all three archives:

This supplies the remote connector and complete skill tree to Claude surfaces that expose these account settings. Claude Code uses the plugin.

Enable Developer mode under Settings → Apps → Advanced settings, then open Plugins → Create app. Enter the MCP server URL above, choose OAuth, and finish Locus sign-in. Start a Work task, open Plugins, and select Locus Pro before asking it to use a tool.This custom-app path provides the MCP tools. ChatGPT’s current Skills picker may leave valid production archives ineligible. The MCP app still works; use get_locus_guide for the same versioned operating guides when the upload is unavailable.

Connect Codex CLI

codex mcp add locus-pro --url https://api.paywithlocus.com/api/credits/mcp
codex mcp login locus-pro --scopes mcp:read,mcp:execute,offline_access

This direct configuration provides MCP tools only. Install the Codex plugin to add all three skills with the connection.

Connect Claude Code

claude mcp add --transport http locus-pro \
  https://api.paywithlocus.com/api/credits/mcp

Run /mcp, select locus-pro, and choose Authenticate.

Add this to ~/.cursor/mcp.json, then complete browser sign-in:

~/.cursor/mcp.json

{
  "mcpServers": {
    "locus-pro": {
      "url": "https://api.paywithlocus.com/api/credits/mcp"
    }
  }
}

Save this as .vscode/mcp.json:

.vscode/mcp.json

{
  "servers": {
    "locus": {
      "type": "http",
      "url": "https://api.paywithlocus.com/api/credits/mcp"
    }
  }
}

Start locus from MCP: List Servers, then approve Locus in your browser.

Connect Gemini CLI

gemini mcp add locus-pro https://api.paywithlocus.com/api/credits/mcp --transport http

Start Gemini CLI, run /mcp auth locus-pro, and approve Locus in your browser.

Connect Cline

cline mcp install locus --transport http \
  https://api.paywithlocus.com/api/credits/mcp

Choose Remote (HTTP) and OAuth, leave the client ID blank, and complete browser sign-in. Then install all three skills and start a new Cline session:

npx skills add locus-technologies/locus-pro-plugin

Select locus, locus-setup, and locus-workflows when prompted.

Next steps

Connect an agent

Check your connection and troubleshoot problems.

MCP

See the tools your agent gets and choose a mode.

Getting started

Use Locus Pro

Explore tools

Account and billing

Agent access

Add Locus to an MCP client

How it works

Set up your client

Next steps

Connect an agent

MCP

​How it works

​Set up your client

​Next steps

Connect an agent

MCP

How it works

Set up your client

Next steps