Quickstart

Connecting takes one URL and one sign-in. Pick your client below.

The server URL for every client is:

https://connect.convirza.com/mcp

When your client connects for the first time it opens a Convirza sign-in page. Enter your Convirza email and password there. You are returned to your assistant, connected. Nothing else to configure.

Claude (web, desktop, mobile)

Open Settings → Customize → Connectors.

Choose Add custom connector.

Paste https://connect.convirza.com/mcp and add it.

Click Connect and sign in with your Convirza account on the page that opens.

Once connected, every new chat can use Convirza. Try: "List the users in my Convirza account."

Team and Enterprise workspaces: a workspace owner adds the connector once at the workspace level; members then just sign in.

Claude Code

Add the server, then sign in:

/mcp

The /mcp command opens the Convirza sign-in page in your browser. After signing in, return to the terminal and ask away.

To share the connection with your whole project, add it to the project's .mcp.json instead:

{
  "mcpServers": {
    "convirza": {
      "type": "http",
      "url": "https://connect.convirza.com/mcp"
    }
  }
}

ChatGPT

MCP connectors in ChatGPT are managed through developer mode.

Open Settings → Apps & Connectors → Advanced settings.

Turn on Developer mode.

Choose Create, paste https://connect.convirza.com/mcp, and select OAuth as the authentication method.

Cursor

One click: Install in Cursor

Or manually, add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "convirza": {
      "url": "https://connect.convirza.com/mcp"
    }
  }
}

Cursor opens the Convirza sign-in page on first use.

VS Code

One click: Install in VS Code

Or manually, add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "convirza": {
      "type": "http",
      "url": "https://connect.convirza.com/mcp"
    }
  }
}

Codex (CLI)

Or add it to ~/.codex/config.toml:

[mcp_servers.convirza]
url = "https://connect.convirza.com/mcp"

Codex opens the Convirza sign-in page on first use.

Any other MCP client

MCP is an open protocol. Follow your client's instructions for adding a remote MCP server, and use https://connect.convirza.com/mcp as the URL. Choose OAuth as the authentication method when asked — the Convirza server handles client registration automatically.

If your client only supports the older SSE transport, use https://connect.convirza.com/sse instead.

Verify it worked

Ask your assistant:

"What groups do I have access to in Convirza?"

You should see the organization units your account can access. If you get a permissions message instead, see Authentication & access — your Convirza role determines what the server will do.

Quickstart

Claude (web, desktop, mobile)#

Claude Code#

ChatGPT#

Cursor#

VS Code#

Codex (CLI)#

Any other MCP client#

Verify it worked#