Learn how to register and connect the Zuora MCP server in Claude Code using an OAuth 2.0 client so you can run MCP commands against your Zuora tenant.

1. To register the MCP server, run the following command in your command line. Do not run this command inside Claude Code.

   
   claude mcp add-json zuora-remote-server '{"type":"http","url":"${mcpEndpoint}","oauth":{"clientId":"${clientId}","callbackPort":8088}}' --client-secret
           

2. Provide the required configuration values.
   Replace the placeholders with your values:

   • url: The tenant-specific MCP endpoint.
   • clientId: The OAuth client ID created in OneID.
   • callbackPort: The port configured in the OneID redirect URI (for example, http://localhost:8088/callback).

   When prompted, enter the Client Secret securely in the terminal.

3. Verify that the MCP server is registered.
   Run the following command:

   
   claude mcp list
           

   Confirm that the Zuora MCP server appears in the list. The status might display as Needs Authentication.

4. Start Claude Code and authenticate the MCP server. In Claude Code, run /mcp to list the configured MCP servers. If the Zuora MCP server is marked as Needs Authentication, select the server and choose Authentication.
5. Claude opens a browser window to complete the OneID login and consent flow. Select the tenant that you want to use and submit consent.

   After authentication:

   • The browser displays an Authentication Successful message.
   • Claude Code updates the MCP server status to Connected.