## Connect your MCP client to the Afriex MCP server

Connect your MCP client to the Afriex MCP server at `https://mcp.afriex.com/mcp`. There are two ways to provide your API key:

- **HTTP headers**: pass your API key directly in the client config. The server stores these values for the session and uses them for all Business API calls. Recommended when your client supports custom headers.
- **`authenticate` tool**: call the `authenticate` tool as your first action after connecting. Works with all clients.

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):**With HTTP headers (recommended):**

```
{
  "mcpServers": {
    "afriex": {
      "url": "https://mcp.afriex.com/mcp",
      "headers": {
        "x-afriex-api-key": "your-api-key",
        "x-afriex-environment": "production"
      }
    }
  }
}
```

**With `authenticate` tool:**

```
{
  "mcpServers": {
    "afriex": {
      "url": "https://mcp.afriex.com/mcp"
    }
  }
}
```

Restart Claude Desktop. The Afriex tools will appear in the tools menu. Then call the `authenticate` tool:

```
{
  "apiKey": "your-api-key",
  "environment": "production"
}
```

### Claude Code

**With HTTP headers (recommended):** Add to `.claude/settings.json`:

**With `authenticate` tool:**

```
claude mcp add afriex --transport http https://mcp.afriex.com/mcp
```

Or add manually to `.claude/settings.json`:

```
{
  "mcpServers": {
    "afriex": {
      "url": "https://mcp.afriex.com/mcp"
    }
  }
}
```

Then call the `authenticate` tool:

```
{
  "apiKey": "your-api-key",
  "environment": "production"
}
```

### Cursor

**With HTTP headers (recommended):** Add to `.cursor/mcp.json` in your project root:

**With `authenticate` tool:** Go to **Cursor Settings → MCP → Add new MCP Server**, select **Type: URL**, and enter `https://mcp.afriex.com/mcp`. Or add manually to `.cursor/mcp.json`:

```
{
  "mcpServers": {
    "afriex": {
      "url": "https://mcp.afriex.com/mcp"
    }
  }
}
```

Then call the `authenticate` tool:

```
{
  "apiKey": "your-api-key",
  "environment": "production"
}
```

[MCP Server](https://docs.afriex.com/mcp/introduction)