Connecting MCP Clients - Afriex Business API

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