Collegare Picasi a Claude Code

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 del tuo Workspace (lo trovi in Impostazioni → Connessioni IA e token)

Opzione A: configurazione tramite CLI

Tieni a portata di mano il token e l’URL

Apri Impostazioni → Connessioni IA e token in Picasi e copia l’URL MCP (formato: https://picasi.app/mcp/t-xxxxxxxxxx).

Aggiungi il server MCP

Esegui il seguente comando in un terminale:

claude mcp add picasi \
  --transport http \
  --url https://picasi.app/mcp/t-xxxxxxxxxx \
  --header "Authorization: Bearer DEIN_TOKEN"

Sostituisci t-xxxxxxxxxx e DEIN_TOKEN con i tuoi valori effettivi.

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/t-xxxxxxxxxx",
      "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/t-xxxxxxxxxx \
  --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/t-xxxxxxxxxx",
      "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_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/t-aaaaaaa",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" }
    },
    "picasi-kunde-b": {
      "type": "http",
      "url": "https://picasi.app/mcp/t-bbbbbbb",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" }
    }
  }
}

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.

Argomenti correlati

Strumenti MCP — Panoramica Tutti gli strumenti MCP disponibili con i relativi parametri.