Picmim funziona con agenti IA esterni come Claude, Cursor e ChatGPT tramite il Model Context Protocol (MCP). Una volta connesso, un agente può consultare i tuoi account, post, calendario, libreria multimediale e dati analitici e, se glielo consenti, creare e programmare contenuti per tuo conto.
Cosa puoi fare
Un agente IA connesso agisce come un membro del team con accesso limitato. Può consultare gli account collegati, trovare e preparare bozze di post, individuare lacune nel calendario, recuperare contenuti multimediali dalla libreria, esaminare i dati analitici grezzi e aiutarti a rivedere i Piani di contenuti generati. Mantieni il controllo perché l’agente può eseguire solo le azioni autorizzate dal tuo workspace.
- Consulta i contenuti del workspace, inclusi account, post, calendario e dati analitici.
- Prepara bozze e programma post se la connessione dispone dell’accesso in scrittura.
- Suggerisce gli orari di pubblicazione in base agli spazi liberi nel calendario.
- Riassume i dati analitici e spiega le prestazioni con un linguaggio semplice.
- Rivede e riscrive gli elementi dei Piani generati, ne riprogramma la pubblicazione e richiede contenuti visivi, se dispone dell’accesso ai Piani.
Connettere un agente
Ogni client IA supportato prevede una procedura di connessione specifica. Sono inclusi ChatGPT, Grok, Muse Code, Claude, Cursor, Gemini CLI e VS Code con GitHub Copilot. Consulta la pagina di configurazione dei client IA per le istruzioni esatte relative al tuo client.
Sicurezza e controllo
Le connessioni OAuth e i token personali sono progettati per essere creati, condivisi in sicurezza all’interno del team e revocati.
- I membri possono rinnovare o revocare i propri token personali in qualsiasi momento.
- Gli amministratori del workspace possono consultare e revocare in qualsiasi momento qualsiasi credenziale del workspace, connessione OAuth o token personale.
- Viene memorizzata solo una versione sottoposta a hash del token personale, che quindi non può essere recuperato in chiaro.
- Ogni richiesta verifica nuovamente che il membro che ha effettuato la connessione faccia ancora parte del workspace.
- Imposta una scadenza per i token personali, così le credenziali valide a lungo termine scadono automaticamente.
Avviso: Se sospetti che un token o una connessione siano stati esposti, revocali subito dalle impostazioni del workspace, nella sezione MCP, e creane uno nuovo.
Se non funziona
La maggior parte dei problemi di connessione dipende da poche cause comuni.
- Problemi con il ciclo OAuth o con il consenso: disconnetti il connettore nel client IA e riconnettilo da zero.
- Credenziale scaduta o revocata: riconnettiti con OAuth oppure genera un nuovo token personale dalle impostazioni del workspace, nella sezione MCP.
- Ambito errato: per creare o modificare contenuti serve l’accesso in scrittura, tramite le funzionalità o un token personale con ambito di scrittura.
- L’azione è in attesa anziché in esecuzione: verifica se la connessione è stata impostata in modalità con approvazione obbligatoria.
- Certificato HTTPS locale: se stai eseguendo test con un’istanza locale di Picmim, potrebbe essere necessario che l’agente consideri attendibile il certificato locale o salti la verifica del certificato.
Suggerimento: Se l’agente si connette ma non riesce a eseguire un’azione, controlla prima le sue funzionalità o l’ambito del token.
Connettersi con OAuth
OAuth è il metodo consigliato per connettere un agente IA a Picmim. Non espone mai al client credenziali valide a lungo termine e ti permette di approvare esattamente i workspace a cui l’agente può accedere.
- Avvia la connessione dall’interno del client IA, ad esempio aggiungendo Picmim come connettore.
- Accedi a Picmim quando si apre il browser.
- Scegli quali workspace condividere con l’agente.
- Approva la connessione per completare la procedura.
Suggerimento: Le nuove connessioni OAuth iniziano con tutte le funzionalità supportate abilitate e l’esecuzione automatica attiva. In seguito, i proprietari del workspace possono disabilitare singole funzionalità o richiedere l’approvazione per ogni azione di scrittura.
Funzionalità e approvazioni
Le funzionalità determinano cosa può fare un agente una volta connesso, mentre la modalità di approvazione stabilisce se può agire immediatamente.
- Per impostazione predefinita, una nuova connessione può usare tutte le funzionalità supportate ed esegue le azioni automaticamente.
- Il proprietario del workspace può disabilitare le singole funzionalità che l’agente non dovrebbe avere.
- Il proprietario del workspace può impostare la connessione in modalità con approvazione obbligatoria, così ogni azione di scrittura attende l’approvazione in Picmim prima di essere eseguita.
- Ogni richiesta continua a rispettare il ruolo del membro che ha effettuato la connessione nel workspace, indipendentemente dalle impostazioni delle funzionalità.
Crediti e ruoli del workspace
Il lavoro svolto dall’agente per tuo conto non è separato dal resto: utilizza le stesse risorse del workspace disponibili nell’app.
- Le attività IA, come la generazione di piani, didascalie o contenuti visivi, utilizzano i crediti del workspace alle stesse tariffe previste per l’uso nell’app.
- Si applicano comunque i ruoli e i limiti di credito del workspace, quindi l’agente può fare solo ciò che è consentito al membro che ha effettuato la connessione.
Token personali
I token personali sono un’alternativa a OAuth per i client e gli ambienti di automazione dotati di un archivio sicuro per i segreti, come un’integrazione lato server. Evitali nei client che non sono in grado di proteggere i segreti.
- Accedi a Picmim e apri il workspace desiderato.
- Apri le impostazioni del workspace e seleziona MCP.
- Crea un token con un nome e scegli un ambito: lettura o scrittura.
- Copia subito il token. Non potrai visualizzarlo di nuovo.
Avviso: Tratta un token personale come una password. Chiunque ne sia in possesso può accedere al tuo workspace con l’ambito che hai scelto.