# MCP: cosa sono e come si utilizzano

Model Context Protocol (MCP) è uno standard aperto per la comunicazione tra Agenti AI e sistemi esterni.

In piattaforma sono disponibili molteplici MCP già preconfigurati, ma ne puoi anche creare di nuovi.

Gli MCP permettono una c**omunicazione bidirezionale tra LLM e risorse esterne**, permettendo al tuo Agente di interagire facilmente con tutti gli strumenti (tool) messi a disposizione dal server MCP.

## Server MCP: cosa sono e come funzionano dietro le quinte?

### Cosa sono gli MCP

I server MCP espongono delle "capacità" che il tuo Agente AIsuru può utilizzare. Tra queste "capacità", troviamo:

* **Strumenti** (tool) -> azioni che il tuo Agente può eseguire (es. per creare un evento sul calendario);
* **Risorse** -> dati che il tuo Agente può leggere (es. gli eventi della giornata di oggi);
* **Prompt** -> template di istruzioni predefinite che il server MCP mette a disposizione - sono scorciatoie per le interazioni più comuni.

### Come funzionano gli MCP

Quando aggiungi un MCP al tuo Agente su AIsuru, la piattaforma creerà automaticamente due funzioni avanzate distinte:

* Una permette di leggere la lista di tool disponibili;
* L'altra, invece, permette di eseguire questi tool.

Ogni volta che l'LLM lo ritiene opportuno, il tuo Agente:

* Chiamerà la funzione che permette di leggere la lista dei tool disponibili;
* Deciderà quali tool chiamare e con quali parametri (in base alla richiesta dell'utente).

## Come attivare e testare un MCP

### MCP su AIsuru: come si attivano?

Per attivare un MCP:

1. Accedi alla sezione MCP del tuo Agente:
   1. Dall'homepage di AIsuru, premi su "Gestisci" in corrispondenza dell'Agente;
   2. Nella barra laterale, premi sulla voce "MCP".
2. Nella griglia degli MCP puoi:
   1. Creare un MCP personalizzato;
   2. Attivarne uno esistente.

Per ogni MCP troverai:

* Nome dell'MCP (es. "MongoDB MCP Server", "PostgreSQL MCP Server");
* Tag di categoria (es. "mongodb", "generic");
* Descrizione breve;
* Numero di parametri per l'MCP.

### Cosa fare dopo aver attivato un MCP

Dopo aver attivato il tuo MCP è fondamentale:

1. [**Aggiornare le istruzioni del tuo Agente**](/ai-generativa/prompt-engineering.md): devi spiegargli a cosa serve l'MCP, quando e come utilizzarlo;
2. **Testare l'MCP:** Per testare un MCP dovrai aprire una conversazione con il tuo Agente (usa la sezione "Prova"). Se qualcosa non va, guarda lo [storico delle conversazioni](/analisi-ottimizzazione/analisi-e-ottimizzazione-dellagente/conversazioni.md) per verificare la risposta dell'MCP. Se l'MCP non viene chiamato, assicurati di spiegare meglio quando va chiamato nelle istruzioni, oppure chiedi esplicitamente all'Agente di usare l'MCP per rispondere alla tua domanda.

{% hint style="info" %}
In caso di dubbi, puoi chiedere a Manuela di aiutarti o di aprire un ticket di supporto.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-cosa-sono-e-come-si-utilizzano.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.