> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywithlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an agent

> Install the Locus plugin or connect your agent through MCP.

Connect once to give your agent access to your enabled Locus tools. The
[quickstart](/locus-pro/individual/quickstart) lets your agent guide setup. For
manual setup, add this MCP server:

```text title="MCP server URL" wrap theme={null}
https://api.paywithlocus.com/api/credits/mcp
```

Use your client's browser sign-in flow and leave authorization headers empty.
The client manages authentication for you.

Choose either the plugin or manual setup below. You only need one connection.
See [MCP](/locus-pro/mcp) for the tool reference and compact mode.

## Install the Locus plugin

The [Locus plugin](https://github.com/locus-technologies/locus-pro-plugin)
adds the MCP connection and three skills:

* **Locus** helps your agent choose Tools and Recipes, check prices, and use results.
* **Locus setup** guides installation, sign-in, and account setup.
* **Locus Workflows** helps your agent build, test, save, and run repeatable processes.

Sign in through your client when prompted. You can create an account during
sign-in; the client stores and refreshes the connection's tokens.

<Tabs>
  <Tab title="Claude Code">
    ```text title="Install in Claude Code" wrap theme={null}
    /plugin marketplace add locus-technologies/locus-pro-plugin
    /plugin install locus@locus
    ```

    Run `/mcp`, select `locus`, and choose **Authenticate**.
  </Tab>

  <Tab title="Codex CLI">
    ```bash title="Install in Codex CLI" theme={null}
    codex plugin marketplace add locus-technologies/locus-pro-plugin
    codex plugin add locus@locus
    codex mcp login locus
    ```

    Start a new CLI session after installation.
  </Tab>

  <Tab title="Hermes">
    ```bash title="Install in Hermes" theme={null}
    hermes plugins install locus
    hermes plugins enable locus
    hermes mcp login agent-plugin-locus-0b597595__locus
    ```

    Complete browser sign-in, then start a new Hermes session.
  </Tab>

  <Tab title="Grok">
    Review the plugin repository, then install:

    ```bash title="Install in Grok" theme={null}
    grok plugin install locus-technologies/locus-pro-plugin --trust
    ```

    Grok opens browser sign-in when you first use the connection.
  </Tab>

  <Tab title="OpenClaw">
    ```bash title="Install in OpenClaw" theme={null}
    openclaw plugins install locus --marketplace locus-technologies/locus-pro-plugin
    openclaw gateway restart
    openclaw mcp login locus
    ```

    The bundle includes the MCP server. You do not need to add it separately.
  </Tab>
</Tabs>

<Note>
  Already connected manually? Remove the duplicate manual entry when switching
  to the plugin. One connection is enough.
</Note>

## Configure the MCP server directly

Use this option if you haven't installed the plugin. Cursor and Cline can
connect directly this way.

<Tabs>
  <Tab title="Codex CLI">
    ```bash title="Connect Codex CLI" theme={null}
    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
    ```
  </Tab>

  <Tab title="Claude Code">
    ```bash title="Connect Claude Code" theme={null}
    claude mcp add --transport http locus-pro \
      https://api.paywithlocus.com/api/credits/mcp
    ```

    Run `/mcp`, select `locus-pro`, and choose **Authenticate**.
  </Tab>

  <Tab title="Cursor">
    Add this to `~/.cursor/mcp.json`, then complete browser sign-in:

    ```json title="~/.cursor/mcp.json" theme={null}
    {
      "mcpServers": {
        "locus-pro": {
          "url": "https://api.paywithlocus.com/api/credits/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cline">
    ```bash title="Connect Cline" theme={null}
    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.
  </Tab>

  <Tab title="Other clients">
    Add the server URL in your client's MCP settings. Choose Streamable HTTP
    if it asks for a transport, then follow the sign-in prompt.
  </Tab>
</Tabs>

## Other plugin and skill clients

For a client that supports the Agent Plugins standard:

```bash title="Agent Plugins-compatible clients" theme={null}
npx plugins add locus-technologies/locus-pro-plugin
```

To install the three skills in an Agent Skills-compatible client:

```bash title="Install skills only" theme={null}
npx skills add locus-technologies/locus-pro-plugin
```

Select `locus`, `locus-setup`, and `locus-workflows` when prompted.
A skills-only install still needs the MCP connection above. If your client
cannot install skills, your agent can retrieve the same guides through MCP
using `get_locus_guide`.

## Keep the plugin up to date

Use your client's plugin manager to update Locus, then start a fresh session.
For OpenClaw, restart the gateway after a plugin change. Keep an existing
working connection when updating.

See the [plugin releases](https://github.com/locus-technologies/locus-pro-plugin/releases)
for changes. Public marketplace listings may update separately from the
GitHub version.

## Check the connection

Ask your agent to find a tool for a task. If it needs access, approve the
request or enable the tool under **Tools**.

Open **Connections** to review active clients. One client is included;
[connection plans](/locus-pro/individual/account-and-usage#connect-more-agents)
add capacity for more agent apps.

## Troubleshoot

| Problem                  | Next step                                           |
| ------------------------ | --------------------------------------------------- |
| No Locus tools appear    | Complete browser sign-in, then refresh the client   |
| A tool is missing        | Enable it under **Tools** and refresh the tool list |
| Authentication error     | Authenticate again through the client               |
| Insufficient credits     | Add funds under **Credits**                         |
| Connection limit reached | Revoke an unused client or change your plan         |

For an agent that owns its own account, see
[agent-native onboarding](/locus-pro/agent-native-onboarding).