> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spojit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the NetSuite MCP server

> Connect Oracle's NetSuite AI Connector Service (MCP) to Spojit: required features, role permissions, the account-specific server URL, and sign-in.

The **NetSuite AI Connector Service** is Oracle's hosted MCP server for NetSuite. Connect it to Spojit and your workflows can use the MCP tools installed in your account, such as the record and SuiteQL tools from the **MCP Standard Tools** SuiteApp, plus any custom tools your team has built.

<Note>
  Spojit connects to this server through a [custom MCP server](/connectors/remote-mcp-servers/custom) connection, so you add it with **Add custom server** rather than from the connector catalog. Oracle maintains the server; its tools come from Oracle and the SuiteApps installed in your account. See [Oracle's NetSuite AI Connector Service documentation](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_7200233106.html) for details.
</Note>

<Tip>
  Prefer curated record tools? The built-in [NetSuite connector](/connectors/integrations/netsuite) works with SuiteTalk REST directly. Use this MCP server when you want the tools Oracle and your SuiteApps publish.
</Tip>

## Before you start

A NetSuite administrator prepares the account once.

<Steps>
  <Step title="Enable the required features">
    Go to **Setup > Company > Enable Features**, open the **SuiteCloud** subtab, and enable **Server SuiteScript** and **OAuth 2.0**. To use the MCP Standard Tools SuiteApp, also enable **REST Web Services**.
  </Step>

  <Step title="Install the MCP Standard Tools SuiteApp (optional)">
    Open the **SuiteApps** tab, search for **MCP Standard Tools**, and click **Install**. See [Installing the MCP Standard Tools SuiteApp](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0902023450.html).
  </Step>

  <Step title="Prepare a non-administrator role">
    Go to **Setup > Users/Roles > Manage Roles** and edit the role the connection will sign in with. Under **Permissions > Setup**, add **MCP Server Connection** and **Log in using OAuth 2.0 Access Tokens** (not "Log in using Access Tokens"). For the Standard Tools SuiteApp, also add **REST Web Services** plus the record permissions your workflows need.
  </Step>
</Steps>

<Warning>
  The AI Connector Service does not run for the **Administrator** role or any role with full access. Create a dedicated role with only the permissions your workflows need.
</Warning>

## Server URL

The URL is unique to your NetSuite account. Replace `<accountid>` with your account ID as it appears in your other SuiteTalk URLs: lowercase, with any underscore replaced by a hyphen (a sandbox account `1234567_SB1` becomes `1234567-sb1`).

To use every tool installed in the account:

```
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
```

To use only the MCP Standard Tools SuiteApp:

```
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
```

## Connect in Spojit

<Steps>
  <Step title="Add a custom server">
    Go to **Connections** and click **Add custom server**. Enter a **Name** such as `NetSuite` and paste your **Server URL**.
  </Step>

  <Step title="Keep Auto authentication">
    Leave **Authentication** on **Auto**, choose a visibility, and click **Save & connect**. You don't need to create an integration record first; NetSuite sets it up the first time you connect.
  </Step>

  <Step title="Sign in with the prepared role">
    NetSuite opens its sign-in page. Sign in, select the **non-administrator role** you prepared, and approve access. Spojit marks the connection **Connected** and refreshes the token automatically.
  </Step>
</Steps>

## Use it in a workflow

Add a **Connector** node, pick your NetSuite server under **Custom Servers**, and choose **Agent Mode** or **Direct Mode**. See [Use a custom server in a workflow](/connectors/remote-mcp-servers/custom#use-a-custom-server-in-a-workflow).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Sign-in fails or no role can be selected">
    Confirm the role has **MCP Server Connection** and **Log in using OAuth 2.0 Access Tokens**, and that it is not the Administrator role. Also confirm **OAuth 2.0** is enabled under **SuiteCloud** features.
  </Accordion>

  <Accordion title="No tools appear">
    The `/all` URL only lists tools installed in the account. Install the MCP Standard Tools SuiteApp or a custom tools SuiteApp, then re-save the connection to refresh the tool list.
  </Accordion>

  <Accordion title="Tool calls fail with permission errors">
    Tools run with the permissions of the role you signed in with. Add the record permissions (and **REST Web Services** for the Standard Tools SuiteApp) to that role.
  </Accordion>
</AccordionGroup>

<Warning>
  Oracle notes the AI Connector Service is not HIPAA-assessed. Do not use it for electronic protected health information unless you have confirmed your own compliance.
</Warning>

## Learn more

* [NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_7200233106.html)
* [Required Features and Permissions](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714080625.html)
* [Connect to the NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714082142.html)

<Snippet file="start-free.mdx" />