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 aggiornamenti 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ù spazi di lavoro

In presenza di più spazi di lavoro Picasi (ad es. un’agenzia con più clienti), creare una voce di server separata per ogni spazio di lavoro 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.