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 agents and LLMs.

This section explains how to connect to the NetSuite AI Connector Service using Claude, the only AI agent that is currently supported:

1. Open a browser window and log in to your NetSuite account.

2. Open a new tab in your browser and go to claude.ai.

3. Log in to your Claude Pro account.

4. In Claude, go to Settings > Connectors.

5. In the Connectors section, click Add custom connector.

6. 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.

7. Click Add. Your custom NetSuite connector will be visible in the list of connectors.

8. 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.

Important:

In case you are disconnected during working with Claude, open Claude in a new browser window and start a new chat. If this doesn't fix your connection, go to the Connectors section, click 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 (because the NetSuite AI Connector Service is only for public clients).

• The Redirect URI field is populated.

• The Authorization Code Grant box is checked.

• All scope boxes are cleared.

• All other boxes and fields on the page are dimmed.

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 format

• 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/<appid> – Returns only the custom tools exposed by the specified SuiteApp. The structure of <appid> is: <vendor_prefix>.<project_name> where <vendor_prefix> could be, for example, "com.netsuite", and <project_name>, for instance, "mcpsampletools".

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

General Notices