Collegare Claude a digna¶

Questa guida collega Claude al digna MCP Server. Ti servono l'endpoint MCP della tua installazione di digna e una chiave API, come descritto nella Panoramica degli agenti IA.

Gli esempi usano https://digna.example.com/mcp come endpoint. Sostituiscilo con il tuo.

Scegliere come collegarsi¶

Per un'installazione di digna che gira all'interno della rete aziendale, usa Claude Code o Claude Desktop con un bridge locale.

Claude Code¶

1. Aggiungere il server¶

Metti la chiave API in una variabile d'ambiente, poi aggiungi il server:

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

La tua shell sostituisce $DIGNA_API_KEY con il suo valore quando esegui il comando, quindi Claude Code salva la chiave nella propria configurazione.

--scope stabilisce dove il server è disponibile:

2. Condividere il server con il team (facoltativo)¶

Per dare a tutti in un progetto lo stesso server, aggiungi un file .mcp.json nella radice del progetto. Non scrivere la chiave nel file. Claude Code sostituisce ${DIGNA_API_KEY} con il valore dell'ambiente di ciascuna persona:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Ogni persona imposta DIGNA_API_KEY con la propria chiave. La prima volta che Claude Code trova il file, chiede se usare i server che contiene.

3. Verificare la connessione¶

Dalla tua shell:

claude mcp list

Il server digna deve mostrare ✔ Connected. All'interno di una sessione di Claude Code, esegui /mcp per vedere il server e i suoi strumenti.

Claude Desktop con un bridge locale¶

Il file di configurazione di Claude Desktop avvia server MCP locali sulla tua macchina. Un piccolo bridge, il pacchetto open source mcp-remote, gira lì e inoltra ogni richiesta all'endpoint di digna con la tua chiave API. Poiché il bridge gira sulla tua macchina, funziona con digna all'interno della rete aziendale.

1. Installare Node.js¶

Il bridge richiede Node.js 18 o successivo. Claude Desktop usa la versione di Node.js installata sul tuo sistema. Verificala con:

node --version

2. Modificare il file di configurazione¶

Apri claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Aggiungi il server digna. Se il file ha già una sezione mcpServers, aggiungi lì la voce digna:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. Riavviare Claude Desktop¶

Chiudi completamente Claude Desktop e riavvialo. In una nuova chat, clicca + e apri Connectors: digna deve essere presente nell'elenco e attivato.

Connettore personalizzato¶

Un connettore personalizzato rende digna disponibile in claude.ai, Claude Desktop e nelle app mobili di Claude senza alcuna configurazione locale. È il cloud di Anthropic a collegarsi all'endpoint, quindi funziona solo quando:

• L'endpoint di digna è raggiungibile da Internet tramite HTTPS
• La tua organizzazione Claude dispone dell'opzione Request headers nella finestra di dialogo Add custom connector. Anthropic la offre in beta a un numero limitato di organizzazioni

1. Aprire le impostazioni dei connettori¶

• Piani Free, Pro, Max e Ultra: vai su Customize > Connectors e clicca Add custom connector.
• Piani Team ed Enterprise: un Owner va su Organization settings > Connectors, clicca Add, poi Custom, e sceglie Web se viene chiesto il tipo.

2. Inserire i dettagli del connettore¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: scegli authorization come nome dell'header, inserisci Bearer <api key> come valore, compresi la parola Bearer e lo spazio, e contrassegnalo come Required.
4. Clicca Add.

Nei piani Team ed Enterprise, i membri si collegano poi da Customize > Connectors, dove il connettore riporta l'etichetta Custom.

Claude non può modificare l'header di un connettore esistente. Per usare una nuova chiave, rimuovi il connettore e aggiungilo di nuovo.

Risoluzione dei problemi di Claude¶

claude mcp list mostra Failed to connect¶

Esegui claude mcp get digna per vedere il motivo. Un 401 significa che la chiave è stata rifiutata; vedi 401 Unauthorized. Claude Code avvisa anche in caso di spazi o di un a capo all'inizio o alla fine della chiave, che spesso si aggiungono quando la si copia.

digna non compare in Claude Desktop¶

• Verifica che sia installato Node.js 18 o successivo: node --version.
• Verifica che claude_desktop_config.json sia un JSON valido. Una virgola mancante impedisce il caricamento di tutti i server del file.
• Chiudi completamente Claude Desktop, non solo la finestra, e riavvialo.

Il connettore personalizzato non raggiunge il server¶

Il cloud di Anthropic non raggiunge l'endpoint. Verifica che sia raggiungibile da Internet tramite HTTPS con un certificato valido, oppure collegati invece tramite Claude Code.

Vedi anche¶

• Panoramica degli agenti IA: endpoint, chiave API, sicurezza e risoluzione dei problemi generale
• Gemini: collegare Antigravity o Gemini CLI
• digna Agentic: cosa possono fare gli agenti IA con digna