Salta ai contenuti
Apri l'app

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

  1. 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/mcp ed è lo stesso per tutti i Workspaces: quale mostra il server lo decide il token.

  2. 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_TOKEN con il tuo token.

  3. 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:

Terminal window
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:

Terminal window
export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude 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.

Argomenti correlati