Business Central + Claude — guida setup

Pianificazione commesse, fatturazione e timecard del gruppo Commit Software / Dilaxia / Hubenture, direttamente in Claude.

Ci sono due modi di usarlo. Scegli il tuo:

Per la maggior parte delle persone

A  Claude.ai / Claude Desktop

Aggiungi Business Central come connettore e lo usi a chat, senza installare nulla sul PC.

Vai al percorso A ↓
Per chi vuole lavorare da terminale

B  Claude Code (CLI)

Installi Claude Code + bc-cli e operi da PowerShell.

Vai al percorso B ↓

A  Claude.ai / Claude Desktop (connettore + skill)

Serve un account Claude a pagamento (Pro, Max, Team o Enterprise; in Free è ammesso un solo connettore custom).

A1. Aggiungi il connettore Business Central

  1. Apri Customize → Connectors (oppure vai a claude.ai/customize/connectors).
  2. Click sul pulsante + accanto a Connectors, poi "Add custom connector".
  3. Inserisci:
    • Name: Business Central
    • URL: https://bc-mcp.dev-comm.it
    (Le Advanced settings con OAuth Client ID/Secret non servono: lasciale vuote.)
  4. Click "Add", poi segui il login OAuth che si apre nel browser (accedi col tuo account Microsoft del gruppo). Claude non vede mai la tua password.
Team / Enterprise: se l'opzione "Add custom connector" non compare, un Owner dell'organizzazione deve prima abilitarla in Organization settings → Connectors.

A2. Attiva il connettore in una conversazione

Il connettore si attiva per chat: nella conversazione click sul pulsante + in basso a sinistra (o digita /) → Connectors → attiva il toggle di Business Central. Da quel momento Claude può usare i suoi strumenti.

Col solo connettore Claude riceve già le regole di comportamento del server (anteprima prima di ogni modifica, convenzioni di dominio, ecc.). La skill (passo A3) le rinforza e aggiunge i workflow, ma non è obbligatoria per iniziare.

A3. (Consigliato) Aggiungi la skill bc-commesse

  1. Scarica lo ZIP della skill: bc-commesse.zip
  2. In Claude: Settings → Capabilities e assicurati che "Code execution and file creation" sia attivo (le skill lo richiedono).
  3. Vai in Customize → Skills → pulsante + → "+ Create skill" → "Upload a skill" e carica bc-commesse.zip.
  4. Fatto: Claude la userà in automatico quando lavori sulle commesse (o richiamala con /).
Team / Enterprise: "Skills" e "Code execution" potrebbero essere disabilitati finché un Owner non li abilita in Organization settings → Skills.

B  Claude Code — CLI (per power user)

B1. Installa Claude Code

Serve un account Claude a pagamento. Su Windows, in PowerShell:

irm https://claude.ai/install.ps1 | iex

Poi verifica e avvia:

claude --version
claude
In alternativa: winget install Anthropic.ClaudeCode.

B2. Installa bc-cli

  1. Scarica bc-cli.exe dalla pagina di download.
  2. Salvalo in una cartella nel PATH (es. C:\Users\<tuo>\bin).
  3. Autenticati: bc-cli login (login device-code: URL + codice da incollare nel browser).
  4. Verifica: bc-cli status e bc-cli whoami.
SmartScreen al primo lancio: "Windows ha protetto il PC" → "Ulteriori informazioni" → "Esegui comunque". Il file non è firmato; la SHA256 sulla pagina di download ne verifica l'integrità.

Aggiornamenti: bc-cli upgrade --yes.

B3. Installa la skill bc-commesse

Copia e incolla questo blocco in PowerShell: crea la cartella skill personale e scarica i file.

$dst = "$env:USERPROFILE\.claude\skills\bc-commesse"
New-Item -ItemType Directory -Force -Path "$dst\references" | Out-Null
irm https://bc-cli.dev-comm.it/skill/bc-commesse/SKILL.md -OutFile "$dst\SKILL.md"
irm https://bc-cli.dev-comm.it/skill/bc-commesse/references/comandi-bc-cli.md -OutFile "$dst\references\comandi-bc-cli.md"
"Skill installata in $dst"
Se lavori dentro il repo del progetto, la skill è già committata in .claude/skills/bc-commesse/ e Claude Code la trova in automatico — niente da installare.

B4. (Opzionale) Connettore MCP anche in Claude Code

Non necessario: in Claude Code la via consigliata è bc-cli + skill. Se però vuoi gli stessi strumenti come tool MCP nativi:

claude mcp add --transport http --scope user bc-mcp https://bc-mcp.dev-comm.it/mcp
# poi, dentro una sessione `claude`, autenticati via OAuth:
/mcp

Primo utilizzo

In entrambi i percorsi, prova a chiedere in italiano:

"Come sta la commessa 12345?"
"Cosa c'è da fatturare questo mese per il PM Rossi?"
"Mostrami le anomalie aperte sulle mie commesse"

Prima di qualsiasi modifica, Claude ti mostra un'anteprima e chiede conferma.

Se operi su una company diversa da COMM.IT (NSI, HUBENTURE, Dilaxia Nova, Diligo): dillo a Claude, oppure da CLI bc-cli select-company NSI.