Skip to content

RingEx Chat Setup

Server URL: https://mcp.labs.ringcentral.com/ringex/team-chat

Custom connectors live under Customize > Connectors (Claude.ai) or Settings → Connectors (Claude Desktop) — not through claude_desktop_config.json, which only supports local stdio servers.

  1. Sign in to claude.ai, or open Claude Desktop.
  2. Pro/Max: go to Customize > Connectors → click + → Add custom connector. Team/Enterprise: an Owner first adds it under Organization settings > Connectors → Add → hover Custom → select Web; members then connect individually via Customize > Connectors.
  3. Enter a name (e.g. RingEx Chat) and the URL above, then click Add.
  4. Complete the RingCentral OAuth flow: sign in with your RingCentral account and authorize the integration.
  5. In a new conversation, click the + button (lower left of the chat box) → Connectors, and toggle RingEx Chat on.
  6. Verify: ask "List my team messaging chats."

ChatGPT calls this an App (renamed from "Connector" in December 2025). Connecting a server that can call tools — not just read/fetch — requires Developer Mode.

  1. Business/Enterprise/Edu workspaces: a workspace admin enables Developer Mode via Workspace Settings → Permissions & Roles → Connected Data. Individual Enterprise/Edu accounts, or Pro (read/fetch-only): go to Settings → Apps → Advanced Settings and toggle Developer mode on.
  2. In Settings → Apps, click Create, enter the URL above as the MCP Server URL, name it (e.g. RingEx Chat), click Scan Tools, then Save.
  3. Complete the RingCentral OAuth flow when prompted.
  4. Open a new chat, click the + icon or tools menu, and select RingEx Chat — or mention it by name in your prompt.
  5. Verify: ask "List my team messaging chats."

Pro users

With read/fetch-only Developer Mode, you can read chats and posts but can't post messages or create conversations.

  1. Open the Codex app → click the Settings gear (bottom left) → MCP Servers → Add server.
  2. Enter a name (e.g. RingEx Chat), set Type to Streamable HTTP, and enter the URL above.
  3. Click Save, then select Restart so Codex picks up the new server.
  4. Authenticate with your RingCentral account in the browser window that opens.
  5. Codex has no connector picker — mention "RingCentral" explicitly in your prompt, e.g. "Using RingCentral, list my team messaging chats."

Troubleshooting

Tools not appearing after connecting

  • Confirm the URL has no trailing slash.
  • Disconnect and reconnect the server from your client's connector/app settings.
  • Check that your network allows outbound HTTPS to *.ringcentral.com and *.labs.ringcentral.com.

Authentication errors

  • Remove the connector/app and re-add it to restart the OAuth flow.
  • Ensure your RingCentral account has the necessary API permissions.

← Back to RingEx Chat