Using the NetSuite AI Connector Service Companion SuiteApp
The NetSuite AI Connector Service Companion SuiteApp provides prompt samples and related resources for working with NetSuite in a supported AI client. Use the Companion SuiteApp to find prompts, access favorites, browse plugins, skills, and tools, and find NetSuite AI guidance. You can copy prompt text, open a prompt in a supported AI client, or create a personal copy to customize in NetSuite.
The following sections describe the tabs, access to prompt samples, the optional NetSuite skill file, and how to use and customize prompts.
Companion SuiteApp Tabs
To open the Companion SuiteApp, go to Setup > AI Companion Tools > AI Companion Library. The following table describes the tabs that are available.
|
Tab |
Description |
|---|---|
|
Home |
Access your favorite prompts, find links for connecting ChatGPT or Claude to NetSuite, and review the steps for finding and using a prompt. |
|
Prompt Library |
Find prompt samples using Search and the Category, Industry, Role, and Scope filters. You can review prompt details, add favorites, copy prompt text, open a prompt in a supported AI client, or create a personal copy to customize. |
|
Plugins, Skills and Tools |
Browse Oracle-published SuiteCloud plugins and skills on GitHub, review skills and custom tools visible to your current NetSuite role, and open the account Skills register or Custom Tools page. |
|
Support |
Search the Oracle NetSuite Help Center and open guidance about NetSuite AI features, AI preferences, feature availability, and SuiteScript generative AI. This tab also includes links for connecting ChatGPT or Claude to NetSuite. |
The published plugins and skills on GitHub are separate from the skills installed in your account. Access to account skills and custom tools depends on your NetSuite role. Access from an AI client also depends on its connection and required permissions.
Accessing the Companion Prompt Samples
When a prompt is visible to all roles in the Companion SuiteApp, it's because the prompt custom record is public. However, whether the prompt runs successfully in your AI client depends on the permissions assigned to your NetSuite role. If your role doesn't have the required permissions for the MCP Standard Tools or data used by the prompt, the prompt may return an error even though you can use it in your AI client.
After installing both SuiteApps (MCP Standard Tools and NetSuite AI Connector Service Companion), connect your AI client before running a prompt that uses MCP Standard Tools. To connect and use only the tools provided by the MCP Standard Tools SuiteApp, use the following URL and replace <accountid> with your NetSuite account ID:
https://
<accountid>
.suitetalk.api.netsuite.com/service/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
On the Prompt Library tab, find a prompt sample using Search and the Category, Industry, Role, and Scope filters. Use the Public, Mine, and Favorites boxes under Scope to choose which prompts to display. The Role filter lists suggested prompt roles, but it doesn't grant the permissions needed to run a prompt. You can copy prompt text or open a prompt in a supported AI client. Before running the prompt, replace any placeholder values with values for your use case.
The NetSuite AI Connector Service Companion provides a repository of prompt samples that use the MCP Standard Tools, but it doesn't replace the tools themselves. If you can connect successfully using the MCP Standard Tools endpoint and the Companion's prompt samples Suitelet opens in NetSuite, you are ready to start using the prompt samples.
Uploading the NetSuite Skill File for AI Clients
NetSuite provides an optional skill for supported AI clients to add shared context and repeatable guidance when using the prompt samples. The netsuite-ai-connector-instructions skill (as a SKILL.md file) can enhance prompt sample outputs when used with the MCP Standard Tools SuiteApp.
To use the skill file:
-
Download the SKILL.md file (which defines the netsuite-ai-connector-instructions skill) from the NetSuite SuiteCloud SDK GitHub repository by clicking the following link: NetSuite SuiteCloud SDK GitHub
-
In an active AI client session connected to the MCP Standard Tools SuiteApp, upload the SKILL.md file.
The location and label for uploading files can vary depending on your AI client plan and UI version. Consult your AI client's documentation for guidance on uploading files.
Using the Prompt Samples
After it's installed, open the Companion SuiteApp by going to Setup > AI Companion Tools > AI Companion Library. On the Prompt Library tab, use the prompt actions to copy or open a prompt, then replace any placeholders in your AI client session before running it.
To use a prompt sample:
-
On the Prompt Library tab, find a prompt sample that matches your goal or use case.
-
Choose an action:
-
Click the prompt text to copy it, then paste it into your AI client.
-
Click Use Prompt, then click Open Claude or Open ChatGPT to open the prompt in that AI client.
Optionally, click Expand full view to review the complete prompt before choosing an action.
-
-
After the prompt text is in your AI client session, replace any placeholder values (for example, dates or subsidiary names) with accurate values for your use case.
-
Run the prompt and review the output. If results aren't what you expect, adjust your placeholder values and prompt text as required for your use case.
Customizing the Prompt Samples
On the Prompt Library tab, use Customize to create a personal copy of a prompt sample for reuse. You can edit the copy in the AI prompt custom record.
To customize a prompt sample:
-
Click Customize under your selected prompt sample.
-
In the AI prompt custom record, update the Prompt field with your revised prompt text.
-
Optionally, update any other AI prompt record fields so the prompt can be found, understood, and reused:
-
Confirm that the values in the Name, Category, and Subcategory fields reflect the prompt's purpose.
-
Review the values in the Roles and Industries fields to ensure they match the intended users and scenarios.
-
Check the Public box if the prompt should be widely available.
-
Add a note on the Notes subtab describing what you changed on the AI prompt record and why.
-
-
Click Save.