Collegare DeepSeek al proprio studio

Che cos’è

DeepSeek consulta i dati del tuo studio (vendite, clienti, agenda, finanze) tramite DeepSeek Harness, lo strumento di DeepSeek per computer che supporta i connettori MCP. La connessione usa una chiave API del sistema, con le autorizzazioni dell’utente a cui appartiene la chiave. DeepSeek può solo consultare i dati: non modifica nulla nel sistema.

⚠️ Il sito e l’app di DeepSeek per cellulare (chat.deepseek.com) non supportano ancora i connettori personalizzati. Questo articolo verrà aggiornato quando li supporteranno.

Quando usarlo

Usi già i modelli di DeepSeek sul computer e vuoi fare domande sull’attività dello studio.
Vuoi creare analisi con i dati reali dello studio usando DeepSeek.

Prima di iniziare

Tieni a portata di mano l’indirizzo del connettore e una chiave API con “Consenti l’uso come connettore IA”, creati seguendo l’articolo Collega la tua IA. DeepSeek Harness deve essere installato sul computer. È ancora in versione di test, distribuita da DeepSeek, e la procedura di configurazione potrebbe cambiare.

Passo dopo passo

Passaggio 1 — Aggiungere il connettore

Nel file di configurazione di DeepSeek Harness (~/.dsh/profiles/web/cordis.patch.yml), aggiungi il seguente codice, sostituendo l’indirizzo con quello copiato da Copia indirizzo e hk_... con la tua chiave:

- insert:
    - id: mcp-heya
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: heya
        transport: streamable-http
        url: https://seu-dominio/mcp
        headers:
          Authorization: Bearer hk_...

L’indirizzo non deve avere una barra finale.

Passaggio 2 — Aprire DeepSeek Harness

Apri di nuovo DeepSeek Harness. Il connettore heya apparirà con gli strumenti listar_areas, buscar_ferramentas e executar_consulta.

Passaggio 3 — Fare una domanda

Per esempio, chiedi: “quanto ho venduto questa settimana nello studio?”.

Cosa succede dopo

DeepSeek individua la consultazione corretta, la esegue e risponde con i dati del sistema, in base alle autorizzazioni dell’utente a cui appartiene la chiave.
La chiave appare nella scheda API Key, con il valore di Ultimo utilizzo aggiornato.
Per revocare l’accesso, revoca la chiave nella scheda API Key: DeepSeek perderà l’accesso entro 30 secondi.

Errori comuni e domande

D: Posso usare l’app DeepSeek sul cellulare? R: Non ancora. L’app e il sito di DeepSeek non supportano i connettori personalizzati. Usa DeepSeek Harness sul computer.

D: Il connettore non si collega. Cosa devo controllare? R: Controlla che l’indirizzo termini con /mcp, senza barra finale, e che la chiave sia stata incollata per intero, includendo Bearer e uno spazio.

D: DeepSeek dice che la chiave deve avere l’opzione “Consenti l’uso come connettore IA”. Perché? R: La chiave è stata creata senza questa opzione. Modifica la chiave nella scheda API Key e seleziona Consenti l’uso come connettore IA.

D: Posso salvare la chiave in un file condiviso? R: Meglio di no. Chiunque abbia la chiave può consultare i dati dello studio con le autorizzazioni dell’utente a cui appartiene. Ogni persona dovrebbe usare la propria chiave.

D: DeepSeek può modificare i dati del sistema? R: No. Il connettore può solo consultare i dati. Le modifiche vanno fatte nel sistema.