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

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 Pro 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 will be 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

Make sure you have the correct tools.
- If you have ChatGPT Business: Build your tools. ChatGPT Business supports only fetch and search tools, that are not included in the MCP Standard Tools SuiteApp, and you must build them yourself. For more information, see Creating Custom Tools for the NetSuite AI Connector Service.
- If you have ChatGPT Plus or Pro, you can use the MCP Standard tools SuiteApp, but you must first enable the Developer mode in ChatGPT. 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 will be visible in the list of connectors.
Start a new chat and go to the Plus menu.
- If you're using your own fetch and search MCP tools, select Use connectors, expand the Add sources dropdown list, and select your connector.
- If you're using he MCP Standard Tools SuiteApp, 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 will initially be 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/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".
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/<applicationid> – Returns only the custom tools exposed by the specified SuiteApp. The structure of <applicationid> is: <publisherid>.<projectid> where <publisherid> could be, for example, "com.netsuite", and <projectid>, for instance, "mcpsampletools".

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

General Notices