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

# Connecting to the Server

> The Nexudus MCP server URL, prerequisites, and what to expect the first time you connect.

# Connecting to the Server

The Nexudus MCP server is a hosted service. You do not install anything locally — you point your MCP client at the server URL and log in with your Nexudus account.

## Server URL

```
https://mcp.nexudus.com
```

This is the only address you need. All client setup pages start by entering this URL.

## Prerequisites

* **A Nexudus account** with the permissions you want the AI assistant to use. The server only sees data your account can see.
* **An MCP-capable client** — Claude.ai, ChatGPT, Claude Desktop, Claude Code, or VS Code with GitHub Copilot. See [Supported clients](#supported-clients) below.
* **A web browser** for the one-time login. The first connection opens a browser window where you enter your Nexudus email and password.

## Supported clients

The Nexudus MCP server has been tested with the following clients. Each has its own setup steps:

<CardGroup cols={2}>
  <Card title="Claude.ai" icon="message" href="/mcp/clients/claude-ai">
    Web chat at claude.ai.
  </Card>

  <Card title="ChatGPT" icon="message-bot" href="/mcp/clients/chatgpt">
    Web chat at chatgpt.com.
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="/mcp/clients/claude-desktop">
    Anthropic's desktop app.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp/clients/claude-code">
    Anthropic's terminal-based AI assistant.
  </Card>

  <Card title="VS Code (GitHub Copilot)" icon="code" href="/mcp/clients/vs-code">
    GitHub Copilot's MCP extension.
  </Card>
</CardGroup>

## Technical requirements (for other clients)

If your client is not in the list above, it can still connect provided it supports:

* **OAuth 2.0 Authorization Code Flow** — used to log in with your Nexudus credentials.
* **Streamable HTTP Transport** — used by the client to send requests.
* **Tools** — the operations exposed by the server (`tools/list`, `tools/call`).

**Optional but recommended:** MCP Resources support. This lets clients fetch documentation directly without using a tool call. Support is uneven across off-the-shelf clients — the Nexudus MCP server falls back to tool-based documentation when resources are not supported.

## What happens the first time you connect

1. You add `https://mcp.nexudus.com` to your MCP client.
2. The client opens a browser window with the Nexudus login page.
3. You enter your Nexudus email and password.
4. You tick the **responsibility disclaimer** and decide whether to leave the **PII consent** box unchecked (recommended) or tick it to share real personal data with the AI assistant. See [PII redaction](/mcp/pii-redaction).
5. The client receives an access token and stores it.
6. Your AI assistant now has Nexudus tools available.

Your Nexudus password is **never stored** by the MCP server. It is used once to verify your identity, and the server keeps only a short-lived access token tied to your session.

<Tip>
  Sessions last **8 hours**. After that, your assistant will tell you the connection has expired and you can reconnect using the same steps. See
  [Sessions and re-authentication](/mcp/sessions) for details.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Pick your client" icon="plug" href="/mcp/clients/claude-ai">
    Start with Claude.ai, ChatGPT, or another supported client.
  </Card>

  <Card title="How authentication works" icon="key" href="/mcp/authentication">
    What the server does with your login.
  </Card>
</CardGroup>
