Connect AI Tools to Ruba

Empower your AI agents by connecting Ruba as a Model Context Protocol (MCP) server.

What exactly is MCP?

MCP is a protocol for wiring tools into AI agents. It can substantially boost what your AI agents are capable of by feeding them real-time data and context. Ruba hosts a remote MCP server that you can plug into from most AI clients.

How it operates

You need an MCP-aware agent environment to use Ruba through MCP. A couple of well-known ones are Claude Desktop and Cursor.

Linking up with Ruba MCP

Ruba provides two MCP servers:

Production: https://mcp.getruba.com/mcp/ruba - Hook into your live Ruba organization
Sandbox: https://mcp.getruba.com/mcp/ruba-sandbox - Hook into the Ruba sandbox environment for testing

When you can enter a MCP URL, pick one of the URLs above based on your environment. If you must specify a command, use:

{
  "mcpServers": {
    "Ruba": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.getruba.com/mcp/ruba"]
    }
  }
}

For sandbox:

{
  "mcpServers": {
    "Ruba Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.getruba.com/mcp/ruba-sandbox"]
    }
  }
}

Cursor

Inside .cursor/mcp.json, add:

{
  "mcpServers": {
    "Ruba": {
      "url": "https://mcp.getruba.com/mcp/ruba"
    }
  }
}

For sandbox:

{
  "mcpServers": {
    "Ruba Sandbox": {
      "url": "https://mcp.getruba.com/mcp/ruba-sandbox"
    }
  }
}

Windsurf

Inside mcp_config.json, add:

{
  "mcpServers": {
    "Ruba": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.getruba.com/mcp/ruba"]
    }
  }
}

For sandbox:

{
  "mcpServers": {
    "Ruba Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.getruba.com/mcp/ruba-sandbox"]
    }
  }
}

Codex

Append the following to your ~/.codex/config.toml:

[features]
rmcp_client = true

[mcp_servers.ruba]
type = "http"
url = "https://mcp.getruba.com/mcp/ruba"

Then run:

codex mcp login ruba

For sandbox:

[features]
rmcp_client = true

[mcp_servers.ruba_sandbox]
type = "http"
url = "https://mcp.getruba.com/mcp/ruba-sandbox"

Then run:

codex mcp login ruba_sandbox

Claude Code

Run the following command:

claude mcp add --transport http "Ruba" "https://mcp.getruba.com/mcp/ruba"

For sandbox:

claude mcp add --transport http "Ruba-Sandbox" "https://mcp.getruba.com/mcp/ruba-sandbox"

OpenCode

Inside opencode.jsonc, add:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "Ruba": {
      "type": "remote",
      "url": "https://mcp.getruba.com/mcp/ruba"
    }
  }
}

For sandbox:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "Ruba Sandbox": {
      "type": "remote",
      "url": "https://mcp.getruba.com/mcp/ruba-sandbox"
    }
  }
}

ChatGPT

MCP is currently available only to paid users in beta on ChatGPT web, by turning on Developer Mode. Once Developer Mode is active, head to Settings → Connectors and register the MCP server using https://mcp.getruba.com/mcp/ruba. For sandbox, use https://mcp.getruba.com/mcp/ruba-sandbox instead.

Claude Desktop

Head to Settings → Connectors and click Add custom connector. Name it “Ruba” and supply https://mcp.getruba.com/mcp/ruba as the server URL. For sandbox, use https://mcp.getruba.com/mcp/ruba-sandbox as the server URL instead. Save, then click Connect to link up with your Ruba organization.

Launch Path

Shape the Offer

Run the Revenue Model

Deliver Customer Access

Build the Integration

Operate the Business

Implementation Playbooks

Connect AI Tools to Ruba

What exactly is MCP?

How it operates

Linking up with Ruba MCP

Cursor

Windsurf

Codex

Claude Code

OpenCode

ChatGPT

Claude Desktop

​What exactly is MCP?

​How it operates

​Linking up with Ruba MCP

​Cursor

​Windsurf

​Codex

​Claude Code

​OpenCode

​ChatGPT

​Claude Desktop

What exactly is MCP?

How it operates

Linking up with Ruba MCP

Cursor

Windsurf

Codex

Claude Code

OpenCode

ChatGPT

Claude Desktop