MCP Client Setup

MCP Client Configuration

The Elemm Gateway is a universal Model Context Protocol (MCP) server. Any AI client or editor that supports MCP (such as Claude Desktop, Cursor, Cline/Roo Code, or Windsurf) can connect to it.

Since it uses the STDIO transport by default, you do not run it directly in your terminal. Instead, you configure your chosen AI client to start it in the background using the standard mcpServers JSON block.

1. Auto-Generate Configuration (Recommended)

Most MCP clients support standard configuration blocks. To connect to the Elemm Gateway, you can automatically generate the correct JSON snippet for your operating system and paths using the built-in generator tool.

Run the following command in your terminal:

elemm-gateway cfg-gen

Follow the interactive prompts. The tool will auto-detect your OS (including WSL environments), executable paths, and generate a perfectly formatted JSON block like this:

{
  "mcpServers": {
    "elemm-gateway": {
      "command": "/absolute/path/to/venv/bin/elemm-gateway",
      "args": ["--transport", "stdio"]
    }
  }
}

Copy the generated output and place it in your client's configuration file.

2. Platform-Specific Setup

Claude Desktop

Paste the generated JSON into the configuration file at the following path:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux/macOS: ~/.config/Claude/claude_desktop_config.json

Cursor

Cursor uses a graphical interface for MCP servers. Use the cfg-gen tool to generate your configuration, then extract the command and args to enter them into the UI:

1. Go to Cursor Settings -> Features -> MCP.
2. Click + Add New MCP Server.
3. Set the following details:

• Name: elemm-gateway
• Type: stdio
• Command: Paste the command from the generated JSON (e.g., /absolute/path/.../elemm-gateway or wsl.exe)
• Arguments: Paste the args array values from the generated JSON

Cline / Roo Code (VS Code)

To configure the MCP server in VS Code extensions, add the configuration schema to the respective settings file:

Cline

• macOS/Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Roo Code (formerly Roo Cline)

• macOS/Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/roo_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\roo_mcp_settings.json

3. Testing the Connection

Once the client is configured and restarted, ask your agent:

"Use Elemm to connect to https://petstore.swagger.io/v2/swagger.json and list all available pets."