Connettore MCP/Strumenti

In breve. L'elenco degli strumenti che il Connettore MCP mette a disposizione dell'intelligenza artificiale, divisi per area, con i flussi tipici (allegati e OCR, interrogazione dei dati, previsioni, anonimizzazione). Gli strumenti effettivamente visibili dipendono dai prodotti attivi e dai permessi dell'utente.

Si applica a: Connettore MCP

Come funzionano

L'utente scrive la richiesta in linguaggio naturale; l'AI sceglie lo strumento e lo usa per suo conto. Gli strumenti che leggono funzionano subito; quelli che modificano dati mostrano un'anteprima e chiedono conferma.

Gli strumenti per area

Area	Strumenti (nome tecnico)	A cosa servono
Logistica (Assistant Evolution)	`logistica_create_transport_services` e gli altri strumenti di Evolution	Inserire servizi di trasporto in blocco (anche da allegati letti con OCR), consultare servizi e viaggi.
Ticket CRM	`crm_list_tickets`, `crm_get_ticket`, `crm_get_ticket_brief`, `crm_create_ticket`, `crm_update_ticket`, `crm_patch_ticket`, `crm_add_ticket_comment`, `crm_add_ticket_worklog`, `crm_update_ticket_worklog`, `crm_move_ticket_phase`, `crm_resolve_ticket`, `crm_close_ticket`, `crm_send_ticket_email`, `crm_read_ticket_attachment`, `crm_list_ticket_statuses`, `crm_list_ticket_phases`, `crm_list_ticket_assignees`	Cercare, aprire e lavorare i ticket: commenti, ore, fasi, chiusura, email al cliente.
Richieste di assistenza	`crm_list_assistance_requests`, `crm_get_assistance_request`, `crm_convert_assistance_request`, `crm_list_portal_tokens`, `crm_revoke_portal_token`	Gestire le richieste in attesa e convertirle in ticket.
Email	`crm_list_mailboxes`, `crm_list_inbox_threads`, `crm_read_email_thread`, `crm_search_emails`, `crm_read_email_attachment`, `crm_send_email`, `send_email`, `open_email_app`	Leggere e cercare la posta collegata al CRM, preparare e inviare email.
Offerte	`crm_list_offers`, `crm_get_offer`, `crm_create_offer`, `crm_upsert_offer`	Preparare e aggiornare le offerte.
Marketing	`crm_list_marketing_lists`, `crm_create_marketing_list`, `crm_add_marketing_list_members`, `crm_add_marketing_list_members_by_filter`, `crm_search_campaign_recipients`, `crm_create_campaign`, `crm_update_campaign`, `crm_list_campaigns`, `crm_get_campaign_stats`, `crm_get_campaign_follow_up`, `crm_mark_campaign_contact_hot`, `crm_create_opportunity_from_campaign`, `crm_upload_campaign_asset`, `crm_set_marketing_consent`, `crm_update_marketing_profile`, `crm_erase_marketing_data` e altri	Creare liste e campagne, seguirne i risultati, gestire consenso e profilo.
Anagrafiche e informazioni commerciali	`crm_enrich_company`, `enrich_companies_excel`, `creditsafe_companysearch`, `creditsafe_companycreditreport`	Arricchire le anagrafiche, cercare aziende e ottenere report di affidabilità (Creditsafe).
Integrazione TMS esterno	`crm_list_levia_customers`, `crm_list_levia_shipments`, `crm_get_levia_shipment`, `crm_list_levia_trips`, `crm_get_levia_trip` e altri	Consultare dati del TMS Levia, dove l'integrazione è attiva.
Telefonia	`make_calls`, `open_call_app`, `get_call_transcripts`	Avviare chiamate e leggere le trascrizioni.
Dati e query	`search_db_schema`, `describe_db_schema`, `validate_db_query`, `execute_db_query`, `export_db_query`	Interrogare i dati in sola lettura ed esportarli.
Previsioni	`list_forecast_metrics`, `forecast_metric`, `forecast_db_query`, `forecast_file`	Proiettare volumi, fatturato e andamenti su serie storiche (dal database o da un file CSV/Excel).
Allegati e OCR	`upload_mcp_attachment`, `ingest_attachments`, `get_attachment_workflows`	Caricare un file e leggerlo (testo e tabelle, OCR per le scansioni).
Privacy	`anonymize_document`, `anonymize_text`, `deanonymize_text`	Sostituire i dati personali con segnaposto prima dell'elaborazione e ripristinarli alla fine.
Documentazione	`documentazione_wiki_search`	Cercare in questa wiki per rispondere alle domande sull'uso dei prodotti.
Documenti (Assistant DocAI)	strumenti `docai_*`	Lavorare con DocAI per conto dell'utente.
Programmi registrati	`get_agent_tool_schema`, `invoke_agent_tool`	Usare i programmi di terzi registrati nel connettore (tramite OpenAPI o WSDL).

I flussi tipici

Da un allegato a un'operazione

upload_mcp_attachment carica il file (con AdA il file è già disponibile).
ingest_attachments ne estrae testo e tabelle (OCR per le scansioni). Non scrive nulla nei gestionali.
L'AI prepara i dati per la destinazione e usa lo strumento di scrittura (es. logistica_create_transport_services), mostrando l'anteprima e chiedendo conferma.

Interrogare i dati

search_db_schema (quale tabella?) → describe_db_schema (quali colonne?) → validate_db_query → execute_db_query o export_db_query. Le query sono solo in lettura e vengono validate prima dell'esecuzione.

Fare una previsione

list_forecast_metrics per vedere le metriche già pronte, poi forecast_metric; se nessuna metrica va bene, forecast_db_query con una query; per i dati di un file, forecast_file. Il risultato indica anche l'affidabilità della previsione. Le festività italiane sono considerate.

Proteggere i dati personali

anonymize_document o anonymize_text sostituiscono nomi, codici fiscali, IBAN, indirizzi, telefoni e altri dati personali con segnaposto (es. [PERSONA_1]), elaborando il documento solo in locale. L'AI lavora sul testo anonimizzato; alla fine deanonymize_text ripristina i dati originali in un file. Date e importi restano in chiaro.