Connect to NetSuite AI Connector Service

Important:

Before connecting to the NetSuite AI Connector Service, it's important to familiarize yourself with Associated Risks, Controls, and Mitigation Strategies when working with AI clients and LLMs.

This section explains how to connect to the NetSuite AI Connector Service using Claude or ChatGPT.

For other AI agents, you must adjust the instructions accordingly, and before you connect you must read and familiarize yourself with the NetSuite AI Connector Service-specific Integration Record.

Connect using Claude (MCP Standard Tools SuiteApp)

Go to claude.ai in your browser and login to your Claude account.
Go to Search and tools > Add connectors.
In the Connectors section under the Web tab select the NetSuite AI connector.
Click Connect
Paste the Server URL below with the account ID of your account:

https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
Click Continue
Go to Search and tools > Manage connectors.
Under Your connectors, go to NetSuite and click Connect.
On the first connection, you're prompted to allow or deny access to your NetSuite account. Make sure you review Associated Risks, Controls, and Mitigation Strategies before proceeding. After you allow access, on subsequent connections you're informed that Claude already has access and you're asked to go back or continue. If connected successfully, a popup message appears.

Connect using Claude (Custom Tools)

Open a browser window and log in to your NetSuite account.
Open a new tab in your browser and go to claude.ai.
Log in to your Claude account.
In Claude, go to Settings > Connectors.
In the Connectors section, click Add custom connector.
Enter the name of your connector and your remote NetSuite AI Connector Service URL. To learn where to obtain this URL, see Server URL and SuiteApp Namespacing.
Click Add. Your custom NetSuite connector is visible in the list of connectors.
Click Connect.

On the first connection, you're prompted to allow or deny access to your NetSuite account. Make sure you review Associated Risks, Controls, and Mitigation Strategies before proceeding. After you allow access, on subsequent connections you're informed that Claude already has access and you're asked to go back or continue. If connected successfully, a popup message appears.
You can now see your connector in Claude by clicking the Search and tools icon on your new chat page. You can disable this functionality by removing the MCP Server Connection permission.

Connect using ChatGPT

With ChatGPT you can use the MCP Standard tools SuiteApp, but you must first enable the Developer mode. Before enabling Developer mode, review the Associated Risks, Controls, and Mitigation Strategies topic, as well as any OpenAI documentation about risks and safety of the MCP and the Developer mode. If you're confident to proceed, go to Setting > Connectors > Advanced > Developer mode.
Open a browser window and log in to your NetSuite account.
Open a new tab in your browser and go to chatgpt.com.
Log in to your ChatGPT account.
Go to the Connectors section
- In ChatGPT Business, go to Workspace > Connectors.
- In ChatGPT Plus or Pro, go to Settings > Connectors.
Go to Create a connector.
Enter the name of your connector, a description, your remote NetSuite AI Connector Service URL, and the Authentication method. For the remote NetSuite AI Connector Service URL, see Server URL and SuiteApp Namespacing.
Check the I trust this application box.
Go to Create. Your custom NetSuite connector is visible in the list of connectors.
Start a new chat, go to the Plus menu and select Developer mode and then select your NetSuite connector.
If you receive an error message, you must press the refresh button on your AI client.

Important:

In case you are disconnected during working with your AI client, open your AI client in a new browser window and start a new chat. If this doesn't fix your connection, go to the Connectors section, disconnect and create a new connection.

NetSuite AI Connector Service-specific Integration Record

An integration record is automatically installed in your account after the first connection with Claude. After the installation, users with the Administrator role and all other users with appropriate permissions can view the record by going to Setup > Integration > Manage Integrations. This record is enabled automatically regardless of account settings. This record differs from other integration records in the following ways:

The name of the integration is populated.
The Public Client box is checked.
The Redirect URI field is populated.
The Authorization Code Grant box is checked.
The NetSuite AI Connector Service scope is enabled.
The State and Concurrency Limit fields are editable, which means you can disable the integration record, or allocate part of your total concurrency limit to it.

If you're using a different AI client, other that Claude or ChatGPT, you must confirm the following:

If you have installed a SuiteApp, go to your Integrations page in NetSuite, and confirm whether a new Integration record has been created during the SuiteApp installation.
- If not, you must create one manually.
- If an integration record has been created, and the NetSuite AI Connector Service scope is enabled, the integration record is initially in a pending state. An administrator must manually enable the integration record by accessing it directly. When enabled, the integration record can't revert to the pending state; it can only be disabled if needed.
- If an integration record has been created, but the NetSuite AI Connector Service scope isn't enabled, you must recreate the integration record.
If you have not installed a SuiteApp, you need to build your own MCP tools and manually create the Integration record.

For more information, see also Creating Custom Tools for the NetSuite AI Connector Service and Create Integration Records for Applications to Use OAuth 2.0.

Server URL and SuiteApp Namespacing

To establish a connection, you need a remote NetSuite AI Connector Service URL. This URL is unique to your NetSuite account and an Administrator can provide you with this URL.

Depending on your use case, your URL uses one of the following formats:

https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<applicationid> – Returns only the custom tools exposed by the specified SuiteApp.

For example, the URL for the MCP Standard Tools SuiteApp is: https://<accountid>.suitetalk.api.NetSuite.com/services/mcp/v1/suiteapp/com.NetSuite.mcpstandardtools

Where you must replace <accountid> with the ID of your account.

The structure of <applicationid> is: <publisherid>.<projectid> where <publisherid> could be, for example, "com.netsuite", and <projectid>, for instance, "mcpstandardtools".
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all – Returns all available custom tools in the account from both SuiteApps and account customization projects (ACPs). Replace <accountid> with your real account ID, for example "TD12345678".

To learn more about URLs used for different types of accounts, see URLs for Account-Specific Domains.

General Notices