In breve
RO App (ex RemOnline) CRM per officine di riparazione e servizi, API pubblica v2: ordini con stati e commenti, clienti, richieste (lead), prodotti e magazzini, fatture, conti finanziari con le loro transazioni, attività e dipendenti. Chiave API.
Configurazione guidata
Collega RO App a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega RO App con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
Prova a chiedere
Prompt di esempio per RO App
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → RO App, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
RO App + Claude
RO App (ex RemOnline) CRM per officine di riparazione e servizi, API pubblica v2: ordini con stati e commenti, clienti, richieste (lead), prodotti e magazzini, fatture, conti finanziari con le loro transazioni, attività e dipendenti. Chiave API.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
RO_APP_API_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti.
- In RO App apri Impostazioni, API (https://web.roapp.io/settings/api).
- Copia la chiave API in
RO_APP_API_KEY. È legata al tuo profilo utente e può essere rigenerata nella stessa pagina.
La chiave viene inviata come Authorization: Bearer. Non c'è scambio di token nell'API v2. Una chiave errata restituisce 403 con il messaggio Token non valido.
Da dove iniziare: ro_app_get_company controlla la chiave. ro_app_list_orders elenca gli ordini di riparazione; filtra per id stato da ro_app_list_order_statuses. ro_app_get_order e ro_app_list_order_items mostrano un ordine con le sue parti e servizi.
Ordini: ro_app_list_orders, ro_app_get_order, ro_app_list_order_items, ro_app_create_order, ro_app_update_order, ro_app_update_order_status, ro_app_add_order_comment, con le liste di riferimento ro_app_list_order_statuses e ro_app_list_order_types. Un nuovo ordine ha bisogno di una posizione (ro_app_list_locations), un tipo di ordine e un cliente.
Clienti: un cliente è una persona o un'organizzazione. Persone: ro_app_list_people, ro_app_get_person, ro_app_create_person. Organizzazioni: ro_app_list_organizations, ro_app_get_organization, ro_app_create_organization.
Lead: RO App li chiama richieste. ro_app_list_inquiries, ro_app_get_inquiry, ro_app_create_inquiry, ro_app_update_inquiry_status, con ro_app_list_inquiry_statuses e ro_app_list_inquiry_types.
Inventario: ro_app_list_products e ro_app_get_product leggono il catalogo prodotti, ro_app_list_warehouses i magazzini. L'API v2 non documenta alcuna chiamata per la quantità di stock per magazzino, quindi i livelli di stock non sono disponibili qui.
Fatture e pagamenti (solo lettura): ro_app_list_invoices, ro_app_get_invoice, ro_app_list_invoice_items; ro_app_list_finance_accounts e ro_app_list_account_transactions mostrano casse, conti bancari e i pagamenti registrati su di essi. Il connettore non crea pagamenti, trasferimenti o rimborsi.
Attività e personale: ro_app_list_tasks, ro_app_get_task, ro_app_create_task; ro_app_list_employees fornisce gli id dei dipendenti utilizzati per i manager e gli assegnatari.
Paging e filtri: le liste restituiscono fino a 50 righe per pagina con count (il totale); chiedi la pagina successiva con page. La maggior parte dei filtri richiede liste di id. I filtri di data richiedono una o due date ISO 8601: una è l'inizio, due sono un intervallo.
Limiti: 3 richieste al secondo; più risposte 429. Niente viene eliminato da questo connettore.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Claude
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 mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca + Add e poi Add custom connector.
- Inserisci un nome, ad esempio
RO App, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Continue, mantieni le impostazioni rilevate e clicca di nuovo Continue. - Scegli Sign in now, clicca Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
ro_app_get_company | Legge le informazioni che RO App ha sul conto aziendale dietro la chiave API. Usalo per controllare che la chiave funzioni. Solo lettura |
ro_app_list_locations | Elenca le sedi (filiali, officine) dell'azienda: id, nome, indirizzo e se archiviato. L'id è il branch_id degli ordini… |
ro_app_list_employees | Elenca i dipendenti dell'azienda: id, nome, email, telefono, posizione e gruppo. L'id è quello a cui si riferiscono manager, assegnatari e autori delle attività… |
ro_app_list_orders | Elenca gli ordini di riparazione e servizio: id, numero documento, stato, tipo, posizione, cliente, asset, manager e assegnatario, descrizione del problema… |
ro_app_get_order | Legge un ordine con tutti i suoi dettagli: stato, tipo, cliente e pagatore, asset, manager e assegnatario, descrizione del problema, note, conclusione… |
ro_app_list_order_items | Elenca i prodotti e servizi su un ordine: ogni articolo con il suo nome, quantità, prezzo, costo, sconto, tassa e garanzia. Solo lettura |
ro_app_create_order | Crea un ordine di riparazione o servizio per un cliente in una posizione. Recupera prima gli id: ro_app_list_locations (branch_id)… |
ro_app_update_order | Aggiorna un ordine: cliente, asset, manager, assegnatario, programma, data di scadenza, descrizione del problema, note o campi personalizzati. Solo i campi forniti… |
ro_app_update_order_status | Sposta un ordine in un altro stato, con un commento facoltativo. A seconda delle regole di stato dell'account, questo può notificare il cliente o chiudere… |
ro_app_add_order_comment | Aggiungi un commento al feed eventi di un ordine. Un commento privato è visibile solo ai dipendenti |
ro_app_list_order_statuses | Elenca ogni stato che un ordine può avere: id, nome, colore e gruppo (nuovo, in corso, pronto, chiuso e altri). Solo lettura |
ro_app_list_order_types | Elenca i tipi di ordine dell'account (ad esempio riparazione, vendita, manutenzione) con i loro id. Un ordine ne ha bisogno di uno. Solo lettura |
ro_app_list_people | Elenca i clienti che sono persone: id, nome e cognome, email, telefoni, indirizzo, tag, manager, sconto e se fornitore. Restituisce le… |
ro_app_get_person | Legge una persona: nomi, compleanno, email, telefoni, indirizzi, tag, manager, codice sconto, numero fiscale e campi personalizzati. Solo lettura |
ro_app_create_person | Crea un cliente che è una persona, con un nome e opzionalmente un cognome, email, telefoni, indirizzo e tag. Restituisce la persona con i suoi… |
ro_app_list_organizations | Elenca i clienti che sono organizzazioni (aziende): id, nome, email, telefoni, indirizzo, tag, manager e se fornitore. Restituisce le righe… |
ro_app_get_organization | Legge un'organizzazione: nome, email, telefoni, indirizzi, tag, manager, numeri fiscali e di registrazione e campi personalizzati. Solo lettura |
ro_app_create_organization | Crea un cliente che è un'organizzazione (azienda), con un nome e opzionalmente email, telefoni, indirizzo, numeri fiscali e tag. Restituisce la… |
ro_app_list_inquiries | Elenca le richieste (lead): id, numero documento, stato, tipo, posizione, nome e telefono del contatto, cliente, manager, commento, data di scadenza e creato… |
ro_app_get_inquiry | Legge una richiesta (lead): stato, tipo, nome del contatto, telefono e email, cliente, manager, commento, note, indirizzo, data di scadenza e campi personalizzati.… |
ro_app_create_inquiry | Crea una richiesta (lead) di un dato tipo, con il nome e il telefono del contatto o un cliente esistente, un commento e una data di scadenza opzionale.… |
ro_app_update_inquiry_status | Sposta una richiesta (lead) in un altro stato, con un commento facoltativo, ad esempio per marcarla come vinta o persa |
ro_app_list_inquiry_statuses | Elenca ogni stato che una richiesta (lead) può avere, con id, nome e gruppo. Solo lettura, nessun parametro |
ro_app_list_inquiry_types | Elenca i tipi di richiesta (lead) dell'account con i loro id. Una richiesta ne ha bisogno di uno. Solo lettura, nessun parametro |
ro_app_list_products | Elenca i prodotti (parti e beni) del catalogo: id, titolo, SKU, codice interno, codici a barre, numero di parte del produttore, categoria, unità di… |
ro_app_get_product | Legge un prodotto del catalogo: titolo, SKU, codice, codici a barre, categoria, unità di misura, garanzia, prezzi e campi personalizzati. Solo lettura |
ro_app_list_warehouses | Elenca i magazzini: id, nome, tipo e la posizione a cui appartengono. Solo lettura |
ro_app_list_invoices | Elenca le fatture: id, numero documento, stato, cliente e pagatore, entità legale, metodo di pagamento, totali, data di emissione e data di scadenza, e l'ordine… |
ro_app_get_invoice | Legge una fattura: numero, stato, cliente e pagatore, entità legale, metodo di pagamento, totali con tassa e sconto, date di emissione e scadenza e… |
ro_app_list_invoice_items | Elenca i prodotti e servizi su una fattura: ogni articolo con nome, quantità, prezzo, sconto e tassa. Solo lettura |
ro_app_list_finance_accounts | Elenca i conti finanziari (casse e conti bancari) dell'azienda con i loro id, titoli e tipi di metodo di pagamento. Solo lettura; questo… |
ro_app_list_account_transactions | Elenca i pagamenti registrati su un conto finanziario: direzione (entrata o uscita), importo, categoria di flusso di cassa, descrizione, l'impiegato che… |
ro_app_list_tasks | Elenca le attività: id, titolo, descrizione, priorità, stato, data di scadenza, autore, assegnatari e l'oggetto a cui sono collegate. Restituisce le righe di… |
ro_app_get_task | Legge un'attività: titolo, descrizione, priorità, stato, data di scadenza, autore, assegnatari, l'oggetto collegato e i suoi commenti. Solo lettura |
ro_app_create_task | Crea un'attività con un titolo e una data di scadenza, opzionalmente con una descrizione, priorità, assegnatari e un collegamento a un ordine, richiesta, fattura… |
Esempi di prompt
- "Quali ordini di riparazione sono ancora in attesa di parti, e quale tecnico le ha?"
- "Mostra l'ordine 10482 con le sue parti, servizi e commenti."
- "Crea un lead per Anna Petrova, sostituzione dello schermo iPhone 14, dal sito web."
- "Sposta l'ordine 10482 in Pronto per il ritiro e aggiungi il commento: il cliente ha chiamato, verrà venerdì."
- "Quali fatture del mese scorso sono ancora non pagate?"
FAQ
Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Da dove proviene la chiave API? In RO App apri Impostazioni, API e copia la chiave API in RO_APP_API_KEY. Appartiene al tuo profilo utente e può essere rigenerata nella stessa pagina. RO App era precedentemente chiamato RemOnline.
Cosa copre? Ordini di riparazione con stati, articoli e commenti, clienti come persone e organizzazioni, richieste (lead), prodotti e magazzini, fatture, conti finanziari con le loro transazioni, attività e dipendenti. Le fatture e i pagamenti sono solo in lettura, e il connettore non crea pagamenti, trasferimenti o rimborsi. I livelli di stock per magazzino non sono disponibili, perché l'API v2 non documenta alcuna chiamata per essi.
Qualcosa si installa spento? No. Ogni strumento è attivo, e niente viene eliminato da questo connettore; le scritture creano o aggiornano ordini, clienti, lead e attività, quindi l'AI ti mostra ciascuno e aspetta un sì.
Prossimi passi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?