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

# Set up NetSuite MCP Server

> Enable NetSuite AI Connector Service and connect NetSuite MCP tools to TrueFoundry with per-user OAuth.

NetSuite AI Connector Service exposes ERP records, transactions, reports, and SuiteApp tools through MCP. Configure NetSuite features, roles, and OAuth before registering the server in TrueFoundry.

## Prerequisites

* A TrueFoundry account with permission to add MCP servers.
* NetSuite Administrator access.
* Server SuiteScript, REST Web Services, and OAuth 2.0 enabled.

## Prepare NetSuite

Enable **Server SuiteScript**, **REST Web Services**, and **OAuth 2.0** under **Setup** > **Company** > **Enable Features**. Install the **MCP Standard Tools** SuiteApp from the SuiteApp Marketplace.

Create a non-admin role for MCP users with these permissions:

| Permission              | Level |
| ----------------------- | ----- |
| MCP Server Connection   | Full  |
| OAuth 2.0 Access Tokens | Full  |
| REST Web Services       | Full  |

Add record-level permissions for the NetSuite data your agents need.

## Create an OAuth Integration

Create an integration record under **Setup** > **Integration** > **Manage Integrations**. Enable Authorization Code Grant, use a public client if NetSuite requires it for the AI Connector Service, select the **NetSuite AI Connector Service** scope, and set the redirect URI to:

```txt theme={"dark"}
https://<tfy-control-plane-base-url>/api/svc/v1/llm-gateway/mcp-servers/oauth2/callback
```

Copy the Client ID when NetSuite displays it.

## Register in TrueFoundry

Use one of these URLs:

```txt theme={"dark"}
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
```

```txt theme={"dark"}
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
```

Add the URL as a remote OAuth2 MCP server in TrueFoundry, paste the NetSuite Client ID, add collaborators, and save the server. Users should open the server's **Tools** section and click **Connect Now**; after OAuth succeeds, NetSuite tools appear and can be tried from the **Agent Playground**.

## Security Notes

The Administrator role cannot use the AI Connector Service. Assign a dedicated MCP role and expose only the NetSuite record permissions agents need.
