Come aggiungere un server MCP a un assistente IA

Un server remoto: aggiungere il suo URL

Gli assistenti che accettano server MCP remoti lo fanno di solito dalle impostazioni, in una sezione chiamata per esempio connettori, integrazioni, app o strumenti; nei piani team e business può essere necessario che un amministratore lo consenta prima. Si aggiunge un server indicandone un nome e l’URL dell’endpoint - l’indirizzo Streamable HTTP o SSE riportato nella pagina del server.

Se il server richiede l’accesso, l’assistente apre la pagina di accesso del servizio stesso e conserva l’autorizzazione concessa. Se la voce del registro dichiara un header, come Authorization con una chiave API, il client deve avere un campo per gli header personalizzati. Una volta collegato, l’assistente vede gli strumenti del server e può chiamarli durante una conversazione, di solito chiedendo conferma prima di un’azione che modifica qualcosa.

Un server locale: aggiungere il suo comando

Le app desktop, gli editor di codice e gli agenti da riga di comando che eseguono server locali leggono una configurazione che elenca per ogni server il comando, gli argomenti e le variabili d’ambiente. Una forma comune è un file JSON con un oggetto mcpServers; gli agenti da riga di comando hanno spesso un comando che scrive automaticamente la stessa voce. Il client avvia ogni programma quando serve e lo arresta quando si chiude.

Esempio (nomi segnaposto):

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "example-mcp-server@1.2.0"],
      "env": { "EXAMPLE_API_KEY": "<your key>" }
    }
  }
}

Quando la connessione non riesce

La maggior parte dei client mostra lo stato di ogni server e il suo elenco di strumenti. Se un server locale non si avvia, eseguirne il comando in un terminale: la causa più frequente è un ambiente di esecuzione mancante (Node.js, uv, Docker) o una variabile d’ambiente mancante. Se un server remoto viene rifiutato, verificare che il client supporti il suo trasporto e se il server richiede un header o un accesso.