Setup

Connect your AI client to the Obert MCP server — Claude, Cursor, VS Code, Windsurf, and more.

Connect your AI client to the Obert MCP server. The remote server URL is:

https://mcp.obert.io/mcp

Authentication uses OAuth 2.1 — you'll be prompted to log in with your Obert account on first use.

Claude

Claude.ai (Team / Enterprise)

Open Claude.ai and navigate to your workspace settings.
Go to the Connectors page.
Add the Obert MCP server URL: https://mcp.obert.io/mcp
Authorize with your Obert account when prompted.

Claude Desktop (Free / Pro)

Open Claude Desktop → Settings → Developer → Edit Config.
Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "obert": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.obert.io/mcp"
      ]
    }
  }
}

Restart Claude Desktop.
You'll be prompted to authenticate with your Obert account on first use.

Claude Code

Run this command in your terminal:

claude mcp add --transport http obert https://mcp.obert.io/mcp

You'll be prompted to authenticate with your Obert account on first use.

Cursor

Open Cursor Settings → MCP.
Click Add new MCP server.
Set the URL to https://mcp.obert.io/mcp.
Authenticate with your Obert account when prompted.

VS Code (Copilot)

Open your VS Code settings JSON and add:

{
  "mcp": {
    "servers": {
      "obert": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.obert.io/mcp"
        ]
      }
    }
  }
}

Open the Command Palette (Cmd+Shift+P) and run MCP: List Servers.
Select obert and click Start.
Authenticate with your Obert account when prompted.

Windsurf

Open Windsurf Settings → Cascade → MCP.
Click Add Server → Add custom server.
Add the following configuration:

{
  "mcpServers": {
    "obert": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.obert.io/mcp"
      ]
    }
  }
}

Authenticate with your Obert account when prompted.

Other clients

Any client that supports the Model Context Protocol works with Obert. Use the server URL https://mcp.obert.io/mcp and configure your client's MCP settings accordingly.

Troubleshooting

I'm getting an authentication error

Clear your cached MCP credentials and re-authenticate:

Claude Desktop / VS Code: Delete the ~/.mcp-auth directory and restart the client.
Claude Code: Run claude mcp remove obert then re-add the server.
Cursor / Windsurf: Remove and re-add the server in settings.

Are my actions scoped to my workspace?

Yes. All operations are scoped to the workspace you authenticated with. You can only access leads, campaigns, and signals within your own workspace.

On this page