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

# NetSuite

**Requirements**: NetSuite administrator access to install a SuiteApp and create an integration record.

***

### Enable required features

> [!NOTE]
>
> [Required Features and Permissions](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714080625.html)

Go to **Setup  Company  Enable Features  SuiteCloud** tab and make sure the following are enabled:

* **Server SuiteScript**
* **REST Web Services**
* **Token-Based Authentication**
* **OAuth 2.0**

***

### 2. Install the MCP Standard Tools SuiteApp

> [!NOTE]
>
> [Installing the MCP Standard Tools SuiteApp](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0902023450.html)

Go to **Customization  SuiteBundler  Search & Install Bundles**, search for **MCP Standard Tools** and click **Install**.

***

### 3. Create a custom role

> [!NOTE]
>
> [Required Features and Permissions – Roles](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714080625.html)

> [!WARNING]
>
> **Important**: the Administrator role cannot be used with MCP. You must create a dedicated role.

Go to **Setup  Users/Roles  Manage Roles  New** and add the following permissions:

| Tab | Permission | Level |
| - | - | - |
| Setup | MCP Server Connection | Full |
| Setup | Log in using OAuth 2.0 Access Tokens | Full |
| Setup | REST Web Services | Full |
| Lists | Perform Search | Full |

Assign this role to the relevant users via **Setup  Users/Roles  Manage Users**.

***

### 4. Create an integration record

> [!NOTE]
>
> [Connect to the NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714082142.html)
>
> [SuiteAnswers – Integration Setup](https://suiteanswers.custhelp.com/app/answers/detail/a_id/1025062)

Go to **Setup  Integration  Manage Integrations  New** and configure:

* **Name**: `Ruby Connector` (or any name)
* **State**: Enabled

Under **Authentication**, check:

* **Authorization Code Grant**

* **Public Client**

* Add the two redirect URLs for your Ruby region:

  **US workspaces:**

  ```
  https://app.ruby.ad/oauth/mcp_static/finalize
  https://app.ruby.ad/oauth/mcp_static/finalize
  ```

  **EU workspaces:**

  ```
  https://app.ruby.ad/oauth/mcp_static/finalize
  https://app.ruby.ad/oauth/mcp_static/finalize
  ```

* **Dynamic Client Registration**

* Dynamic Client Registration Client Name: "**Ruby**"

* Scope: **NetSuite AI Connector Service**

Click **Save** and copy the **Consumer Key / Client ID** immediately (it won't be shown again after leaving the page).

You app should be set-up as following:

***

## 5. Connect in Ruby

> [!NOTE]
>
> [Get Started with the NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html)
>
> [OAuth 2.0 Authorization Endpoint](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_158081944642.html)
>
> [OAuth 2.0 Token Endpoint](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_158081952044.html)

In Ruby, go to **Spaces  Tools   Add tools  Add MCP server  Static OAuth**.

**Server URL**:

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

Replace `<accountid>` with your NetSuite account ID (visible in your NetSuite URL, e.g. `td3485262`).

**Authentication**: OAuth, then fill in:

| Field | Value |
| - | - |
| Client ID | Your Consumer Key from step 4 (without the ID prefix) |
| Client Secret | Your Consumer Secret from step 4 |
| Authorization URL | `https://<accountid>.app.netsuite.com/app/login/oauth2/authorize.nl` |
| Token URL | `https://<accountid>.suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token` |
| Scope | `mcp` |

Replace `<accountid>` with your NetSuite account ID.

> [!WARNING]
>
> **Important**: copy the Client ID exactly as shown. Do not include any prefix such as `ID`.

Save, authenticate with your NetSuite account using your custom MCP role, and the tools will appear.

***

### Troubleshooting

> [!NOTE]
>
> **[NetSuite AI Connector Service FAQ](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_4160616848.html)**

| Error | Fix |
| - | - |
| **"Invalid login attempt"** on the consent page | Make sure you select your custom MCP role (not Administrator) during login. |
| **"MCP Server Connection" permission not visible** | The MCP Standard Tools SuiteApp is not installed (step 2). |
| **"Wrong role or account"** | Click "Choose another role" and select the custom role created in step 3. |
| Client ID rejected / invalid application | You likely added an `ID` prefix to the Consumer Key. Use only the hex string. |
| Redirect URI mismatch | Make sure the regional and global `/mcp_static/finalize` URIs for your workspace are added. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.