Oracle NetSuite über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Oracle NetSuite klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Oracle NetSuite + Cursor

Lass deine KI mit Oracle NetSuite arbeiten: schreibgeschützte SuiteQL-Abfragen über Kunden, Lieferanten, Artikel, Transaktionen und das Hauptbuch ausführen, Kunden, Lieferanten, Mitarbeiter, Artikel, Kundenaufträge, Rechnungen, Bestellungen, Eingangsrechnungen und Buchungssätze samt Positionen lesen, Datensatztypen und Felder nachschlagen sowie Kunden und Kundenaufträge anlegen. Anmeldung über NetSuite OAuth 2.0, mit einem Produktiv- oder Sandbox-Konto.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

NETSUITE_ACCOUNT_ID, NETSUITE_CLIENT_ID, NETSUITE_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Ein Administrator richtet das einmal ein, in etwa 20 Minuten.

1. Funktionen einschalten: Setup → Company → Enable Features. Aktiviere auf dem Unterregister SuiteCloud die Option REST Web Services und, unter Manage Authentication, OAuth 2.0. Aktiviere auf dem Unterregister Analytics die Option SuiteAnalytics Workbook, aus der SuiteQL liest. Speichere.
2. Eine Rolle für die KI anlegen: Setup → Users/Roles → Manage Roles → New. Füge die Berechtigungen REST Web Services (Full) und Log in using OAuth 2.0 Access Tokens (Full) hinzu, außerdem View für die Listen und Transaktionen, die die KI lesen darf (Kunden, Lieferanten, Artikel, Mitarbeiter, Konten, Kundenaufträge, Rechnungen, Bestellungen, Eingangsrechnungen, Buchungssätze und Find Transaction), und Create dort, wo sie schreiben darf (Kunden, Kundenaufträge). Weise die Rolle dem Benutzer zu, der sich anmelden wird. Eine eigene Rolle ist sicherer als Administrator: Die KI sieht nur, was die Rolle erlaubt.
3. Den Integrationsdatensatz anlegen: Setup → Integration → Manage Integrations → New. Setze den Status auf Enabled, entferne die Haken bei Token-Based Authentication und TBA: Authorization Flow, setze unter OAuth 2.0 den Haken bei Authorization Code Grant, lass Public Client ohne Haken, trage die Redirect-URI https://cloud.anythingmcp.com/api/mcp-oauth/callback ein (wenn du AnythingMCP selbst betreibst: <your AnythingMCP URL>/api/mcp-oauth/callback) und hake den Scope REST Web Services an. Beim Speichern zeigt NetSuite Client ID und Client Secret ein einziges Mal unten auf der Seite an. Füge sie in NETSUITE_CLIENT_ID und NETSUITE_CLIENT_SECRET ein.
4. Account-ID: Setup → Company → Company Information. NETSUITE_ACCOUNT_ID erwartet sie so, wie sie in deiner NetSuite-Webadresse steht: kleingeschrieben und mit Bindestrich statt Unterstrich, aus 1234567_SB1 wird also 1234567-sb1. Für eine Sandbox legst du den Integrationsdatensatz direkt in der Sandbox an.
5. Installiere den Connector, klicke auf Authorize with Provider, melde dich bei NetSuite an und wähle die Rolle aus Schritt 2.
6. Führe netsuite_list_record_types aus, um die Verbindung zu prüfen, und danach mit netsuite_suiteql_query eine erste Abfrage wie SELECT id, companyname FROM customer.

Einmal pro Woche neu autorisieren: NetSuite hält den Refresh-Token dieser Art von Integration sieben Tage lang gültig und verlängert ihn nicht. Klicke deshalb mindestens einmal pro Woche auf Authorize with Provider. Dazwischen werden die Access-Tokens automatisch erneuert. Wer den Integrationsdatensatz, die Rolle oder den Benutzer deaktiviert, beendet den Zugriff sofort.

SuiteQL erledigt die Hauptarbeit: netsuite_suiteql_query führt eine schreibgeschützte SQL-Abfrage über die Analysedaten von NetSuite aus: Kunden, Lieferanten, Artikel, Konten, Tochtergesellschaften und Transaktionen mit ihren Positionen und Buchungsbeträgen. So beantwortet die KI Fragen wie offene Rechnungen pro Kunde, Umsatz nach Artikel oder Ausgaben pro Lieferant. Die Ergebnisse kommen in Seiten zu höchstens 1.000 Zeilen, und eine Abfrage liefert insgesamt höchstens 100.000 Zeilen. Große Fragen beantwortet die KI daher mit Summen statt mit einzelnen Zeilen. Zeilen, die die Rolle nicht sehen darf, fehlen ohne Fehlermeldung. Eine leere Antwort kann also auf eine fehlende Berechtigung hindeuten.

Datensätze: Eigene Tools lesen Kunden, Lieferanten, Mitarbeiter, Artikel, Kundenaufträge, Rechnungen, Bestellungen, Eingangsrechnungen und Buchungssätze samt Positionen, und netsuite_get_record liest jeden anderen Datensatztyp. netsuite_describe_record_type listet alle Felder eines Datensatztyps auf, auch die benutzerdefinierten.

Schreiben nur nach Bestätigung: netsuite_create_customer legt einen Kunden an, sobald du bestätigst. netsuite_create_sales_order (legt den Auftrag als Pending Approval an, damit nichts versendet wird, bevor jemand ihn freigibt) und netsuite_update_record sind bei der Installation ausgeschaltet; schalte sie bei Bedarf einzeln ein. Änderungen an gebuchten Transaktionen wirken sich auf die Buchhaltung aus.

Häufige Fehler: INVALID_LOGIN heißt, dass die wöchentliche Autorisierung abgelaufen ist oder die Integration, die Rolle oder der Benutzer deaktiviert wurde: Autorisiere erneut. 403 oder INSUFFICIENT_PERMISSION: Der Rolle fehlt eine Berechtigung. CONCURRENCY_LIMIT_EXCEEDED: zu viele parallele Anfragen auf dem Konto, warte kurz und versuche es erneut. Ein unbekannter Host heißt, dass NETSUITE_ACCOUNT_ID nicht in der Form der Webadresse geschrieben ist.

Der Connector meldet sich nur mit OAuth 2.0 an; Token-Based Authentication (TBA) wird nicht unterstützt. Er löscht keine Datensätze, führt keine gespeicherten Suchen oder Berichte aus, ruft keine RESTlets auf und nutzt das File Cabinet nicht.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Oracle NetSuite-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Kunden haben offene Rechnungen, die älter als 60 Tage sind, und wie viel schuldet jeder von ihnen?“
• „Zeig mir den Umsatz des letzten Quartals nach Artikel, die Top 20 nach Betrag.“
• „Wie viel haben wir dieses Jahr laut Eingangsrechnungen bei jedem Lieferanten ausgegeben?“
• „Leg einen Kunden für Harbor Supplies Ltd. in der britischen Tochtergesellschaft an und zeig mir die Details, bevor du speicherst.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden