Passa al contenuto principale

Integrazione MCP

MCP (Model Context Protocol) permette ad Agent di connettersi a server MCP esterni e ottenere automaticamente accesso agli strumenti, risorse e modelli di prompt che forniscono.

A differenza degli altri sottosistemi di Agent, i server MCP attualmente possono essere configurati solo dall'utente nella pagina di amministrazione — non esiste un'API di gestione CAT.agent.mcp per gli script. Tutto ciò che uno script può osservare è che gli strumenti di questi server vengono chiamati automaticamente durante le conversazioni.

Configurare un server MCP​

Aggiungerne uno nella pagina di amministrazione → Agent → MCP:

CampoDescrizione
NomeNome visualizzato per il server
URLEndpoint HTTP Streamable (JSON-RPC 2.0 su POST)
Chiave APIOpzionale, per l'autenticazione
Intestazioni personalizzateOpzionale
AbilitatoSe il server è attivo

Il client MCP di ScriptCat utilizza il trasporto Streamable HTTP e supporta la versione del protocollo 2025-03-26.

Un server MCP può fornire tre tipi di capacità:

CapacitàDescrizione
StrumentiRegistrati automaticamente come strumenti che Agent può chiamare
RisorseRisorse leggibili (testo/binario)
PromptModelli di prompt, con supporto per parametri

Utilizzarlo in una conversazione​

Gli strumenti dei server MCP abilitati appaiono automaticamente nell'elenco degli strumenti disponibili per le conversazioni di Agent, denominati usando il pattern mcp_{nome server sanificato}_{nomeStrumento} — l'IA decide se chiamarli in base all'intento dell'utente. Questo funziona in modo simile a come Skills si caricano automaticamente; gli sviluppatori di script di solito non devono preoccuparsi dei dettagli sottostanti.

Per verificare se uno specifico strumento MCP è disponibile, basta chiedere direttamente all'IA in una conversazione, o controllare l'elenco degli strumenti scoperti nei dettagli di quel server nella pagina di amministrazione.