diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 458b4feb4..64506521a 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -573,6 +573,11 @@ "source": "third_party/business-central", "description": "Work with customers, vendors, items, sales and purchase documents, and the general ledger in Business Central." }, + { + "name": "sap-s4hana-cloud", + "source": "third_party/sap-s4hana-cloud", + "description": "Work with business partners, products, sales and purchase orders, supplier invoices, and journal entry items in SAP S/4HANA Cloud." + }, { "name": "square", "source": "third_party/square", diff --git a/README.md b/README.md index 43e36c24a..d6c72fe11 100644 --- a/README.md +++ b/README.md @@ -106,6 +106,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `zoho-desk` | [Zoho Desk](third_party/zoho-desk/) | Cursor | Integrations | Work with tickets, contacts, tasks, and knowledge base articles in Zoho Desk. | | `zoho-books` | [Zoho Books](third_party/zoho-books/) | Cursor | Integrations | Work with contacts, invoices, estimates, and items in Zoho Books. | | `business-central` | [Microsoft Dynamics 365 Business Central](third_party/business-central/) | Cursor | Integrations | Work with customers, vendors, items, sales and purchase documents, and the general ledger in Business Central. | +| `sap-s4hana-cloud` | [SAP S/4HANA Cloud](third_party/sap-s4hana-cloud/) | Cursor | Integrations | Work with business partners, products, sales and purchase orders, supplier invoices, and journal entry items in SAP S/4HANA Cloud. | | `square` | [Square](third_party/square/) | Cursor | Integrations | Work with payments, orders, catalog, customers, and invoices. | | `tailscale` | [Tailscale](third_party/tailscale/) | Cursor | Integrations | Let Grok Bot reach MCP servers on your private Tailscale network: connect your own tailnet, or your team's company tailnets turned on by a team admin, with each member using their own device. | | `highlevel` | [HighLevel](third_party/highlevel/) | Cursor | Integrations | Work with contacts, conversations, opportunities, calendars, and payments. | diff --git a/third_party/sap-s4hana-cloud/.cursor-plugin/plugin.json b/third_party/sap-s4hana-cloud/.cursor-plugin/plugin.json new file mode 100644 index 000000000..0f7fc16a7 --- /dev/null +++ b/third_party/sap-s4hana-cloud/.cursor-plugin/plugin.json @@ -0,0 +1,61 @@ +{ + "name": "sap-s4hana-cloud", + "displayName": "SAP S/4HANA Cloud", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.19.0" + }, + "description": "Work with business partners, products, sales and purchase orders, supplier invoices, and journal entry items in SAP S/4HANA Cloud.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://github.com/cursor/plugins/tree/main/third_party/sap-s4hana-cloud", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "sap", + "s/4hana", + "s4hana", + "erp", + "mcp" + ], + "category": "integrations", + "tags": [ + "sap", + "erp", + "mcp" + ], + "variables": { + "type": "object", + "additionalProperties": false, + "required": [ + "SAP_S4HANA_API_HOST", + "SAP_S4HANA_USERNAME", + "SAP_S4HANA_PASSWORD" + ], + "properties": { + "SAP_S4HANA_API_HOST": { + "type": "string", + "title": "API host", + "description": "The tenant's OData API host, such as my123456-api.s4hana.cloud. Take it from the communication arrangement, not the Fiori launchpad host.", + "minLength": 1 + }, + "SAP_S4HANA_USERNAME": { + "type": "string", + "title": "Communication user name", + "description": "The communication user of an inbound communication arrangement that exposes the OData services, not a business user.", + "minLength": 1 + }, + "SAP_S4HANA_PASSWORD": { + "type": "string", + "title": "Password", + "description": "The communication user's password.", + "writeOnly": true, + "format": "password", + "minLength": 1 + } + } + } +} diff --git a/third_party/sap-s4hana-cloud/CHANGELOG.md b/third_party/sap-s4hana-cloud/CHANGELOG.md new file mode 100644 index 000000000..bb114c68a --- /dev/null +++ b/third_party/sap-s4hana-cloud/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `sap-s4hana-cloud` plugin, the opt-in for the SAP S/4HANA Cloud MCP server that Cursor hosts. +- Carries no MCP server definition: the server is Cursor-side, so installing the plugin is the whole configuration. +- Each member enters their own `SAP_S4HANA_API_HOST`, `SAP_S4HANA_USERNAME`, and `SAP_S4HANA_PASSWORD`. These are per-member values, not team settings. +- Logo: SAP's official mark, from `sap.com`. diff --git a/third_party/sap-s4hana-cloud/LICENSE b/third_party/sap-s4hana-cloud/LICENSE new file mode 100644 index 000000000..ca2bba771 --- /dev/null +++ b/third_party/sap-s4hana-cloud/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/sap-s4hana-cloud/README.md b/third_party/sap-s4hana-cloud/README.md new file mode 100644 index 000000000..48779b73d --- /dev/null +++ b/third_party/sap-s4hana-cloud/README.md @@ -0,0 +1,72 @@ +# SAP S/4HANA Cloud + +Cursor plugin that connects agents to [SAP S/4HANA Cloud](https://www.sap.com/products/erp/s4hana.html) — SAP's cloud ERP — through a [Model Context Protocol](https://modelcontextprotocol.io/) server that Cursor hosts. + +Work with a tenant's business partners, products, sales and purchase orders, supplier invoices, and journal entry items. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **SAP S/4HANA Cloud** and click **Install**. +3. Enter the API host, communication user name, and password (see [Before you connect](#before-you-connect)). + +Or run `/add-plugin sap-s4hana-cloud` in chat. + +## MCP + +This plugin ships no `mcp.json`, and that is deliberate. + +Every other connector in this repository either points at a vendor's hosted endpoint or runs a package locally over stdio, so it carries its own server definition. SAP S/4HANA Cloud does not: Cursor runs the server, and the plugin exists only as the opt-in that turns it on for your account. There is no command to run and no MCP endpoint to configure. + +One consequence worth knowing: because the server is not declared here, you will not find it in a local `mcp.json` and you cannot point another MCP client at it. It is reachable from Cursor only. + +## Before you connect + +Each person who installs the plugin enters their own three values. These are per-member settings, so a team admin cannot set them for everyone. + +There is no sign-in or OAuth flow. The credential is a communication user and password from an inbound communication arrangement that exposes the OData services. A business user will not work. + +Take the API host from the communication arrangement, not the Fiori launchpad host. A bare host or an https URL is accepted. It must be a tenant subdomain of `s4hana.cloud` or `s4hana.ondemand.com`. Plain http, an explicit port, or credentials in the URL are rejected. Hosts on other domains are rejected, so this is SAP S/4HANA Cloud only. Example: `my123456-api.s4hana.cloud`. + +Create the communication user and inbound communication arrangement in SAP. See the SAP documentation linked under [Docs](#docs). + +All three fields are required: + +| Field | Value | +| --- | --- | +| `SAP_S4HANA_API_HOST` | The tenant's OData API host, from the communication arrangement. | +| `SAP_S4HANA_USERNAME` | The communication user name. | +| `SAP_S4HANA_PASSWORD` | The communication user's password. Treated as a secret and never shown back. | + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Business partners | Read, create, and update business partners; list addresses; create addresses; look up customers and suppliers | +| Products | Read, create, and update products; list product descriptions | +| Sales | Read, create, and update sales orders and sales order items | +| Purchasing | Read, create, and update purchase orders and purchase order items | +| Invoices | Read and create supplier invoices; list supplier invoice items | +| Finance | Read journal entry items | + +The server is the source of truth for tool names and schemas. + +## Notes + +- Access follows the communication user's authorizations. The connector can reach only the OData services that user is allowed to call. +- Some tools create and update records in the tenant. Review every tool call before you approve it. +- Disconnecting the connector in Cursor deletes the saved host, user name, and password. + +## Docs + +- SAP S/4HANA Cloud: https://www.sap.com/products/erp/s4hana.html +- Communication Management: https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/2e84a10c430645a88bdbfaaa23ac9ff7.html +- Maintain Communication Users: https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/eef80dda3867461c92ac1273689ed36f.html +- How to Create a Communication Arrangement: https://help.sap.com/docs/SAP_S4HANA_CLOUD/0f69f8fb28ac4bf48d2b57b9637e81fa/a0771f6765f54e1c8193ad8582a32edb.html +- Model Context Protocol: https://modelcontextprotocol.io + +Logo is SAP's official mark, from `sap.com`. + +## License + +MIT diff --git a/third_party/sap-s4hana-cloud/assets/logo.png b/third_party/sap-s4hana-cloud/assets/logo.png new file mode 100644 index 000000000..c57b38080 Binary files /dev/null and b/third_party/sap-s4hana-cloud/assets/logo.png differ