Come collegare Oracle NetSuite a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Oracle NetSuite, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Oracle NetSuite + ChatGPT

Fai lavorare la tua AI con Oracle NetSuite: esegui query SuiteQL in sola lettura su clienti, fornitori, articoli, transazioni e contabilità generale, leggi clienti, fornitori, dipendenti, articoli, ordini di vendita, fatture, ordini d'acquisto, fatture dei fornitori e registrazioni contabili con le relative righe, consulta tipi di record e campi, e crea clienti e ordini di vendita. Accesso con OAuth 2.0 di NetSuite, su un account di produzione o sandbox.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

NETSUITE_ACCOUNT_ID, NETSUITE_CLIENT_ID, NETSUITE_CLIENT_SECRET

Step 1 — Ottieni le credenziali

Un amministratore lo configura una sola volta, in circa 20 minuti.

1. Attiva le funzionalità: Setup → Company → Enable Features. Nella sottoscheda SuiteCloud spunta REST Web Services e, sotto Manage Authentication, OAuth 2.0. Nella sottoscheda Analytics spunta SuiteAnalytics Workbook, da cui legge SuiteQL. Salva.
2. Crea un ruolo per l'AI: Setup → Users/Roles → Manage Roles → New. Aggiungi i permessi REST Web Services (Full) e Log in using OAuth 2.0 Access Tokens (Full), View sulle liste e sulle transazioni che l'AI può leggere (clienti, fornitori, articoli, dipendenti, conti, ordini di vendita, fatture, ordini d'acquisto, fatture dei fornitori, registrazioni contabili e Find Transaction) e Create dove può scrivere (clienti, ordini di vendita). Assegna il ruolo all'utente che effettuerà l'accesso. Un ruolo dedicato è più sicuro di Administrator: l'AI vede solo ciò che il ruolo consente.
3. Crea il record di integrazione: Setup → Integration → Manage Integrations → New. Imposta lo stato su Enabled, togli la spunta da Token-Based Authentication e TBA: Authorization Flow, spunta Authorization Code Grant sotto OAuth 2.0, lascia Public Client senza spunta, inserisci il redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback (se ospiti AnythingMCP in proprio: <your AnythingMCP URL>/api/mcp-oauth/callback) e spunta lo scope REST Web Services. Al salvataggio NetSuite mostra Client ID e Client Secret una sola volta, in fondo alla pagina. Incollali in NETSUITE_CLIENT_ID e NETSUITE_CLIENT_SECRET.
4. Account ID: Setup → Company → Company Information. NETSUITE_ACCOUNT_ID lo vuole così come appare nell'indirizzo web di NetSuite: in minuscolo e con un trattino al posto del trattino basso, quindi 1234567_SB1 diventa 1234567-sb1. Per una sandbox, crea il record di integrazione direttamente nella sandbox.
5. Installa il connettore, clicca su Authorize with Provider, accedi a NetSuite e scegli il ruolo del passo 2.
6. Esegui netsuite_list_record_types per verificare la connessione, poi una prima query come SELECT id, companyname FROM customer con netsuite_suiteql_query.

Autorizza di nuovo una volta a settimana: NetSuite mantiene valido per sette giorni il refresh token di questo tipo di integrazione e non lo rinnova, quindi clicca su Authorize with Provider almeno una volta a settimana. Nel frattempo gli access token vengono rinnovati automaticamente. Disattivando il record di integrazione, il ruolo o l'utente, l'accesso termina subito.

SuiteQL fa il grosso del lavoro: netsuite_suiteql_query esegue una query SQL in sola lettura sui dati analitici di NetSuite: clienti, fornitori, articoli, conti, consociate e transazioni con le relative righe e gli importi contabilizzati. È così che l'AI risponde a domande come le fatture aperte per cliente, le vendite per articolo o la spesa per fornitore. I risultati arrivano in pagine fino a 1.000 righe e una query restituisce al massimo 100.000 righe in totale, quindi alle domande ampie l'AI risponde con dei totali anziché con righe grezze. Le righe che il ruolo non può vedere vengono escluse senza errori, quindi una risposta vuota può indicare un permesso mancante.

Record: strumenti dedicati leggono clienti, fornitori, dipendenti, articoli, ordini di vendita, fatture, ordini d'acquisto, fatture dei fornitori e registrazioni contabili con le relative righe, e netsuite_get_record legge qualsiasi altro tipo di record. netsuite_describe_record_type elenca tutti i campi di un tipo di record, compresi quelli personalizzati.

Scritture solo dopo conferma: netsuite_create_customer crea un cliente dopo la tua conferma. netsuite_create_sales_order (che crea l'ordine come Pending Approval, così non si spedisce nulla prima che qualcuno lo approvi) e netsuite_update_record sono disattivati all'installazione; attivali singolarmente se ti servono. Le modifiche alle transazioni contabilizzate incidono sulla contabilità.

Errori comuni: INVALID_LOGIN significa che l'autorizzazione settimanale è scaduta oppure che l'integrazione, il ruolo o l'utente sono stati disattivati: autorizza di nuovo. 403 o INSUFFICIENT_PERMISSION: al ruolo manca un permesso. CONCURRENCY_LIMIT_EXCEEDED: troppe richieste parallele sull'account, attendi e riprova. Un host sconosciuto significa che NETSUITE_ACCOUNT_ID non è scritto nella forma dell'indirizzo web.

Il connettore accede solo con OAuth 2.0; Token-Based Authentication (TBA) non è supportata. Non elimina record, non esegue ricerche salvate né report, non chiama RESTlet e non usa il file cabinet.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT si collega ai server MCP come app personalizzate in modalità sviluppatore (Developer mode), disponibile nei piani a pagamento, non in quello gratuito. Nei workspace Business ed Enterprise potrebbe doverla abilitare prima un amministratore.

1. In ChatGPT apri Settings → Security and login e attiva Developer mode.
2. Vai su chatgpt.com/plugins e clicca +.
3. Inserisci un nome e una breve descrizione, ad esempio Name: Oracle NetSuite.
4. In Connection inserisci l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e crea la connessione.
5. Quando ChatGPT lo chiede, accedi ad AnythingMCP (OAuth) e consenti l'accesso.

Tool disponibili

Esempi di prompt

• "Quali clienti hanno fatture aperte da più di 60 giorni, e quanto deve ciascuno?"
• "Mostrami le vendite dello scorso trimestre per articolo, i primi 20 per importo."
• "Quanto abbiamo speso con ciascun fornitore quest'anno, in base alle fatture dei fornitori?"
• "Crea un cliente per Harbor Supplies Ltd. nella consociata britannica e mostrami i dettagli prima di salvare."

FAQ

Il piano free di ChatGPT funziona con i connettori MCP personalizzati? No. Le connessioni MCP personalizzate richiedono la modalità sviluppatore, disponibile solo nei piani a pagamento.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse