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

# Quickstart

> Get connected to the Monei MCP server in under two minutes

There are three ways to connect. Pick the one that fits your setup.

## Option 1: Hosted server (recommended)

No installation needed. Connect directly to the hosted endpoint.

```
https://mcp.monei.cc/sse
```

This is the fastest way to get started. Your MCP client connects to the server, the OAuth flow runs, you enter your Monei API key, and you are done.

<Note>
  The hosted server runs in sandbox mode by default. To use real funds, set your environment to live when self-hosting, or use your live API key when authenticating on the hosted server.
</Note>

## Option 2: Run with npx

If you prefer to run the server locally:

```bash theme={null}
MONEI_API_KEY=your_api_key npx @mrmonei/mcp-server
```

The server starts on port 3000 by default. Point your MCP client at `http://localhost:3000/sse`.

## Option 3: Install globally

```bash theme={null}
npm install -g @mrmonei/mcp-server
MONEI_API_KEY=your_api_key monei-mcp
```

## Claude Desktop setup

Add this to your Claude Desktop config file:

```json theme={null}
{
  "mcpServers": {
    "monei": {
      "command": "npx",
      "args": ["-y", "@mrmonei/mcp-server"],
      "env": {
        "MONEI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

Config file location:

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Restart Claude Desktop after saving. The Monei tools will appear in the tools panel.

## Getting your API key

1. Sign up at [monei.cc](https://monei.cc)
2. Go to Settings then API Keys
3. Generate a new key and copy it

Your API key has full access to your Monei account. Keep it private and never commit it to a public repository.

## Test the connection

Once connected, try asking your AI client:

> "What is my Monei wallet balance?"

If everything is set up correctly, you will get your NGN balance and portfolio overview back immediately.