Connettere la sua app AI a PlanRadar con MCP (Beta)

Panoramica

Connetta un'app AI come ChatGPT, Claude, Claude Code, Codex o LangDock a PlanRadar. Potrà poi fare domande all'app AI sui suoi progetti con parole sue, su tutti i suoi progetti contemporaneamente, e lasciare che apporti modifiche al posto suo, come aggiornare un ticket o aggiungere un commento.

L'app AI agisce come lei. Vede solo ciò che lei può vedere in PlanRadar e fa solo ciò che il suo utente è autorizzato a fare.

La connessione usa il Model Context Protocol (MCP). Non serve sapere come funziona MCP: copia un URL da PlanRadar nella sua app AI e accede con il suo utente PlanRadar.

Accesso e permessi

• Solo i suoi progetti. L'app AI vede solo i progetti di cui lei è membro, e solo ciò che il suo ruolo in ciascun progetto le consente di vedere.
• Un solo interruttore per tutto l'account. Un amministratore dell'account attiva MCP una sola volta per l'account. Non esiste un'impostazione per singolo utente. Ogni utente connette e disconnette la propria app AI.
• Le modifiche sono sue. Ogni modifica apportata dall'app AI appare in PlanRadar come fatta da lei, per esempio nella cronologia del ticket, come una modifica che ha fatto lei stesso.

Attivare MCP per il suo account

Un amministratore dell'account esegue questa operazione una sola volta per tutto l'account. L'impostazione è visibile solo dopo che PlanRadar ha attivato la beta per il suo account.

Per attivare MCP:

1. Clicchi su Impostazioni
2. Clicchi su Account
3. Clicchi su Impostazioni dell'account
4. Selezioni Abilita MCP

Copiare l'URL del suo server MCP

Ogni utente ha bisogno dell'URL del server MCP per connettere la propria app AI.

Per copiare l'URL:

1. Clicchi su Impostazioni
2. Clicchi su Profilo
3. Clicchi su App AI connesse
4. Sotto URL del server MCP, clicchi su Copia

Per la maggior parte degli account l'URL è https://www.planradar.com/mcp. Gli account su un'altra istanza di PlanRadar hanno un proprio indirizzo, quindi usi sempre l'URL mostrato in questa pagina.

Connettere la sua app AI

Ogni app AI si connette allo stesso modo: aggiunge PlanRadar con l'URL del suo server MCP, accede con il suo utente PlanRadar e conferma nella pagina di PlanRadar.

Quando l'app AI le chiede come autenticarsi, scelga OAuth 2.0 with Dynamic Client Registration e lasci vuoti client ID e client secret. PlanRadar registra l'app per lei.

Se l'app AI è gestita dalla sua azienda, un amministratore di quell'app potrebbe dover prima consentire o aggiungere PlanRadar. Ogni scheda indica quando.

Cosa mostra la pagina di PlanRadar

Prima che un'app AI ottenga l'accesso, PlanRadar le mostra cosa potrà fare. Lo legga prima di cliccare su Connetti:

• Può visualizzare: i tuoi ticket, progetti, planimetrie, moduli, file e report.
• Può fare: per esempio creare e aggiornare ticket e commenti e aggiungere file a Documenti.
• Non può: eliminare nulla.

La pagina indica anche dove vanno i suoi dati: ciò che l'app AI legge viene inviato all'azienda che la fornisce ed elaborato lì. Per esempio, ciò che legge ChatGPT viene inviato a OpenAI.

Se PlanRadar non ha l'app AI nel suo elenco, la pagina la contrassegna come Non verificato da PlanRadar. Connetta solo app di cui si fida. Claude Code e Codex vengono eseguiti sul suo computer, quindi mostrano sempre questa indicazione.

Cosa può fare l'app AI

L'app AI lavora con gli stessi dati che lei vede in PlanRadar, nei progetti di cui è membro.

Può leggere:

• I suoi progetti e una panoramica dello stato di ciascun progetto
• I ticket: cercarli, leggerne dettagli, cronologia e allegati, vedere cosa è cambiato da una certa data e riassumerli
• I moduli (tipi di ticket) e gli utenti di un progetto
• I documenti: elencare e cercare file, leggere il testo di un file e ottenere un link di download
• Le posizioni e le planimetrie
• Le richieste di approvazione
• I report di progetto: elencarli e leggerli
• Il programma (sola lettura)

Può modificare:

• Creare e aggiornare ticket, comprese le risposte alle checklist
• Aggiungere commenti ai ticket
• Assegnare ticket
• Creare progetti, moduli e viste filtrate
• Caricare file in Documenti
• Invitare persone nel suo account via e-mail. Entrano come utenti interni
• Esportare ticket in PDF o Excel, con un link di download

Non può eliminare nulla.

Cosa può fare con l'app

Poiché l'app AI vede tutti i suoi progetti contemporaneamente, può fare domande che in PlanRadar richiederebbero molti clic. Chieda con parole sue, nella sua lingua. Per esempio:

Ottenere risposte su tutti i suoi progetti

• "Quale subappaltatore ha più ticket scaduti in tutti i miei progetti?"
• "Crea una tabella con una riga per progetto: ticket aperti, ticket scaduti e la prossima milestone del programma."
• "Cosa è cambiato nei ticket dei miei progetti da lunedì?"

Scrivere rapporti e aggiornamenti

• "Riassumi i progressi dell'Edificio B di questa settimana per il committente."
• "A che punto è l'Edificio A, cosa è scaduto e cosa blocca il completamento? Scrivilo come breve sintesi per la direzione."
• "Scrivi un aggiornamento sullo stato per l'acquirente dell'Appartamento 24. Ometti i nomi interni."
• "Descrivi i nostri moduli, i loro campi e stati come breve guida per i nuovi capocantiere."

Confrontare e verificare

• "Confronta il rapporto settimanale della settimana scorsa con quello di questa settimana ed elenca cosa è cambiato."
• "Leggi entrambi i rapporti di ispezione elettrica in Documenti e associa ogni difetto a un ticket. Elenca i difetti che non hanno ancora un ticket."

Aggiornare i ticket dalla chat

• "Imposta il ticket 4 su Risolto, aggiungi un commento che il chiudiporta è stato sostituito e sposta la scadenza a venerdì."
• "Crea un ticket nell'Edificio B: sigillatura antincendio mancante nel cavedio R3, livello 3, scadenza venerdì prossimo."

Combinare con la sua app AI

• Usi le funzioni proprie dell'app AI: "Mostra i ticket scaduti per subappaltatore come grafico a barre", "Esporta il risultato come file Excel", "Trasforma questo riepilogo in un PDF".
• Combini PlanRadar con altri connettori che la sua azienda usa già in quell'app AI, per esempio SharePoint: "Confronta i ticket aperti dell'Edificio B con l'elenco dei difetti in SharePoint."

Da tenere a mente

• L'app AI non può eliminare nulla.
• Il programma è in sola lettura. L'app AI non può spostare né modificare le attività del programma.
• L'app AI invita persone nel suo account, non in un progetto specifico. Aggiungerle a un progetto e impostarne ruolo e permessi si fa in PlanRadar.
• I nuovi moduli creati dalla chat possono avere solo campi semplici: testo breve, testo lungo, data, sì/no e utente. Aggiunga checklist ed elenchi in PlanRadar.
• Non può creare un link diretto alla posizione di un ticket su una planimetria.
• I file caricati dalla chat possono pesare fino a 25 MB per caricamento.
• Ogni connessione può inviare un numero limitato di richieste al minuto. Oltre questo limite, l'app AI riceve "Too many requests on this connection. Retry in N seconds."
• I link di download scadono: dopo 15 minuti per documenti e file dei ticket, dopo 60 minuti per esportazioni di ticket e report di progetto, e dopo 2 ore per le planimetrie. Chieda all'app AI un nuovo link se uno smette di funzionare.
• Le risposte dipendono dall'app AI che usa. Verifichi i numeri importanti in PlanRadar prima di agire di conseguenza.

Disconnettere un'app AI

Può disconnettere la sua app AI in qualsiasi momento. Perde subito l'accesso, e potrà connetterla di nuovo in seguito.

Per disconnettere un'app AI:

1. Clicchi su Impostazioni
2. Clicchi su Profilo
3. Clicchi su App AI connesse
4. Clicchi su Disconnetti accanto all'app
5. Clicchi su Disconnetti per confermare

Risoluzione dei problemi