Create Private Connection from OpenCode

This page explains how to register OpenCode as an OAuth client in Pricefx and configure an authenticated MCP connection in OpenCode.

Prerequisites

• OpenCode CLI

OAuth Client ID Registration

To use OAuth, each client must be registered with a specific client_id. This configuration is defined through the oauthConfiguration Advanced Configuration Option. Multiple clients can be registered within this setting.

1. Login to your Pricefx partition.

2. Go to Administration > Configuration > System Configuration > Advanced Configuration Options.

3. Click Add.

4. In the Add Option menu:

   1. Enter oauthConfiguration into Name.

   2. Enter the following JSON code into Value.

      1. Replace the <client_id> with a name of your choosing, usually open-code.

      2. Replace the <port_number> with a port of your choosing, usually 3334.

         JSON

         {
           "knownClients": {
             "<client_id>": {
               "redirect_uri": "http://127.0.0.1:<port_number>/mcp/oauth/callback"
             }
           }
         }
         

5. Click Add.

MCP Connection

1. Open your terminal.

2. Type the following command to start a helper process which will guide you through install

   Bash

   opencode mcp add
   

   Review the following table before selecting wizard options.

3. If you would like to configure a custom callback port, see the JSON example below to customize. (Optional)

4. Type the following command into your terminal to authenticate.

   Bash

   opencode mcp auth <server_name>
   

MCP JSON

If you would like to directly add the MCP server via JSON configuration instead of the terminal command above, you can use the below example reference. Make sure to replace the same <variables> as above.

Note, the callbackPort field can be omitted entirely if you do not wish to customize.

"<server_name>": {
  "type": "remote",
  "url": "https://mcp.pricefx.com/mcp/<cluster_host>/<partition>",
  "oauth": {
    "clientId": "<client_id>",
    "callbackPort": <port_number>
  }
}