Logo iTasksiTasks
Argomento della documentazione

Collega agenti IA

Collegamenti IA personali dal profilo: autorizzazioni dei membri, istruzioni complete, URL MCP e aggiornamento delle chiavi di accesso.

Collega un agente IA esterno allo spazio di lavoro iTasks selezionato, per farlo lavorare a tuo nome. L’agente usa le tue autorizzazioni attuali, non quelle del proprietario: può accedere soltanto ai progetti, ai dati e alle azioni disponibili per te.

Prima di collegare un agente

Lo spazio di lavoro selezionato deve avere un abbonamento PRO attivo. Il proprietario ha accesso automatico. Gli altri membri, compresi gli amministratori, devono ricevere un’autorizzazione separata dal proprietario o da un amministratore.

Come collegare il tuo agente

  1. Seleziona lo spazio di lavoro che ti serve.
  2. Apri il tuo profilo toccando l’avatar e scegli «Collega agenti IA». Questa schermata mostra solo lo spazio di lavoro attuale.
  3. Tocca «Copia istruzioni» e invia l’intero testo al tuo agente IA. Contiene già gli indirizzi di collegamento, l’utente, lo spazio di lavoro e le regole da seguire.
  4. Se il client richiede l’aggiunta manuale del server, usa l’URL MCP sotto le istruzioni con il trasporto Streamable HTTP. Non serve un token Bearer aggiuntivo.
  5. Chiedi all’agente di chiamare prima get_current_context e verificare utente e spazio di lavoro senza modificare i dati. Poi assegnagli un incarico preciso.

Usa un client che supporti MCP remoto o REST/OpenAPI. Incollare le istruzioni non garantisce la configurazione automatica in ogni client: potrebbe essere necessario aggiungere il server manualmente o confermare l’accesso. Gli indirizzi REST, OpenAPI e di discovery sono già inclusi nelle istruzioni complete.

Profilo: accesso al collegamento degli agenti IACollegamento IA: istruzioni complete e URL MCP separato

Come concedere l’accesso a un membro

Il proprietario o un amministratore apre «Amministrazione → Membri», seleziona un utente e attiva «Accesso tramite MCP/API» nelle sue impostazioni. Per attivarlo serve PRO. Per il proprietario compare «Automatico per il proprietario». Questa autorizzazione non modifica il ruolo dell’utente né il suo accesso ai progetti. Gli amministratori possono autorizzare anche sé stessi, ma non disattivare l’accesso automatico del proprietario.

Dopo aver ricevuto l’autorizzazione, il membro apre il proprio profilo e copia le proprie istruzioni. Chi gestisce le autorizzazioni vede lo stato dell’accesso, non il link personale di un altro utente. Non condividere le chiavi del proprietario con i membri.

Membri e ruoli

Aggiornare le chiavi e revocare l’accesso

Usa lo stesso link personale in tutti i tuoi client IA per questo spazio di lavoro. Copiarlo o riaprire la schermata non lo modifica. Dopo la conferma, «Aggiorna chiavi di accesso» invalida immediatamente il vecchio link in tutti i client. Copia le nuove istruzioni e aggiorna ogni collegamento; i link degli altri membri non cambiano.

Per revocare l’accesso a un membro, disattiva «Accesso tramite MCP/API» nelle sue impostazioni. Il server rifiuta immediatamente le richieste successive. Una schermata già aperta può continuare a mostrare il vecchio link finché non viene riaperta, ma questo non significa che il link funzioni ancora. Anche la rimozione del membro o il blocco del suo account interrompono l’accesso.

Autorizzazioni, limiti e sicurezza

  • L’autorizzazione a collegarsi non è un incarico a modificare i dati. L’agente deve agire su tua richiesta; i progetti privati, i file protetti degli altri utenti e le azioni non consentite rimangono inaccessibili.
  • Attività, commenti, monitoraggio del tempo e HelpDesk rispettano le tue autorizzazioni. «Le mie attività» indica quelle assegnate a te. Le modifiche vengono effettuate a tuo nome.
  • I limiti delle richieste sono condivisi dallo spazio di lavoro e da tutti i collegamenti. Non corrispondono al consumo di token IA del modello. In caso di HTTP 429, il client deve rispettare Retry-After.
  • Quando PRO scade, i collegamenti vengono sospesi. Il rinnovo ripristina il funzionamento dell’autorizzazione e del link esistenti, se l’accesso non è stato revocato.
  • Il link e le istruzioni contengono segreti. Condividili solo con un client IA fidato, mai nelle chat del team, negli screenshot, nei log o nei repository. Nelle illustrazioni, i campi segreti sono nascosti.

Guide correlate

Membri e ruoli · Profilo e lingua · Abbonamento e limiti

Argomenti correlati

Vuoi provare nell’app?

Apri iTasks in Telegram e torna qui quando ti serve una guida passo passo.

Apri iTasks

Scopri altre funzionalità