Vai al contenuto

MCP Server

Optimo IoT mette a disposizione un server MCP remoto (Model Context Protocol) che consente ad assistenti AI, come Claude, ChatGPT o Mistral AI, di accedere in lettura ai dati della piattaforma:

  • metadati di asset e variabili (albero asset, elenco variabili, unità di misura, ...)
  • dati storici (timeseries), sia grezzi che aggregati
  • righe del registro dell'AIMS

URL del server MCP:

https://mcp.cloud.optimoiot.it/mcp

Nota

Il server MCP fornisce solo accesso in lettura ai dati della piattaforma. Non può essere utilizzato per modificare la configurazione o scrivere dati.

Per i dettagli su autenticazione, permessi e protezione dei dati, consulta Sicurezza del server MCP.

Le istruzioni di configurazione sono disponibili per i seguenti provider di chat LLM:

Aggiungere il server a Claude

Claude.ai / Claude Desktop

  1. Aprire Settings → Connectors
  2. Cliccare su Add custom connector
  3. Inserire un nome (es. Optimo IoT) e l'URL https://mcp.cloud.optimoiot.it/mcp
  4. Cliccare su Add
  5. Si apre la pagina di login di cloud.optimoiot.it per autorizzare l'accesso
  6. Una volta autorizzato, il connettore è disponibile per l'uso nelle conversazioni

Claude Code

Eseguire il seguente comando:

claude mcp add --transport http optimo-iot https://mcp.cloud.optimoiot.it/mcp

Al primo utilizzo, Claude Code apre la pagina di login di cloud.optimoiot.it per autorizzare l'accesso.

Aggiungere il server a ChatGPT

  1. Aprire Settings → Connectors
  2. Se i connettori personalizzati non sono visibili, abilitarli da Settings → Connectors → Advanced settings → Developer mode
  3. Cliccare su Create (in alto a destra nella pagina Connectors)
  4. Inserire un nome (es. Optimo IoT) e l'URL https://mcp.cloud.optimoiot.it/mcp, selezionando OAuth come metodo di autenticazione
  5. Cliccare su Create
  6. Si apre la pagina di login di cloud.optimoiot.it per autorizzare l'accesso
  7. Una volta autorizzato, abilitare il connettore Optimo IoT nel composer della chat (+ → More → il proprio connettore) per usarlo in una conversazione

Aggiungere il server a Mistral AI

  1. Aprire Vibe e andare su Contesto → Connettori
  2. Cliccare su Aggiungi connettore
  3. Inserire un nome (es. Optimo IoT data) e l'URL https://mcp.cloud.optimoiot.it/mcp
  4. Confermare l'aggiunta
  5. Si apre la pagina di login di cloud.optimoiot.it per autorizzare l'accesso
  6. Una volta autorizzato, abilitare il connettore Optimo IoT dal menu degli strumenti della conversazione per utilizzarlo

Aggiungere il server a Microsoft Copilot

Microsoft 365 Copilot non consente a un utente business di aggiungere direttamente un server MCP. È invece necessario creare un agente in Copilot Studio, configurando il server MCP come strumento (tool), pubblicarlo e renderlo disponibile nell'app Microsoft 365 Copilot.

Nota

La creazione di un agente in Copilot Studio richiede generalmente una licenza Copilot Studio (oppure una licenza Microsoft 365 Copilot che includa la creazione di agenti) e, in base alle impostazioni del tenant, potrebbe essere necessaria l'approvazione di un amministratore prima che l'agente sia visibile agli altri utenti.

Passo 1: creare un agente con il server MCP come strumento (Copilot Studio)

  1. Aprire Microsoft Copilot Studio ed effettuare l'accesso con il proprio account Microsoft 365 business
  2. Cliccare su Create → New agent (scegliendo di configurarlo manualmente invece di descriverlo)
  3. Assegnare un nome e una descrizione all'agente (es. Optimo IoT) e crearlo
  4. Aprire l'agente e andare sulla scheda Tools
  5. Cliccare su Add a tool → New tool → selezionare Model Context Protocol
  6. Compilare i dettagli dello strumento:
    • Server name: es. Optimo IoT
    • Server description: una breve descrizione di cosa fornisce lo strumento (e.g. Get timeseries data and AIMS logs for monitored industrial assets from Optimo IoT cloud)
    • Server URL: https://mcp.cloud.optimoiot.it/mcp
    • Authentication: OAuth 2.0
  7. Cliccare su Create, quindi confermare l'aggiunta dello strumento all'agente
  8. Salvare/testare l'agente: al primo utilizzo si apre la pagina di login di cloud.optimoiot.it per autorizzare l'accesso
  9. Cliccare su Publish (in alto a destra) per pubblicare l'agente

Passo 2: selezionare l'agente in Microsoft 365 Copilot

  1. In Copilot Studio, aprire l'agente → Channels e aggiungere/pubblicare il canale Microsoft 365 Copilot
  2. Se richiesto dall'organizzazione, attendere l'approvazione di un amministratore Microsoft 365 (Integrated apps nel Microsoft 365 admin center)
  3. Aprire Microsoft 365 Copilot (copilot.microsoft.com, oppure l'app Copilot in Teams/Office) e cliccare su Agents nella barra laterale sinistra
  4. Cercare l'agente per nome (es. Optimo IoT) tra gli agenti creati per la propria organizzazione, quindi aprirlo
  5. In alternativa, da qualsiasi conversazione Copilot, usare il selettore di agenti (+) per selezionare l'agente e includerlo nella conversazione