Connecting MCP Clients - Afriex Business API

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": "development"
      }
    }
  }
}

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": "development"
}

Claude Code

With HTTP headers (recommended):Add the server from your terminal. The key is stored in your local Claude Code config, not in the project:

claude mcp add --transport http afriex https://mcp.afriex.com/mcp \
  --header "x-afriex-api-key: your-api-key" \
  --header "x-afriex-environment: development"

To share the server with your team, add it to .mcp.json in your project root instead, and read the key from an environment variable so it never lands in the repository:

{
  "mcpServers": {
    "afriex": {
      "type": "http",
      "url": "https://mcp.afriex.com/mcp",
      "headers": {
        "x-afriex-api-key": "${AFRIEX_API_KEY}",
        "x-afriex-environment": "development"
      }
    }
  }
}

With authenticate tool:

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

Then call the authenticate tool:

{
  "apiKey": "your-api-key",
  "environment": "development"
}

Cursor

With HTTP headers (recommended):Add to ~/.cursor/mcp.json, your global Cursor config. Avoid .cursor/mcp.json in your project root for this, because that file is usually committed with the project.

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

With authenticate tool:Go to Cursor Settings → MCP → Add new MCP Server, select Type: URL, and enter https://mcp.afriex.com/mcp.Or add it to .cursor/mcp.json in your project root. With no key in it, this file is safe to commit:

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

Then call the authenticate tool:

{
  "apiKey": "your-api-key",
  "environment": "development"
}