​
Informazioni sui server MCP

Il Model Context Protocol (MCP) è un protocollo aperto che crea connessioni standardizzate tra applicazioni di IA e servizi esterni, come la documentazione. Mintlify genera un server MCP a partire dalla tua documentazione e dalle specifiche OpenAPI, preparando i tuoi contenuti per l’ecosistema di IA più ampio, in cui qualsiasi client MCP (come Claude, Cursor, Goose e altri) può connettersi alla tua documentazione e alle tue API. Il tuo server MCP espone strumenti che permettono alle applicazioni di IA di cercare nella tua documentazione e di interagire con le tue API.

​
Accesso al tuo server MCP

I server MCP possono essere generati solo per la documentazione pubblica. La documentazione protetta da autenticazione per l’utente finale non è accessibile per la generazione del server.
Mintlify genera automaticamente un server MCP per la tua documentazione e lo ospita all’URL della documentazione con il percorso /mcp. Ad esempio, il server MCP di Mintlify è disponibile all’indirizzo https://mintlify.com/docs/mcp. Puoi visualizzare e copiare l’URL del tuo server MCP nella tua dashboard. Il percorso /mcp è riservato ai server MCP ospitati e non può essere utilizzato per altri elementi di navigazione.

​
Configurare il server MCP

Tutti i server MCP includono per impostazione predefinita lo strumento search, che consente agli utenti di cercare informazioni nella tua documentazione da altri strumenti. Se disponi di un piano Pro o Enterprise, puoi esporre gli endpoint della tua specifica OpenAPI come strumenti MCP. Per esporre gli endpoint come strumenti MCP, utilizza l’oggetto mcp all’interno dell’estensione x-mint, a livello di file o di endpoint. Ad esempio, il server MCP di Mintlify include strumenti per creare chat dell’Assistente, ottenere aggiornamenti di stato e attivare aggiornamenti. I server MCP adottano un approccio incentrato sulla sicurezza, in cui gli endpoint API non sono esposti per impostazione predefinita. Devi abilitare esplicitamente gli endpoint per renderli disponibili come strumenti MCP. Esporre solo gli endpoint sicuri per l’accesso pubblico tramite strumenti di IA.
​
mcp
object
Configurazione MCP per l’endpoint.

​
Configurazione a livello di file

Abilita MCP per tutti gli endpoint per impostazione predefinita in un file di specifica OpenAPI ed escludi selettivamente quelli da omettere: 
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // Disattiva MCP per questo endpoint
          }
        },
        // ...
      }
    }
  }
}

​
Configurazione a livello di endpoint

Abilita MCP per endpoint specifici: 
{
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": true,
            "name": "get-users",
            "description": "Recupera un elenco di utenti"
          },
          // ...
        }
      }
    },
    "/api/v1/delete": {
      "delete": {
        // Nessun `x-mint: mcp`, quindi questo endpoint non è esposto come strumento MCP
        // ...
      }
    }
  }
}

​
Utilizzo del tuo server MCP

Gli utenti devono collegare il tuo server MCP ai loro strumenti di IA preferiti.
  1. Rendi l’URL del tuo server MCP pubblicamente accessibile.
  2. Gli utenti copiano l’URL del tuo server MCP e lo aggiungono ai loro strumenti.
  3. Gli utenti accedono alla tua documentazione e agli endpoint API dai loro strumenti.
Ecco alcuni modi in cui puoi aiutare gli utenti a connettersi al tuo server MCP:

​
Esempio: collegamento al server MCP di Mintlify

Collegati al server MCP di Mintlify per interagire con la Mintlify API e cercare nella nostra documentazione. Otterrai risposte più accurate su come usare Mintlify nel tuo ambiente locale e vedrai come puoi aiutare i tuoi utenti a collegarsi al tuo server MCP.

​
Autenticazione

Quando abiliti un endpoint API per MCP, il server include i requisiti di autenticazione definiti in securitySchemes e securityRequirement di OpenAPI. Eventuali chiavi vengono gestite direttamente dallo strumento e non vengono archiviate né elaborate da Mintlify. Se un utente chiede al proprio strumento di IA di chiamare un endpoint protetto, lo strumento richiederà all’utente, in quel momento, le credenziali di autenticazione necessarie.

​
Monitoraggio del tuo server MCP

Puoi visualizzare tutti gli strumenti MCP disponibili nella sezione Strumenti disponibili della pagina del server MCP nella tua dashboard.
Dashboard MCP con la sezione Strumenti disponibili evidenziata

​
Risoluzione dei problemi