Come collego Picasi a Claude Code tramite MCP?
Di cosa si tratta
Configuri Picasi come server MCP in Claude Code. Dopodiché, nella chat di Claude potrai chiedere direttamente gli Updates sui tuoi concorrenti, gestire le fonti o visualizzare i Report — senza aprire l’app Picasi.
Cosa ti serve
- Un token API Picasi (istruzioni: Crea un token API)
- L’URL MCP (lo trovi in Impostazioni del Workspace → Connessioni IA)
Opzione A: configurazione tramite CLI
-
Tieni a portata di mano il token e l’URL
Apri Impostazioni del Workspace → Connessioni IA in Picasi e copia l’URL MCP. È
https://picasi.app/mcped è lo stesso per tutti i Workspaces: quale mostra il server lo decide il token. -
Aggiungi il server MCP
Esegui il seguente comando in un terminale:
Terminal window claude mcp add picasi \--transport http \--url https://picasi.app/mcp \--header "Authorization: Bearer DEIN_TOKEN"Sostituisci
DEIN_TOKENcon il tuo token. -
Verifica della connessione
Avvia Claude Code e digita:
Quali fonti sono presenti nel mio Workspace Picasi?
Se la connessione funziona, Claude risponderà con dati reali.
Opzione B: modificare direttamente .mcp.json
Se preferisci avere la configurazione come file nel progetto:
{ "mcpServers": { "picasi": { "type": "http", "url": "https://picasi.app/mcp", "headers": { "Authorization": "Bearer DEIN_TOKEN" } } }}Salva questo file come .mcp.json nella directory principale del tuo progetto. Claude Code lo leggerà automaticamente.
Variabili d’ambiente anziché testo in chiaro
Per i progetti il cui .mcp.json si trova su Git, non inserire mai il token in chiaro. Due metodi sicuri:
1. Configurazione globale di Claude Code
Invece di un .mcp.json specifico per il progetto, configura il server una volta a livello globale:
claude mcp add picasi \ --scope user \ --transport http \ --url https://picasi.app/mcp \ --header "Authorization: Bearer DEIN_TOKEN"Il server sarà quindi disponibile in tutti i progetti, senza .mcp.json nel repository.
2. Variabile d’ambiente in un file non sottoposto a commit
Per i server specifici del progetto: eseguire il commit di .mcp.json nel repository, ma leggere il token dall’ambiente.
{ "mcpServers": { "picasi": { "type": "http", "url": "https://picasi.app/mcp", "headers": { "Authorization": "Bearer ${env:PICASI_API_TOKEN}" } } }}Impostare la variabile PICASI_API_TOKEN in un file .env (in .gitignore) o direttamente nella shell in cui viene avviato Claude Code:
export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxxclaudeClaude Code legge la variabile solo all’avvio. Se il token viene modificato, è necessario riavviare Claude Code.
Più Workspaces
In presenza di più Workspaces Picasi (ad es. un’agenzia con più clienti), creare una voce di server separata per ogni Workspace e assegnarle un nome univoco:
{ "mcpServers": { "picasi-kunde-a": { "type": "http", "url": "https://picasi.app/mcp", "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" } }, "picasi-kunde-b": { "type": "http", "url": "https://picasi.app/mcp", "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" } } }}L’indirizzo è lo stesso in entrambe le voci, il Workspace sta nel token. Claude Code esegue gli strumenti dei server in spazi dei nomi separati (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), in modo da evitare qualsiasi confusione.
Il vecchio indirizzo con la sigla del Workspace
Le configurazioni più vecchie portano un indirizzo della forma https://picasi.app/mcp/t-xxxxxxxxxx, con la sigla del Workspace in fondo. Continua a funzionare invariato, non dovete cambiare nulla. Per le voci nuove usate https://picasi.app/mcp.