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.