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

# Install NEUS

> Connect your agent environment to hosted NEUS MCP.

Connect assistants to verified identity, limited permissions, reusable trust receipts, and encrypted secrets.

**Hosted endpoint:** `https://mcp.neus.network/mcp`

To use a profile agent in a project, choose **Connect in** on its agent card, then run the copied `neus mount` command in that project.

<Tabs sync={false}>
  <Tab title="Quick start">
    ```bash theme={"dark"}
    neus setup
    neus check
    ```

    One OAuth sign-in configures hosted NEUS MCP for Cursor, Claude Code, and VS Code.

    Ask your assistant: **"Use NEUS Verify before taking sensitive actions."** It checks identity, permissions, and existing receipts first, then summarizes as Passed, Action needed, or Blocked.

    ```bash theme={"dark"}
    neus setup --client cursor
    neus setup --client codex
    neus setup --client vscode
    neus setup --client claude
    ```
  </Tab>

  <Tab title="Cursor">
    <Icon icon="https://mintcdn.com/neus-1d252ed4/uqc1acPMBuacHEie/images/brandLogos/cursor.svg?fit=max&auto=format&n=uqc1acPMBuacHEie&q=85&s=e07194906670b81dde695871b1fe2acf" size={18} width="24" height="24" data-path="images/brandLogos/cursor.svg" /> **Cursor**

    ```bash theme={"dark"}
    neus setup --client cursor
    ```

    Or add to `~/.cursor/mcp.json`:

    ```json theme={"dark"}
    {
      "mcpServers": {
        "neus": {
          "url": "https://mcp.neus.network/mcp"
        }
      }
    }
    ```

    **NEUS plugin** (trust receipts, agent permissions, session workflow):

    <Accordion title="Cursor manual install">
      ```text theme={"dark"}
      Cursor → Settings → Cursor Plugins → Add marketplace
      Marketplace URL: https://github.com/neus/network
      Install: neus-trust
      ```
    </Accordion>
  </Tab>

  <Tab title="Codex">
    <Icon icon="https://mintcdn.com/neus-1d252ed4/uqc1acPMBuacHEie/images/brandLogos/openai.svg?fit=max&auto=format&n=uqc1acPMBuacHEie&q=85&s=541750320db0abe88bf05c031fb3ee29" size={18} width="24" height="24" data-path="images/brandLogos/openai.svg" /> **Codex**

    ```bash theme={"dark"}
    neus setup --client codex
    ```

    Setup starts Codex OAuth. If your host asks you to sign in again, use `codex mcp login neus`.

    Config path: `~/.codex/config.toml`

    **NEUS plugin** (trust receipts, agent permissions, session workflow):

    <Accordion title="Codex manual install">
      ```text theme={"dark"}
      codex plugin marketplace add https://github.com/neus/network
      codex plugin install neus-trust
      ```
    </Accordion>
  </Tab>

  <Tab title="VS Code">
    <Icon icon="https://mintcdn.com/neus-1d252ed4/uqc1acPMBuacHEie/images/brandLogos/microsoft.svg?fit=max&auto=format&n=uqc1acPMBuacHEie&q=85&s=0f9f348a89482dcee6a724b85365d73a" size={18} width="24" height="24" data-path="images/brandLogos/microsoft.svg" /> **VS Code**

    ```bash theme={"dark"}
    neus setup --client vscode
    ```

    | OS      | Path                                               |
    | ------- | -------------------------------------------------- |
    | macOS   | `~/Library/Application Support/Code/User/mcp.json` |
    | Linux   | `~/.config/Code/User/mcp.json`                     |
    | Windows | `%APPDATA%\Code\User\mcp.json`                     |

    Project scope: `./.vscode/mcp.json`
  </Tab>

  <Tab title="Claude Code">
    <Icon icon="https://mintcdn.com/neus-1d252ed4/uqc1acPMBuacHEie/images/brandLogos/anthropic.svg?fit=max&auto=format&n=uqc1acPMBuacHEie&q=85&s=8d5b7209167b6ce01bc07380ba913e6d" size={18} width="24" height="24" data-path="images/brandLogos/anthropic.svg" /> **Claude Code**

    ```bash theme={"dark"}
    neus setup --client claude
    ```

    **NEUS plugin** (trust receipts, agent permissions, session workflow):

    <Accordion title="Claude Code manual install">
      ```text theme={"dark"}
      /plugin marketplace add https://github.com/neus/network
      /plugin install neus-trust@neus
      /neus-trust:neus-trust-workflow
      ```
    </Accordion>
  </Tab>
</Tabs>

## Other MCP hosts

Add remote MCP URL **`https://mcp.neus.network/mcp`** in the host settings, or the JSON below for file-based config.

| Host           | Config file                                                                                      |
| -------------- | ------------------------------------------------------------------------------------------------ |
| Claude Desktop | `~/.claude.json` → `mcpServers`                                                                  |
| Cline          | `cline_mcp_settings.json` in Cline settings                                                      |
| Windsurf       | `~/.codeium/windsurf/mcp_config.json`                                                            |
| Gemini CLI     | `~/.gemini/settings.json` or `gemini mcp add --transport http neus https://mcp.neus.network/mcp` |
| ChatGPT        | Remote MCP URL in client settings                                                                |

For servers and CI, use Profile access keys in bearer headers: [Auth](./auth). Install **neus-trust\@neus** for the bundled trust workflow skill in hosts that support plugins.

```json theme={"dark"}
{
  "mcpServers": {
    "neus": {
      "type": "http",
      "url": "https://mcp.neus.network/mcp"
    }
  }
}
```

## Servers and CI

```bash theme={"dark"}
neus setup --access-key <npk_...>
```

Keys: [Profile -> Account](https://neus.network/profile?tab=account). Never paste keys into chat.

<Warning>
  Use **`https://mcp.neus.network/mcp`** for trust receipts and agent tools. The docs site also offers a **search-only** endpoint at `https://docs.neus.network/mcp` - it cannot verify identity or create receipts.
</Warning>