Assistente IA (MCP)

CongPlan può essere collegato a un assistente IA tramite l'interfaccia MCP (Model Context Protocol). Così puoi porre domande di pianificazione in linguaggio naturale o dettare le voci invece di navigare tra i menu. L'assistente legge e scrive gli stessi dati dell'app, quindi ogni azione passa attraverso gli stessi controlli di autorizzazione, gli stessi controlli sui conflitti e lo stesso registro di controllo.

Standard aperto

MCP è uno standard aperto, perciò il collegamento funziona con qualsiasi assistente compatibile con MCP. CongPlan mette a disposizione un endpoint MCP per ogni congregazione e usa OAuth 2.1 per l'autorizzazione. Se il tuo client supporta OAuth, ti collegherai con il solo URL dell'endpoint e accederai tramite CongPlan — nessun token necessario. Un token di accesso personale serve solo per i client senza supporto OAuth, o quando hai bisogno di una credenziale statica e di lunga durata.

Prima di iniziare

L'accesso MCP è disattivato in modo predefinito. Sono necessari due passaggi prima di poterlo utilizzare:

1. Un amministratore abilita l'interfaccia MCP per la congregazione (nelle impostazioni di amministrazione).
2. Un amministratore ti concede l'accesso in modo che tu possa collegare un assistente — tramite accesso OAuth oppure creando un token personale. Se non hai ancora l'accesso, puoi richiederlo dalla schermata MCP.

Collegare il tuo assistente

L'endpoint MCP di CongPlan è https://my.congplan.app/api/mcp.

Claude.ai / Claude Desktop

1. Apri le impostazioni del tuo account Claude (chiamate Impostazioni o Customize, secondo il piano) e trova Connettori > Aggiungi connettore personalizzato.
2. Incolla l'URL dell'endpoint qui sotto. Claude apre una finestra del browser per accedere tramite CongPlan e completa la connessione OAuth automaticamente — nessun token necessario.

https://my.congplan.app/api/mcp

Claude Code CLI

# OAuth (recommended): opens a browser to log in to CongPlan
claude mcp add --transport http congplan https://my.congplan.app/api/mcp

# Personal access token (fallback for non-interactive/CI use)
claude mcp add --transport http congplan https://my.congplan.app/api/mcp \
  --header "Authorization: Bearer cpm_your_token_here"

ChatGPT (connettore personalizzato)

1. In ChatGPT apri Impostazioni e trova Connettori (l'etichetta esatta può variare in base al piano o alla versione dell'app); scegli di aggiungere o creare un nuovo connettore.
2. Incolla l'URL dell'endpoint e completa l'accesso OAuth. Non serve alcun token: i connettori di ChatGPT supportano OAuth direttamente.

mcp.json generico (Cursor, Windsurf, ecc.)

I client che leggono il proprio elenco di server MCP da un file mcp.json supportano entrambi i tipi di connessione: usa OAuth se il client lo supporta, altrimenti un token bearer:

{
  "mcpServers": {
    "congplan-oauth": {
      "url": "https://my.congplan.app/api/mcp"
    },
    "congplan-token": {
      "url": "https://my.congplan.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cpm_your_token_here"
      }
    }
  }
}

Far configurare l'assistente da solo

Molti assistenti possono impostare da soli la connessione se incolli una breve istruzione:

Add the CongPlan MCP server at https://my.congplan.app/api/mcp using OAuth.
If OAuth isn't supported, ask me for a personal access token and use it as an
Authorization: Bearer header instead.

Token di accesso personali

Ti serve un token solo se il tuo client non supporta OAuth o se hai bisogno di una credenziale di lunga durata.

Una volta ottenuto l'accesso, crea un token personale nelle impostazioni del tuo account:

1. Apri Io > Integrazioni.
2. Scegli Crea token.
3. Assegna al token un nome, seleziona gli ambiti che può utilizzare e scegli una scadenza (massimo 90 giorni).
4. Copia il token subito: viene mostrato solo una volta e non può essere recuperato in seguito.

Usa un token nell'assistente compatibile con MCP che preferisci per collegarlo alla tua congregazione.

Ambiti

Gli ambiti controllano esattamente ciò che un token può fare. Sono suddivisi in lettura e scrittura per ogni area, per esempio:

• Lettura: profilo della congregazione, proclamatori, gruppi di servizio, adunanze, incarichi (inclusi gli incarichi tecnici), adunanze per il servizio di campo, compiti, testimonianza pubblica, discorsi pubblici in trasferta e (sensibile) assenze.
• Scrittura: compiti, adunanze per il servizio di campo, incarichi, adunanze, testimonianza pubblica e le tue richieste di cessione o iscrizioni.

Concedi solo gli ambiti di cui hai davvero bisogno. Un token può essere revocato in qualsiasi momento.

Richieste basate sui nomi

Quando chiedi all'assistente di agire per proclamatori nominati, per esempio «Inserisci un'assenza per Linda e Tim», deve prima collegare quei nomi agli ID interni dei proclamatori in CongPlan. Concedi l'ambito Lettura proclamatori insieme all'ambito di scrittura corrispondente, per esempio Scrittura assenze, così l'assistente può trovare le persone da modificare.

Se manca l'ambito di lettura dei proclamatori, l'assistente non può trovare in modo sicuro la persona giusta. Dovrebbe chiederti di aggiungere quell'ambito o di fornire gli ID esatti. Se un nome manca o corrisponde a più proclamatori, dovrebbe chiedere chiarimenti invece di indovinare.

Esempi di richieste

Ciò che dici dipende dall'assistente, ma le richieste tipiche hanno questo aspetto:

• «Chi è incaricato nell'adunanza infrasettimanale della prossima settimana?»
• «Quali parti non sono ancora assegnate per l'adunanza del fine settimana del 14 luglio?»
• «Quali adunanze sono previste la prossima settimana?»
• «Inserisci il fratello Müller come oratore per il discorso pubblico del 14 luglio.»
• «Crea un compito: controllare i microfoni per l'adunanza del fine settimana di sabato.»
• «Mostrami tutte le adunanze per il servizio di campo di questa settimana con conduttore e punto d'incontro.»
• «Chi ha il microfono o il servizio audio/video questo fine settimana?»
• «Quali dei nostri oratori hanno un discorso pubblico in trasferta programmato il mese prossimo?»
• «Crea l'adunanza del fine settimana del 16 agosto.»

L'assistente propone l'azione; viene salvata attraverso gli stessi percorsi di una voce inserita manualmente, inclusi i controlli di idoneità e di conflitto. Quando gli chiedi di creare una nuova adunanza, CongPlan applica automaticamente il modello di programma corrispondente — lo stesso che otterresti creandola a mano — così l'adunanza non nasce vuota. Se nessun modello corrisponde (o chiedi esplicitamente un'adunanza vuota), viene creata senza programma.

Anonimizzato per impostazione predefinita

L'interfaccia MCP fornisce al tuo assistente gli ID interni dei proclamatori, non i nomi. La pianificazione, le statistiche e i controlli di idoneità funzionano tutti su questi ID. Quando l'assistente verifica chi è stato incaricato di recente per bilanciare il carico, valuta questa cronologia in forma anonima, senza vedere chi sono le persone.

I nomi vengono risolti solo alla fine, per la risposta che ti viene mostrata, e solo per le poche persone che quella risposta effettivamente menziona. Questa ricerca è un passaggio separato che richiede l'ambito Lettura proclamatori e restituisce soltanto i nomi visualizzati per gli ID richiesti, senza elenco completo e senza ulteriori dettagli. Senza questo ambito l'assistente continua a lavorare con gli ID, semplicemente non può associarvi i nomi.

Autorizzazioni e sicurezza

• L'assistente può fare solo ciò che il tuo ruolo e i tuoi ambiti OAuth o del token consentono: valgono la stessa isolazione della congregazione e le stesse regole di autorizzazione dell'app.
• Ogni azione viene registrata nel registro di controllo.
• I token sono personali. Tratta un token come una password e revocalo quando non ti serve più.

Correlati

• Autorizzazioni
• Compiti