Vai al contenuto principale

Endpoint del server

Il server MCP espone alcuni endpoint ben definiti. Conoscerli aiuta a configurare un client e a diagnosticare una connessione.

L’URL del server MCP

Il punto di accesso principale ha la forma https://vostro-sito.tld/api/index.php/v1/mcp. È l’indirizzo da comunicare al vostro client IA. Viene pubblicato tramite l’API dei servizi web di Joomla; l’URL esatto del vostro sito è riportato nelle Impostazioni del componente.

endpoint

Rilevamento OAuth (.well-known)

Alla radice del dominio sono disponibili due documenti di rilevamento:

  • /.well-known/oauth-protected-resource
  • /.well-known/oauth-authorization-server

Indicano automaticamente al client come autenticarsi, specificando gli endpoint di autorizzazione e i metodi supportati. Il client li legge autonomamente: non è necessaria alcuna configurazione manuale di OAuth.

Trasporto e formato

Gli scambi avvengono tramite HTTP, nel formato previsto dal protocollo MCP (JSON-RPC). Il server risponde alle richieste del client: elenco degli strumenti, chiamate agli strumenti e risultati.

Autenticazione OAuth 2.1
Endpoint del server