Manisma
Inizia prova gratuita
Documentation menu
Docs/IT

Collega il tuo assistente IA

Manisma può collegarsi a un assistente IA che già utilizzi, come Claude Desktop, Claude Code, l’app desktop di ChatGPT o Codex CLI. Il collegamento usa il protocollo aperto Model Context Protocol. Puoi quindi porre domande e svolgere attività di pianificazione nella finestra di chat del tuo assistente.

Il tuo assistente, la tua IA

È il tuo assistente a ragionare. Manisma fornisce la pianificazione e i dati, ma non esegue una propria IA per questo collegamento. Il collegamento non consuma nemmeno le azioni IA incluse nel tuo piano Manisma.

Il pulsante Proposta IA in Manisma è separato. Questa funzione utilizza l’IA di Manisma e le azioni IA del tuo piano.

Cosa può fare il tuo assistente

Il tuo assistente può cercare commesse, clienti, tecnici, materiali, tipi di attività e dispositivi. Può creare e aggiornare commesse e clienti, pianificare una commessa con un tecnico e richiedere una proposta di pianificazione. Non può mai eliminare nulla.

Creare una chiave

Apri Gestione → Chiavi API, crea una chiave e copiala subito. La chiave viene mostrata una sola volta. Lettura, scrittura e pianificazione sono autorizzazioni separate. Una chiave di sola lettura può quindi cercare informazioni, ma non modificarle. Tratta la chiave come una password.

Installare il collegamento

Tutti i percorsi richiedono Node.js 22 o una versione successiva. Controlla la versione installata:

node --version

Recupera la chiave API da Gestione → Chiavi API. Viene mostrata una sola volta e ha l’aspetto di msk_ seguito da 40 caratteri esadecimali. Lettura, scrittura e pianificazione sono autorizzazioni separate.

Percorso 1: Claude Desktop

  1. Scarica https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Apri il file scaricato. Claude Desktop mostra una finestra di installazione.
  3. Incolla la chiave API quando viene richiesta. Viene archiviata in modo sicuro.

Non devi modificare file né usare un terminale.

Percorso 2: Claude Code

  1. Scarica https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Apri un terminale nella cartella del download ed esegui:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Sostituisci msk_your_key_here con la chiave API.
  2. In Claude Code, usa il comando /mcp per controllare il collegamento.

Percorso 3: Codex CLI e l’app desktop di ChatGPT

  1. Scarica https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Apri un terminale nella cartella del download ed estrai il file:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Aggiungi questo blocco a ~/.codex/config.toml, sostituendo il percorso e la chiave. Il percorso deve essere assoluto, perché ~ non viene espanso qui.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Esegui codex mcp list. Dovrebbe mostrare manisma come enabled.

In Windows, il file .mcpb è un archivio ZIP. Se Windows non riesce a estrarlo, rinomina l’estensione in .zip e usa Estrai tutto.

Cosa aspettarsi

Il tuo assistente chiede conferma prima di apportare modifiche e gestisce una commessa alla volta. Una proposta di pianificazione viene mostrata prima e non viene applicata finché non la confermi.

L’assistente non può vedere gli orari di lavoro né i giorni di assenza. Verifica quindi un orario proposto rispetto al calendario reale. Le proposte di pianificazione sono limitate a poche richieste ogni dieci minuti.

Limitazioni

Il collegamento funziona con i dati salvati in Manisma. Non sostituisce il tabellone di pianificazione ed è aggiornato solo quanto i dati salvati.

Still have questions about Manisma?

Contact us →