Skip to content
nuez docs

Claude Desktop

Config file location

Section titled “Config file location”
~/Library/Application Support/Claude/claude_desktop_config.json
Section titled “Configuration (OAuth, recommended)”
{
  "mcpServers": {
    "nuez": {
      "type": "http",
      "url": "https://sandbox-mcp.nuez.app/mcp"
    }
  }
}

No headers field, no API key to paste. On first use, Claude Desktop follows the server’s OAuth discovery and opens a browser for you to log in — same account you use for the dashboard.

Configuration (API key)

Section titled “Configuration (API key)”

If you’d rather authenticate with an API key (e.g. for a shared/headless install where an interactive browser login isn’t practical):

{
  "mcpServers": {
    "nuez": {
      "type": "http",
      "url": "https://sandbox-mcp.nuez.app/mcp",
      "headers": {
        "Authorization": "Bearer nz_YOUR_KEY_HERE"
      }
    }
  }
}

Replace nz_YOUR_KEY_HERE with an API key from POST /v1/api-keys (or the default_api_key returned when you signed up — see Quickstart).

After saving either config, restart Claude Desktop. You’ll see a 🔧 icon in the chat interface when tools are available.

Verifying the connection

Section titled “Verifying the connection”

Start a new conversation and ask:

“What nuez tools do you have available?”

Claude should list tools like get_balance, get_cvu, and request_payout — the full set depends on which features (cards, bills, crypto) are enabled server-side. See Available tools.

Example prompts

Section titled “Example prompts”
Check my nuez balance
Send $1000 ARS to CBU 0000003100010000123456
Show me my last 10 payouts and their status
What are my current payout thresholds?