diff --git a/.claude-plugin/.upstream-base b/.claude-plugin/.upstream-base index e0747a8c5f..bdfbaa9ee8 100644 --- a/.claude-plugin/.upstream-base +++ b/.claude-plugin/.upstream-base @@ -1 +1 @@ -5866df557357d005b3c0c9d3da0d9e739b4bdde3 +a5539b15a3d56e04992565aafee2b37051329ce3 diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 19da8e1423..82dda9aa44 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -707,6 +707,16 @@ "name": "eight-sleep", "source": "third_party/eight-sleep", "description": "Connect your Eight Sleep account to see your sleep scores, stages and heart metrics, check your Pod's status and temperature settings, and manage your alarms and your side of the Pod, with your approval for each change." + }, + { + "name": "netsuite", + "source": "third_party/netsuite", + "description": "Work with records, reports, saved searches, and SuiteQL queries in NetSuite." + }, + { + "name": "front", + "source": "third_party/front", + "description": "Search conversations, draft and send replies, and manage tags, tasks, and inboxes." } ] } diff --git a/third_party/front/.cursor-plugin/plugin.json b/third_party/front/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..1804e13603 --- /dev/null +++ b/third_party/front/.cursor-plugin/plugin.json @@ -0,0 +1,50 @@ +{ + "name": "front", + "displayName": "Front", + "version": "1.0.0", + "description": "Search conversations, draft and send replies, and manage tags, tasks, and inboxes.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://dev.frontapp.com/docs/mcp-server", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "front", + "frontapp", + "mcp", + "inbox", + "customer support", + "email", + "conversations" + ], + "category": "integrations", + "tags": [ + "mcp", + "support", + "email", + "productivity" + ], + "variables": { + "type": "object", + "properties": { + "CLIENT_ID": { + "type": "string", + "title": "Front Client ID", + "description": "Client ID of a Front developer app with the Front MCP feature, from Front Settings → Company → Developer." + }, + "CLIENT_SECRET": { + "type": "string", + "title": "Front Client Secret", + "description": "Client Secret of the same Front developer app." + } + }, + "required": [ + "CLIENT_ID", + "CLIENT_SECRET" + ] + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/front/CHANGELOG.md b/third_party/front/CHANGELOG.md new file mode 100644 index 0000000000..dced792d0d --- /dev/null +++ b/third_party/front/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `front` MCP server pointing at Front's hosted Streamable HTTP endpoint (`https://mcp.frontapp.com/mcp`). +- Declared `CLIENT_ID` and `CLIENT_SECRET` plugin variables and forwarded them through MCP auth, since Front requires a confidential client and does not support dynamic client registration. +- Requested the `feature:mcp` scope, the value Front documents for clients that need one. +- Logo: Front's official 192×192 app icon. diff --git a/third_party/front/LICENSE b/third_party/front/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/front/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/front/README.md b/third_party/front/README.md new file mode 100644 index 0000000000..d07c6aa8b6 --- /dev/null +++ b/third_party/front/README.md @@ -0,0 +1,90 @@ +# Front + +Cursor plugin that connects agents to [Front](https://front.com) through Front's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Search conversations, read full timelines, draft and send replies, post internal comments, and manage tags, tasks, assignments, and inboxes in the signed-in Front account. + +## Install + +1. A Front admin creates a developer app and notes its credentials (see [Setup](#setup)). +2. Open **Cursor Settings → Plugins**, search for **Front**, and click **Install**. +3. Set **Front Client ID** and **Front Client Secret**, then complete the Front sign-in prompt. + +Or run `/add-plugin front` in chat. + +## MCP + +```json +{ + "mcpServers": { + "front": { + "type": "http", + "url": "https://mcp.frontapp.com/mcp", + "auth": { + "CLIENT_ID": "${CLIENT_ID}", + "CLIENT_SECRET": "${CLIENT_SECRET}", + "scopes": ["feature:mcp"] + } + } + } +} +``` + +Front does not support dynamic client registration, so the connection is a confidential client: a Front admin registers one developer app and Cursor sends that app's client ID and secret. Each user still signs in with their own Front account, and tool calls run with that teammate's Front permissions. + +## Setup + +### 1. Create the Front developer app + +In Front, go to **Settings → Company → Developer** and create an app (for example "Cursor MCP Connector"): + +1. On the **Features** tab, click **Add feature** and select **Front MCP**. +2. Note the **Client ID** and **Client secret**. +3. Register the redirect URLs Cursor uses: + + | Surface | Redirect URL | + | --- | --- | + | Desktop | `http://localhost:8787/callback` | + | Web and Cloud Agents | `https://www.cursor.com/agents/mcp/oauth/callback` | + | Grok Bot | `https://www.cursor.com/bot/mcp/oauth/callback` | + +4. Under **Resource permissions**, select the narrowest set that covers your use case: `read` for a research agent, `read` + `write` for a drafting copilot, and `send` only if the agent should actually send messages. +5. Save the app. + +### 2. Enter the credentials in Cursor + +In **Dashboard → Plugins → Configure**, set **Front Client ID** and **Front Client Secret** from that app. On a team marketplace an admin sets them once for everyone; each member still completes their own Front sign-in. + +## What agents can do + +| Category | Tools | +| --- | --- | +| Conversations | `search_conversations`, `read_conversation`, `update_conversation_status`, `assign_conversation`, `move_conversation` | +| Drafts and messages | `create_draft`, `update_draft`, `delete_draft`, `send_message`, `list_drafts`, `read_message`, `get_attachment` | +| Comments and tags | `add_comment`, `list_tags`, `tag_conversation` | +| Tasks | `create_task`, `update_task` | +| Templates | `search_message_templates` | +| Contacts and accounts | `search_contacts`, `read_contact`, `search_accounts`, `read_account` | +| Organization | `get_my_identity`, `list_inboxes`, `list_channels`, `list_teammates`, `list_teams`, `list_statuses` | + +The hosted runtime is the source of truth for tool names and schemas. Tools that mutate state visibly are marked destructive, so Cursor asks for confirmation per call. + +## Notes + +- Permissions are enforced at call time against the teammate's current Front role. An inbox that teammate cannot see is invisible to the agent too. `search_conversations` defaults to `my_conversations`; unassigned conversations need `scope: all_inboxes`. +- Changing the app's resource permissions does not reach existing connections. Each user has to disconnect Front and connect again before new permissions, or tools that need them, start working. Until then those tools return `missing required scopes`. +- Task IDs are conversation IDs: `read_conversation` and `search_conversations` (with `filters.type: "task"`) read them, but only `update_task` changes task state. +- Rate limits are metered in tool calls per minute — 100 on Starter, 200 on Professional, 300 on Enterprise — keyed to the connecting teammate and independent of Core API limits. Unpublished apps in a company share one pool, so adding apps divides capacity. Over-limit calls come back as tool results that state how long to wait. + +## Docs + +- Front MCP server: https://dev.frontapp.com/docs/mcp-server +- Server URL: https://mcp.frontapp.com/mcp +- Authorization URL: https://app.frontapp.com/oauth/authorize +- Token and refresh URL: https://app.frontapp.com/oauth/token + +Logo is Front's official app mark, the 192×192 app icon published on front.com. + +## License + +MIT diff --git a/third_party/front/assets/logo.png b/third_party/front/assets/logo.png new file mode 100644 index 0000000000..dbe0922509 Binary files /dev/null and b/third_party/front/assets/logo.png differ diff --git a/third_party/front/mcp.json b/third_party/front/mcp.json new file mode 100644 index 0000000000..57a14b0a5b --- /dev/null +++ b/third_party/front/mcp.json @@ -0,0 +1,13 @@ +{ + "mcpServers": { + "front": { + "type": "http", + "url": "https://mcp.frontapp.com/mcp", + "auth": { + "CLIENT_ID": "${CLIENT_ID}", + "CLIENT_SECRET": "${CLIENT_SECRET}", + "scopes": ["feature:mcp"] + } + } + } +} diff --git a/third_party/gong/.cursor-plugin/plugin.json b/third_party/gong/.cursor-plugin/plugin.json index 5bc7f7da23..6efca64f88 100644 --- a/third_party/gong/.cursor-plugin/plugin.json +++ b/third_party/gong/.cursor-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "gong", "displayName": "Gong", - "version": "1.0.0", + "version": "1.1.0", "description": "Pull account summaries, deal insights, and call briefs.", "author": { "name": "Cursor", @@ -31,18 +31,14 @@ "CLIENT_ID": { "type": "string", "title": "Gong Client ID", - "description": "OAuth Client ID from Gong Admin → Company Settings → Ecosystem → API → Integrations (MCP integration)." + "description": "Optional. OAuth Client ID from Gong Admin → Company Settings → Ecosystem → API → Integrations (MCP integration). Leave empty in Grok Bot, which registers its own Gong client." }, "CLIENT_SECRET": { "type": "string", "title": "Gong Client Secret", - "description": "OAuth Client Secret from the same Gong MCP integration." + "description": "Optional. OAuth Client Secret from the same Gong MCP integration, needed with the Client ID." } - }, - "required": [ - "CLIENT_ID", - "CLIENT_SECRET" - ] + } }, "mcpServers": "./mcp.json" } diff --git a/third_party/gong/CHANGELOG.md b/third_party/gong/CHANGELOG.md index 09a78045e0..91b38ea237 100644 --- a/third_party/gong/CHANGELOG.md +++ b/third_party/gong/CHANGELOG.md @@ -2,6 +2,11 @@ All notable changes to this plugin will be documented here. +## 1.1.0 + +- `CLIENT_ID` and `CLIENT_SECRET` are optional. Left empty, Grok Bot registers its own Gong client instead of stopping at "OAuth client is not configured". +- README: dropped the `http://localhost:8787/callback` redirect, which Gong rejects, and documented the no-setup path. + ## 1.0.0 — initial release - Logo: Gong's official 180×180 apple-touch icon. diff --git a/third_party/gong/README.md b/third_party/gong/README.md index 28216e41fa..c7b5a92c99 100644 --- a/third_party/gong/README.md +++ b/third_party/gong/README.md @@ -8,7 +8,7 @@ Pull account summaries, deal insights, and call briefs into chat. 1. Open **Cursor Settings → Plugins**. 2. Search for **Gong**. -3. Click **Install**, then set the client ID and secret (below) and complete the Gong sign-in prompt. +3. Click **Install**, then complete the Gong sign-in prompt. Or run `/add-plugin gong` in chat. @@ -20,8 +20,8 @@ Or run `/add-plugin gong` in chat. "gong": { "url": "https://mcp.gong.io/mcp", "auth": { - "CLIENT_ID": "${CLIENT_ID}", - "CLIENT_SECRET": "${CLIENT_SECRET}" + "CLIENT_ID": "${CLIENT_ID:-}", + "CLIENT_SECRET": "${CLIENT_SECRET:-}" } } } @@ -30,14 +30,14 @@ Or run `/add-plugin gong` in chat. ## Setup -Gong's MCP server uses static OAuth client credentials plus a per-user OAuth login, so an administrator has to register Cursor before anyone can connect. +In Grok Bot no setup is needed: it registers its own Gong client with the `mcp:read` and `mcp:write` scopes, and each user completes their own Gong sign-in. + +To use your own Gong client instead: 1. A Gong technical administrator creates an MCP integration under **Company Settings → Ecosystem → API → Integrations** and enables the MCP scope. -2. Register both redirect URIs on that integration: - - Desktop: `http://localhost:8787/callback` - - Web and Cloud Agents: `https://www.cursor.com/agents/mcp/oauth/callback` +2. Register `https://www.cursor.com/agents/mcp/oauth/callback` as the redirect URI. Gong accepts only `https://` redirects. 3. In **Dashboard → Plugins → Configure**, set **Gong Client ID** and **Gong Client Secret** from that integration. -4. Complete the Gong OAuth login when Cursor prompts. +4. Complete the Gong OAuth login when prompted. On a team marketplace an admin sets the client ID and secret once for everyone; each member still completes their own Gong OAuth login, so tool calls run with that member's Gong permissions. diff --git a/third_party/gong/mcp.json b/third_party/gong/mcp.json index a3776cf337..ccf5a25642 100644 --- a/third_party/gong/mcp.json +++ b/third_party/gong/mcp.json @@ -3,8 +3,8 @@ "gong": { "url": "https://mcp.gong.io/mcp", "auth": { - "CLIENT_ID": "${CLIENT_ID}", - "CLIENT_SECRET": "${CLIENT_SECRET}" + "CLIENT_ID": "${CLIENT_ID:-}", + "CLIENT_SECRET": "${CLIENT_SECRET:-}" } } } diff --git a/third_party/netsuite/.cursor-plugin/plugin.json b/third_party/netsuite/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..28be5cb596 --- /dev/null +++ b/third_party/netsuite/.cursor-plugin/plugin.json @@ -0,0 +1,49 @@ +{ + "name": "netsuite", + "displayName": "NetSuite", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.19.0" + }, + "description": "Work with records, reports, saved searches, and SuiteQL queries in NetSuite.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "netsuite", + "oracle", + "erp", + "suiteql", + "saved searches", + "accounting", + "ai connector service", + "mcp" + ], + "category": "integrations", + "tags": [ + "netsuite", + "erp", + "accounting", + "mcp" + ], + "variables": { + "type": "object", + "additionalProperties": false, + "required": [ + "NETSUITE_MCP_URL" + ], + "properties": { + "NETSUITE_MCP_URL": { + "type": "string", + "title": "NetSuite MCP server URL", + "description": "Account-specific AI Connector Service URL. Every tool in the account: https://.suitetalk.api.netsuite.com/services/mcp/v1/all. Only the MCP Standard Tools SuiteApp: https://.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools. Find the account ID under Setup → Company → Company Information, lowercased with underscores replaced by hyphens, so 1234567_SB1 becomes 1234567-sb1." + } + } + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/netsuite/CHANGELOG.md b/third_party/netsuite/CHANGELOG.md new file mode 100644 index 0000000000..c3f608a2a5 --- /dev/null +++ b/third_party/netsuite/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `netsuite` MCP server pointing at the NetSuite AI Connector Service over Streamable HTTP. +- The server URL is account-specific, so `NETSUITE_MCP_URL` is a required plugin variable. Both documented forms work: `/services/mcp/v1/all` and `/services/mcp/v1/suiteapp/`. +- Auth uses OAuth with NetSuite user sign-in (authorization code + PKCE, dynamic client registration, scope `mcp`) — no client ID or secret to configure. +- Logo: NetSuite's official mark, from the NetSuite iOS app icon published by Oracle America. diff --git a/third_party/netsuite/LICENSE b/third_party/netsuite/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/netsuite/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/netsuite/README.md b/third_party/netsuite/README.md new file mode 100644 index 0000000000..38de9733c8 --- /dev/null +++ b/third_party/netsuite/README.md @@ -0,0 +1,123 @@ +# NetSuite + +Cursor plugin that connects agents to an [Oracle NetSuite](https://www.netsuite.com) account through the [NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html), NetSuite's own [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Agents query data with SuiteQL, run reports and saved searches, and create, update, transform, and act on records. Every call runs as the NetSuite user who signed in, under that user's role and permissions. + +## Install + +1. An administrator enables the required features and permissions and installs a tools SuiteApp (see [Account setup](#account-setup)). +2. A Cursor team admin opens **Cursor Settings → Plugins**, searches for **NetSuite**, installs it, and enters the account-specific server URL. +3. Each member signs in to NetSuite when Cursor prompts them, choosing a non-administrator role. + +Or run `/add-plugin netsuite` in chat. + +## MCP + +```json +{ + "mcpServers": { + "netsuite": { + "type": "http", + "url": "${NETSUITE_MCP_URL}" + } + } +} +``` + +The URL is unique to the account, so there is no default. NetSuite documents two forms: + +| Form | Returns | +| --- | --- | +| `https://.suitetalk.api.netsuite.com/services/mcp/v1/all` | Every tool installed in the account, from SuiteApps and account customization projects | +| `https://.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/` | Only the tools one SuiteApp exposes. The MCP Standard Tools SuiteApp is `com.netsuite.mcpstandardtools` | + +`` is the account ID from **Setup → Company → Company Information**, in domain form: lowercase, with underscores replaced by hyphens, so `1234567_SB1` becomes `1234567-sb1`. Without the `/all` or `/suiteapp/` suffix the connection shows as disconnected. + +Auth is OAuth 2.0 authorization code with PKCE and the `mcp` scope, which NetSuite only accepts on its own. There is no client ID or secret to enter: NetSuite supports dynamic client registration for this service, so Cursor registers itself when a member connects. + +## Account setup + +An administrator does this once per account. + +### 1. Enable the features + +Under **Setup → Company → Enable Features → SuiteCloud**, enable **Server SuiteScript** and **OAUTH 2.0**. The MCP Standard Tools SuiteApp also needs **REST Web Services**. + +### 2. Install a tools SuiteApp + +The service only exposes tools that exist in the account. For the standard set, open the **SuiteApps** tab, search for **MCP Standard Tools**, and install it. Otherwise, build custom tools. + +### 3. Create a scoped role + +Administrator roles and roles with full permissions are blocked from the service, so members need a dedicated role. Under **Setup → Users/Roles → Manage Roles**, add these on the **Permissions → Setup** subtab: + +| Permission | Why | +| --- | --- | +| MCP Server Connection | Required to reach the service. Not **Log in using Access Tokens** | +| Log in using OAuth 2.0 Access Tokens | Required for the OAuth flow | +| REST Web Services | Needed by the record tools in MCP Standard Tools | + +Grant only the record and task permissions the account wants reachable from an agent, then assign the role to each member under **Lists → Employees → Employees → Access → Roles**. The role also needs access to the SuiteApp's File Cabinet folder. + +### 4. Check the integration record + +Under **Setup → Integration → Manage Integrations**, confirm an integration record exists with **Public Client**, **Authorization Code Grant**, and the **NetSuite AI Connector Service** scope. A record created by a SuiteApp install starts pending and an administrator has to enable it; a record without that scope has to be recreated. If no record exists, create one. + +For dynamic client registration, check **Dynamic Client Registration**, set **Client Name for Dynamic Client Registration** to `Cursor`, and add the callback URLs Cursor uses: + +| Surface | Callback URL | +|:--------|:-------------| +| Desktop | `http://localhost:8787/callback` | +| Web and Cloud Agents | `https://www.cursor.com/agents/mcp/oauth/callback` | +| Older desktop builds | `cursor://anysphere.cursor-mcp/oauth/callback` | + +Leave the token-based authentication, client credentials, and other OAuth 2.0 scope boxes cleared. The record's **AI Connector Service (MCP)** execution log lists every call, for 21 days in production and seven in sandbox. + +## What agents can do + +With the MCP Standard Tools SuiteApp installed: + +| Category | Tools | +| --- | --- | +| SuiteQL | `ns_runCustomSuiteQL` (read-only), `ns_getSuiteQLMetadata` | +| Records | `ns_createRecord`, `ns_getRecord`, `ns_updateRecord`, `ns_transformRecord`, `ns_getRecordTypeMetadata`, `ns_getRecordTransformMetadata` | +| Record actions | `ns_getRecordActionMetadata`, `ns_executeRecordAction` | +| Reports | `ns_listAllReports`, `ns_runReport`, `ns_getAccountingBooks`, `ns_getAccountingContexts`, `ns_getSubsidiaries`, `ns_getNexusIds` | +| Saved searches | `ns_listSavedSearches`, `ns_runSavedSearch` | +| File Cabinet | `ns_searchFiles`, `ns_getFolderByPath`, `ns_getIdFromPath`, `ns_getPathFromId`, `ns_attachFile`, `ns_detachFile` | +| Runtime | `ns_getSessionInfo` | + +It is a managed SuiteApp, so Oracle changes the tool set over time and the live server is the source of truth. A tool only appears when the signed-in role holds every permission that tool requires, and accounts with custom tools see those instead or as well. + +## Notes + +- The record tools write through REST Web Services. Any role carrying **MCP Server Connection** can create and update whatever its permissions already allow, so scope the role rather than relying on the tool list. +- Reads and writes obey NetSuite roles and permissions exactly as the UI does; the tools add no access of their own. +- Oracle has not assessed this service for HIPAA, so do not route ePHI through it. +- Administrators can disable the integration record or cap its share of the account's concurrency limit. +- Review Oracle's [associated risks, controls, and mitigation strategies](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html) before connecting an account. + +## Troubleshooting + +| Symptom | What to check | +|:--------|:--------------| +| Connection shows as disconnected | The URL is missing `/all` or `/suiteapp/`, or the account ID is not in domain form | +| Sign-in succeeds and no tools appear | No tools SuiteApp is installed, the role lacks the permissions those tools require, or the role cannot reach the SuiteApp's File Cabinet folder | +| Sign-in is refused | The chosen role is Administrator or has full permissions, or it is missing **MCP Server Connection** or **Log in using OAuth 2.0 Access Tokens** | +| Redirect URI error during sign-in | The integration record has no matching callback URL, or its DCR client name is not `Cursor` | +| Tools are visible and calls fail | The signed-in role lacks the record or action permission, or **REST Web Services** is off | + +## Docs + +- Get started: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html +- Required features and permissions: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714080625.html +- Connect to the service and server URL formats: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714082142.html +- MCP Standard Tools SuiteApp: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_143403258.html +- Available tools: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0902023508.html + +Logo is NetSuite's official mark, from the NetSuite iOS app icon published by Oracle America. + +## License + +MIT diff --git a/third_party/netsuite/assets/logo.png b/third_party/netsuite/assets/logo.png new file mode 100644 index 0000000000..27ef4448ef Binary files /dev/null and b/third_party/netsuite/assets/logo.png differ diff --git a/third_party/netsuite/mcp.json b/third_party/netsuite/mcp.json new file mode 100644 index 0000000000..cbd157e196 --- /dev/null +++ b/third_party/netsuite/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "netsuite": { + "type": "http", + "url": "${NETSUITE_MCP_URL}" + } + } +}