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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega RO App con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
RO App. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
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ì.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?