Setup

Remote server (recommended)

Server URL:

https://mcp.obert.io/mcp

Authentication uses OAuth 2.1. On first use, log in with your Obert account and pick the workspace the client should use.

Claude.ai (Team / Enterprise)

Open workspace settings on Claude.ai.
Go to Connectors.
Add https://mcp.obert.io/mcp.
Authorize when prompted.

Claude Desktop

Settings → Developer → Edit Config.
Add to claude_desktop_config.json:

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

Restart Claude Desktop and authenticate on first use.

Claude Code

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

Cursor

Cursor Settings → MCP.
Add new MCP server with URL https://mcp.obert.io/mcp.
Authenticate when prompted.

VS Code (Copilot)

Add to settings JSON:

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

Run MCP: List Servers from the Command Palette, start obert, and sign in.

Windsurf

Windsurf Settings → Cascade → MCP → Add custom server with the same mcp-remote JSON as Claude Desktop.

Other clients

Any MCP-compatible client can use https://mcp.obert.io/mcp with OAuth or mcp-remote.

Local stdio (API key)

For development or automation on your machine:

Create a User API key in Obert.
Set environment variables:

export OBERT_API_KEY="your-key"
export OBERT_API_URL="https://api.obert.io"   # optional; defaults vary by install

Run the Obert MCP package with stdio transport (from a checkout that includes mcp_server, or your team’s published install path):

python -m mcp_server --transport stdio

Point your MCP client at that stdio command instead of the remote URL.

OAuth and API-key sessions are separate: OAuth tools never fall back to the API key identity.

Troubleshooting

Authentication errors

Claude Desktop / VS Code: Remove ~/.mcp-auth and reconnect.
Claude Code: claude mcp remove obert, then add the server again.
Cursor / Windsurf: Remove and re-add the server in settings.

Wrong workspace

All tools are scoped to the workspace you chose at login. Switch workspace in Obert or re-authenticate if you need a different tenant.

401 / session expired

Reconnect the MCP server. The client message may suggest /mcp reconnect — remove and add the server if your client supports that flow.

On this page