Connessione Agenti AI

Picmim funziona con agenti AI esterni come Claude Desktop, Cursor e ChatGPT tramite il Model Context Protocol (MCP). Una volta connesso, un agente può leggere i tuoi account, post, calendario, libreria multimediale e analisi e, se lo consenti, creare e programmare contenuti per tuo conto.

Cosa puoi fare

Un agente AI connesso agisce come un membro del team con accesso limitato. Può consultare i tuoi account connessi, trovare e bozzare post, individuare lacune nel tuo calendario, prelevare media dalla tua libreria, generare immagini e rispondere a domande sulle tue analisi. Mantieni il controllo perché ogni azione che l'agente può intraprendere è stata concessa tramite il suo token di accesso.

1. Leggi cosa c'è nel tuo spazio di lavoro, inclusi account, post, calendario e analisi.
2. Bozza e programma post quando il token ha accesso in scrittura.
3. Suggerisci orari di pubblicazione in base alle lacune del tuo calendario.
4. Riassumi le analisi e spiega le prestazioni in linguaggio semplice.

Prima di iniziare

L'accesso MCP è attivato per ogni spazio di lavoro. Se non vedi la sezione Accesso MCP in Impostazioni, il tuo spazio di lavoro o piano potrebbe non averla ancora abilitata.

1. Accedi al tuo spazio di lavoro Picmim.
2. Apri Impostazioni e cerca Accesso MCP.
3. Assicurati che i tuoi account social siano già connessi. Gli account sono connessi all'interno di Picmim, non tramite l'agente AI.

Crea un token di accesso

Un token di accesso è la password che il tuo agente AI utilizza per raggiungere il tuo spazio di lavoro. Ogni token appartiene a uno spazio di lavoro e a un membro.

1. Vai su Impostazioni, quindi Accesso MCP.
2. Fai clic su Genera token.
3. Assegnagli un nome che corrisponda all'agente, come Claude Desktop.
4. Scegli un ambito: lettura o scrittura.
5. Scegli una scadenza, quindi genera il token.
6. Copia immediatamente il token. Non potrai più vederlo.

Accesso in lettura vs scrittura

Ogni token ha un ambito che decide cosa può fare l'agente.

1. Lettura consente all'agente di visualizzare account, post, calendario, media e analisi, ma non può modificare nulla.
2. Scrittura consente anche all'agente di creare e modificare post, importare media e generare immagini.
3. Scegli lettura a meno che tu non voglia specificamente che l'agente crei o modifichi contenuti.

Connetti un agente

Picmim espone un singolo endpoint MCP e un blocco di configurazione pronto per essere copiato nella pagina delle impostazioni di Accesso MCP. Utilizza quel blocco in modo che l'endpoint e il token siano sempre corretti.

1. Apri Impostazioni, quindi Accesso MCP.
2. Fai clic su Copia configurazione per copiare il blocco di configurazione del client.
3. Apri le impostazioni del server MCP del tuo agente, ad esempio il file di configurazione di Claude Desktop o il pannello MCP di Cursor.
4. Incolla la configurazione e salvala.
5. Riavvia l'agente se non si ricarica automaticamente.

{
  "mcpServers": {
    "picmim": {
      "type": "http",
      "url": "<endpoint from your MCP Access settings page>",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Sicurezza e controllo

I token sono progettati per essere sicuri da creare, condividere all'interno del tuo team e revocare.

1. Viene memorizzata solo una versione hash del token, quindi non può essere letta.
2. Ogni richiesta ricontrolla che il proprietario del token sia ancora un membro dello spazio di lavoro.
3. Revoca un token da Accesso MCP per disconnettere immediatamente l'agente.
4. Imposta una scadenza in modo che i token a lunga durata scadano da soli.
5. Controlla Ultimo utilizzo per verificare se un token è ancora attivamente in uso.

Se non funziona

La maggior parte dei problemi di connessione deriva da un piccolo numero di cause.

1. Prefisso Bearer mancante: l'intestazione Authorization deve iniziare con la parola Bearer, seguita da uno spazio e dal tuo token.
2. Token scaduto o revocato: generane uno nuovo da Accesso MCP.
3. Ambito errato: la creazione o la modifica di contenuti richiede un token di scrittura.
4. Certificato HTTPS locale: quando si testa con un Picmim locale, il tuo agente potrebbe aver bisogno di fidarsi del certificato locale o saltare la verifica del certificato.