Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dema.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Once NetSuite is connected, the Dema Agent can query ERP data and records exposed by the NetSuite AI Connector Service. Use it to answer questions about orders, inventory, financials, and other NetSuite records during a conversation.

​
Prerequisites

  • A NetSuite account with the AI Connector Service and OAuth 2.0 features enabled (Setup → Company → Enable Features → SuiteCloud).
  • A role with permission to create and manage Integration records (typically Administrator).
  • Your NetSuite Account ID. You can find it in NetSuite under Setup → Company → Company Information. Sandbox account IDs use a hyphen in URLs (for example 123456_SB1 becomes 123456-sb1).
NetSuite requires you to create your own OAuth integration record and paste its credentials into Dema. You only need to do this once per NetSuite account.

​
Connect NetSuite

1

Create an integration record in NetSuite

  • In NetSuite, go to Setup → Integration → Manage Integrations → New.
  • Give the integration a recognizable name, for example Dema Agent.
  • Set State to Enabled.
  • Under Authentication, enable OAuth 2.0 and disable any other authentication methods you do not need.
  • In Redirect URI, enter https://app.dema.ai/agents/oauth/callback exactly.
  • Under Scope, select MCP. If MCP is not available, confirm that the AI Connector Service feature is enabled for your account.
  • Save the integration.
2

Copy the client ID and client secret

NetSuite shows the Consumer Key / Client ID and Consumer Secret / Client Secret only once, immediately after saving. Copy both values now. If you lose the secret you must reset it from the integration record (which generates a new one) and reconnect in Dema.
3

Paste the credentials into Dema

In Dema, go to Agents → Settings → Integrations, find NetSuite, and click Connect. Enter:
  • Client ID from the previous step
  • Client secret from the previous step
  • MCP URL in the form https://{accountId}.suitetalk.api.netsuite.com/services/mcp/v1/all, replacing {accountId} with your NetSuite Account ID (lowercase, sandboxes use a hyphen, e.g. 123456-sb1)
Click Add. Sign in to NetSuite and approve the authorization. You are returned to Dema with the integration marked as Active.

​
Scopes Dema requests

ScopeWhat it allows
mcpAccess records and actions exposed by the NetSuite AI Connector Service
The session runs with the role you sign in with during the approval step, so the agent only sees data that role can already access. Grant the authorizing user a role scoped to the records the agent should be able to read or update.

​
Troubleshooting

  • Dema says the URL is invalid. The MCP URL must be https://{accountId}.suitetalk.api.netsuite.com/services/mcp/v1/all. Make sure you replaced {accountId} with your real Account ID (lowercase, sandboxes use a hyphen, for example 123456-sb1).
  • Redirect URI mismatch. The Redirect URI on the integration record must be exactly https://app.dema.ai/agents/oauth/callback, including protocol and path.
  • Approval screen fails or MCP scope is missing. Confirm that AI Connector Service is enabled in Setup → Company → Enable Features → SuiteCloud and that your role has access to it. An administrator may need to enable the feature or assign the permission.
  • Dema cannot authenticate with the client secret. NetSuite shows the secret only once. If you lost it, reset it on the integration record and reconnect in Dema with the new value.

​
Additional resources