Skip to main content

Configure NetSuite for the AI Gateway

To allow your users to securely access NetSuite tools using their AI clients, you can configure the NetSuite AI Connector Service as a Model Context Protocol (MCP) server within the JumpCloud AI Gateway.

Prerequisites:

  • Before configuring specific enterprise applications, we recommend reviewing the Get Started: AI Gateway guide to familiarize yourself with the gateway architecture and core AI concepts (such as MCP servers and AI clients).

  • NetSuite Administrator access to complete the initial setup.

Completing Application Setup​

Before you can add the server in JumpCloud, prepare NetSuite so the AI Connector Service can authenticate and expose tools. See Oracle’s NetSuite AI Connector Service overview and Get Started with the NetSuite AI Connector Service to learn more.

Enabling SuiteCloud Features​

In NetSuite, go to Setup > Company > Enable Features > SuiteCloud and enable:

  • Server SuiteScript
  • REST Web Services
  • OAuth 2.0 (under Manage Authentication)

Installing the MCP Standard Tools SuiteApp​

From the SuiteApp Marketplace, search for MCP Standard Tools and install it. Tool definitions register with the AI Connector Service automatically. See Oracle’s MCP Standard Tools SuiteApp to learn more.

Creating a Dedicated MCP Role​

Create a non-admin role with at least these permissions:

PermissionLevel
MCP Server ConnectionFull
Log in using OAuth 2.0 Access TokensFull
REST Web ServicesFull

Add record-level permissions for the NetSuite data your users need agents to access.

note

NetSuite blocks the Administrator role from connecting to the AI Connector Service. Assign the MCP role to each user’s employee record. During OAuth consent, users with multiple roles must select the MCP role.

Creating the OAuth 2.0 Integration Record​

  1. Go to Setup > Integration > Manage Integrations > New.
  2. Set State to Enabled.
  3. On the Authentication subtab under OAuth 2.0, select Authorization Code Grant.
  4. Add the JumpCloud AI Gateway redirect URL for your region:
  • US: https://console.jumpcloud.com/userconsole/mcp/servers/callback
  • EU: https://console.eu.jumpcloud.com/userconsole/mcp/servers/callback
  • IN: https://console.in.jumpcloud.com/userconsole/mcp/servers/callback
  1. Under Scope, select NetSuite AI Connector Service.
  2. Save the record, then copy the Client ID and Client Secret immediately. NetSuite shows the secret only once.
note

NetSuite refresh tokens expire after seven days. See Oracle’s OAuth token endpoint documentation to learn more.

See Oracle’s Create Integration Records for Applications to Use OAuth 2.0 and Connect to the NetSuite AI Connector Service to learn more.

note

If an integration record was auto-created by the SuiteApp without the NetSuite AI Connector Service scope, recreate it manually with the settings above.

Choosing the MCP Server URL​

Replace <accountid> with your NetSuite account ID, which you can find under Setup > Company > Company Information.

  • All available custom tools: https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
  • MCP Standard Tools SuiteApp only: https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools

Configuring the Server in JumpCloud​

See Adding MCP Servers in Configure AI Gateway Integrations and use the following values to configure this server:

  • App: Select NetSuite if the application already exists in JumpCloud. Otherwise, click + New App to open the Create New Application Integration wizard, select a prebuilt connector if available or Custom Application, then select the Manage MCP Servers checkbox. See Creating an Application from the AI Gateway to learn more.

If you created a new application, return to the Add Server modal and select it from the App drop-down before completing the remaining fields.

  • Name: Enter a name, for example NetSuite MCP.
  • Prefix: Enter a value to prepend to MCP tool names.
    • Note: Prefixes must be unique. Maximum 8 characters, letters and numbers only.
  • URL: Enter the NetSuite MCP endpoint from Choosing the MCP Server URL.
  • MCP authentication method: Select OAuth.
  • Advanced fields: Enter the Client ID and Client Secret from the NetSuite integration record.

Your users see NetSuite listed as an available application when they authenticate their AI clients through the JumpCloud AI Gateway.

Was this information helpful?