> For the complete documentation index, see [llms.txt](https://timechain.gitbook.io/neucron-mcp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://timechain.gitbook.io/neucron-mcp/connect-mcp-server.md).

# Connect MCP Server

## Configuration template

Every client uses the same core settings. Replace the placeholders with your values:

```json
{
  "mcpServers": {
    "neucron": {
      "command": "node",
      "args": ["/absolute/path/to/neucron-mcp/dist/index.js"],
      "env": {
        "NEUCRON_AUTH_TOKEN": "<your-session-token>",
        "NEUCRON_BUSINESS_ID": "<your-business-id>"
      }
    }
  }
}
```

| Field                     | Description                                                    |
| ------------------------- | -------------------------------------------------------------- |
| `command`                 | `node` — runs the compiled JavaScript server                   |
| `args`                    | Absolute path to `dist/index.js` on your machine               |
| `env.NEUCRON_AUTH_TOKEN`  | Your Neucron session token (optional if using `neucron_login`) |
| `env.NEUCRON_BUSINESS_ID` | Default business ID for business-scoped tools                  |

{% hint style="warning" %}
Always use an **absolute path** to `dist/index.js`. Relative paths may fail depending on how the client launches the process.
{% endhint %}

## Cursor

### Setup

{% stepper %}
{% step %}
Open **Cursor Settings → MCP** (or edit your MCP config file directly).
{% endstep %}

{% step %}
Add the `neucron` server entry using the configuration template above.
{% endstep %}

{% step %}
Use forward slashes in paths on all platforms — they work in JSON on Windows too.

**Windows example:**

```json
{
  "mcpServers": {
    "neucron": {
      "command": "node",
      "args": ["D:/projects/neucron-mcp/dist/index.js"],
      "env": {
        "NEUCRON_AUTH_TOKEN": "<your-session-token>",
        "NEUCRON_BUSINESS_ID": "<your-business-id>"
      }
    }
  }
}
```

Alternatively, use escaped backslashes: `"D:\\projects\\neucron-mcp\\dist\\index.js"`.
{% endstep %}

{% step %}
Restart Cursor or reload MCP servers from the MCP settings panel.
{% endstep %}

{% step %}
Confirm **neucron** appears under available MCP tools in the agent panel.
{% endstep %}
{% endstepper %}

## Claude Desktop

### Setup

{% stepper %}
{% step %}
Open your Claude Desktop MCP configuration file:

{% tabs %}
{% tab title="macOS" %}
`~/Library/Application Support/Claude/claude_desktop_config.json`
{% endtab %}

{% tab title="Windows" %}
`%APPDATA%\Claude\claude_desktop_config.json`
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
Add the `neucron` entry inside `mcpServers`:

```json
{
  "mcpServers": {
    "neucron": {
      "command": "node",
      "args": ["/absolute/path/to/neucron-mcp/dist/index.js"],
      "env": {
        "NEUCRON_AUTH_TOKEN": "<your-session-token>",
        "NEUCRON_BUSINESS_ID": "<your-business-id>"
      }
    }
  }
}
```

{% endstep %}

{% step %}
Save the file and fully restart Claude Desktop.
{% endstep %}

{% step %}
Start a new conversation — Claude will have access to all `neucron_*` tools.
{% endstep %}
{% endstepper %}

## Claude Code

Add the server to your Claude Code MCP configuration using the same template:

```json
{
  "mcpServers": {
    "neucron": {
      "command": "node",
      "args": ["/absolute/path/to/neucron-mcp/dist/index.js"],
      "env": {
        "NEUCRON_AUTH_TOKEN": "<your-session-token>",
        "NEUCRON_BUSINESS_ID": "<your-business-id>"
      }
    }
  }
}
```

Refer to the Claude Code documentation for the location of your MCP config file.

## Verify the connection

### In your MCP client

After configuring and restarting your client:

{% stepper %}
{% step %}
Confirm **neucron** appears in the MCP server list.
{% endstep %}

{% step %}
Confirm tools named `neucron_*` are available (33 tools total).
{% endstep %}

{% step %}
Ask your agent: *"List my Neucron wallets"* — it should call `neucron_list_wallets`.
{% endstep %}
{% endstepper %}

## Authentication options

### Pre-configured token (recommended)

Set `NEUCRON_AUTH_TOKEN` and optionally `NEUCRON_BUSINESS_ID` in the `env` block of your MCP config. Every session starts authenticated with no extra steps.

### Login at session start

Omit `NEUCRON_AUTH_TOKEN` from your config and ask your agent to log in first:

> "Log in to Neucron with my email and password, then list my wallets."

The agent will call `neucron_login`, then proceed with other tools.

### Choose entity after login

If you manage multiple businesses, call `neucron_choose_entity` after login to list entities and set the active business context, or pass `businessId` on individual tool calls.

## Common issues

| Symptom                       | Likely cause                               | Fix                                                                  |
| ----------------------------- | ------------------------------------------ | -------------------------------------------------------------------- |
| Server not listed in client   | Wrong path or client not restarted         | Verify absolute path; restart client fully                           |
| `ENOENT` or command not found | Node.js not on PATH for the client process | Use full path to `node` binary, or ensure Node is installed globally |
| All tool calls fail with 401  | Missing or expired token                   | Refresh `NEUCRON_AUTH_TOKEN` or use `neucron_login`                  |
| Business-scoped tools fail    | No business context                        | Set `NEUCRON_BUSINESS_ID` or call `neucron_choose_entity`            |
| MFA required response         | Operation needs manual approval            | Complete authorization in Neucron Console, then retry                |
| File upload tools fail        | Invalid file path                          | Use an absolute local path or provide `fileBase64` instead           |

## Next steps

Once connected, explore the [Tools Reference](broken://pages/0594b23ba0bae3469ab866f083f62d052f995ee2) to see everything your agent can do with Neucron.