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

# Getting started

> Connect your first MCP client to Noux — OAuth for Claude Desktop, Bearer tokens for Cursor.

<Note>
  **Claude Desktop users:** skip to [Claude Desktop setup](/mcp/clients/claude-desktop) — Connectors + OAuth, no token required.

  **Cursor and automation:** follow the steps below to create a personal Bearer token.
</Note>

## 1. Open MCP settings in Noux (Cursor / automation)

Sign in to [noux.app](https://noux.app) and go to **Integrations → MCP**.

You will see your organization's **MCP URL** and controls to create **personal MCP tokens** (read-only by default in the UI).

Production MCP URL:

```
https://mcp.noux.app/mcp
```

## 2. Create a personal MCP token (Cursor / automation)

1. Click **Create personal read token** (read-only) or create a token with write scope when your organization enables it.
2. Copy the token immediately — it is shown only once.
3. Store it securely (password manager or your client's secret storage).

<Note>
  Each token is personal. It acts as you in your organization, and only you can see or revoke tokens you created. Tokens with the `mcp:write` scope can call write tools — see the [tool reference](/mcp/tools#write-tools).
</Note>

If you lose the token, revoke it and create a new one.

## 3. Note your MCP URL

Use `https://mcp.noux.app/mcp` in production, or the URL shown in **Integrations → MCP** if your environment differs.

## 4. Configure your MCP client

Choose the setup that matches your client:

| Client               | Auth method                        | Guide                                         |
| -------------------- | ---------------------------------- | --------------------------------------------- |
| **Claude Desktop**   | OAuth via Connectors (recommended) | [Claude Desktop](/mcp/clients/claude-desktop) |
| **Cursor**           | Personal Bearer token              | [Cursor](/mcp/clients/cursor)                 |
| **Other automation** | Personal Bearer token              | URL + `Authorization: Bearer <token>` header  |

**Claude Desktop** — use **Customize → Connectors → Add custom connector** with URL `https://mcp.noux.app/mcp`, then **Connect** and sign in to Noux. No manual token required.

**Cursor and scripts** — use your MCP URL from step 3 and header `Authorization: Bearer <token-from-step-2>`.

## 5. Verify the connection

Ask your client to call the `get_info` tool, or invoke it from a client that lists tools.

A successful response includes:

* `organizationId` — your Noux organization
* `userId` — your user id (the token acts as you)
* `mcpVersion` — current MCP API version
* `capabilities` — includes `read_only`; includes `write` when your token has write scope

## Troubleshooting

| Issue               | What to check                                                                                                                                       |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized`  | Token copied correctly; `Bearer ` prefix in the header                                                                                              |
| Connection refused  | MCP URL matches the app exactly, including `/mcp`                                                                                                   |
| Empty or wrong data | Token is yours — data is scoped to your organization as your user                                                                                   |
| Tool not found      | Client supports Streamable HTTP MCP; restart the client after config changes. Write tools require `mcp:write` scope — check `get_info` capabilities |

## Revoking access

In **Integrations → MCP**, revoke any token you no longer need. Revocation is immediate.

## Next steps

Browse the [tool reference](/mcp/tools) for available tools and pagination patterns.