MCP di AIsuru: quali sono e come si attivano

Questa pagina descrive come configurare correttamente i parametri per ogni MCP (Model Context Protocol) disponibile in AIsuru. Per ogni MCP troverai l'elenco completo dei parametri da inserire, con spiegazioni dettagliate su ciascun campo.

Gli MCP permettono al tuo Agente di interagire con servizi esterni e accedere a funzionalità avanzate, come interrogare database, generare immagini, automatizzare workflow e molto altro.

Questa pagina spiegherà nel dettaglio ogni MCP presente in piattaforma spiegando nello specifico:

• cos'è e come funziona;

• parametri di configurazione;

• come ottenere i parametri (se necessari);

• parametri Personalizzati.

Come funziona un MCP su AIsuru

Su AIsuru un MCP quando attivato crea due funzioni avanzate

• Una funzione per listare tutti tool

ESEMPIO:
"LISTA_TOOL_X_MCP_PROD"

• Una funzione per eseguire i tool

ESEMPIO:
"ESEGUI_TOOL_X_MCP_PROD"

Come configurare un MCP

Per configurare un MCP nel tuo Agente:

1. Accedi al pannello di gestione del tuo Agente;

2. Nella barra laterale, clicca su "MCP";

3. Seleziona l'MCP che desideri attivare dalla griglia disponibile;

4. Compila i campi obbligatori e, se necessario, quelli opzionali;

5. Clicca su "Crea MCP" per salvare la configurazione.

Una volta configurato, l'MCP sarà disponibile per il tuo Agente durante le conversazioni.

0. Creare un MCP personalizzato

Utilizza questa procedura se l'MCP desiderato non è presente tra quelli preconfigurati.

Dopo aver cliccato su Aggiungi un MCP personalizzato, si aprirà una finestra modale intitolata "Crea Nuovo MCP" potrai compilare diversi campi.

Parametri di configurazione:

• Nome (obbligatorio): digita un nome identificativo (es. "Custom MCP Server", "Integrazione CRM");

• Descrizione (obbligatorio): digita una descrizione dettagliata di cosa fa l'MCP;

• Prompt (facoltativo): inserisci istruzioni su come l'agente deve usare questo MCP;

• Token di autenticazione (facoltativo): incolla qui dentro il token di autenticazione dal tuo servizio esterno

• URL (obbligatorio): inserisci qua l'url identificativo del tuo mcp server

Nota: L'URL DEVE terminare con /mcp o /sse;

Esempi validi:
https://api.example.com/mcp;
https://mcp-server.mycompany.com/sse;
http://localhost:3000/mcp.

Esempi NON validi:
https://api.example.com (manca il suffisso);
https://api.example.com/api (suffisso errato).

Salvare l'MCP personalizzato

1. Controlla che tutti i campi obbligatori (Nome, Descrizione, URL) siano compilati;

2. Verifica che l'URL termini con /mcp o /sse;

3. Clicca sul pulsante "Crea MCP" in basso a destra;

4. Attendi il messaggio di conferma.

Per annullare: Cliccate su "Annulla" o sulla X in alto a destra.

1. AIsuru MCP Server

L'AIsuru MCP Server permette l'integrazione diretta con la piattaforma AIsuru AI, consentendo al tuo Agente di comunicare con altri agenti o funzionalità della piattaforma.

Questo MCP è particolarmente utile per:

• creare architetture multi-agente;

• permettere la comunicazione tra diversi agenti;

• accedere a funzionalità avanzate della piattaforma AIsuru.

Parametri di configurazione

• Backend Url (obbligatorio)

L'URL del backend AIsuru a cui connettersi.

Formato: https://backend.aisuru.com

Esempio: https://backend.aisuru.com

Questo parametro specifica l'indirizzo del server backend di AIsuru. Utilizza l'URL fornito dalla piattaforma.

• Engine Url (obbligatorio)

L'URL del motore AIsuru che elabora le richieste.

Formato: https://engine.aisuru.com

Esempio: https://engine.aisuru.com

Questo parametro indica l'endpoint del motore di elaborazione. Utilizza l'URL fornito dalla piattaforma.

• Tenant Url (obbligatorio)

L'URL specifico del tuo tenant AIsuru.

Formato: https://mytenant.aisuru.com

Esempio: https://aisuru.com

Ogni tenant ha un URL univoco che identifica la tua organizzazione sulla piattaforma AIsuru.

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON per estendere le funzionalità dell'MCP. Consulta la documentazione specifica dell'API AIsuru per i parametri disponibili.

Formato: {"timeout": 30, "retries": 3}

Nota: Modificare il prompt

Aggiungi una sezione dedicata all'MCP nel prompt esistente specificando con quale agente comunicare e quando, prendendo l'ID agente del agente selezionato.

Esempio di come si usa AIsuru MCP server in un system prompt:

Se l'utente vuole interrogare (NOME AGENTE), si tratta di un agente AIsuru che ha questo id: (ID), Rivolgi la domanda a questo agente

----

Se l'utente vuole interrogare Manuela, si tratta di un agente AIsuru che ha questo ID: b6fc6009-529f-42c1-91e6-5228f695fc81, Rivolgi la domanda a questo agente

2. Free Image Generator

Il Free Image Generator permette al tuo Agente di generare immagini basate su descrizioni testuali utilizzando il servizio Pollinations.ai.

Questo MCP è utile per:

• creare immagini personalizzate durante le conversazioni;

• generare contenuti visivi in base alle richieste degli utenti;

• arricchire le risposte con elementi grafici.

Parametri di configurazione

Questo MCP non richiede parametri obbligatori. La configurazione base è sufficiente per iniziare a generare immagini.

Parametri personalizzati

Puoi specificare parametri personalizzati in formato JSON per controllare la generazione delle immagini.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

I parametri comuni includono:

• timeout: tempo massimo di attesa in secondi;

• retries: numero di tentativi in caso di errore;

• api_version: versione dell'API da utilizzare;

• region: regione geografica del servizio.

Note importanti

Verifica i Termini e Condizioni del sito Pollinations.ai prima di utilizzare questo MCP in produzione.

Esempio di come si usa free image generator in un system prompt:

Free image generator permette al tuo agente ai di creare immagini, puoi chiedere l'attivazione di questo MCP in maniera dinamica durante una conversazione o anche specificando un evento in particolare nel system prompt.

ESEMPIO: 
Sei un assistente AI con capacità di generazione di immagini tramite Pollination MCP.

## Generazione di Immagini
Tu generi un immagine alla fine di ogni messagio del utente, usa il server MCP Pollination per generarle.

### Flusso di Lavoro:
1. Analizza la richiesta dell'utente
2. Crea un prompt dettagliato e descrittivo in inglese
3. Chiama lo strumento Pollination con i parametri appropriati
4. Presenta l'immagine generata all'utente

### Linee Guida per il Prompt Engineering:
- Sii specifico e descrittivo
- Includi dettagli su stile, atmosfera, illuminazione, composizione
- Evita termini vaghi - usa descrizioni concrete
- Per immagini realistiche: menziona stile fotografico, impostazioni della fotocamera
- Per immagini artistiche: specifica movimento artistico, tecnica, medium

### Esempio:
Utente: "crea un'immagine di un gatto spaziale"
Tu generi: "A majestic orange tabby cat wearing a detailed astronaut helmet, floating in deep space with nebula clouds in purple and blue, stars twinkling in background, cinematic lighting, photorealistic, 8k quality"

3. MongoDB MCP Server

Il MongoDB MCP Server consente al tuo Agente di connettersi a un database MongoDB ed eseguire operazioni di lettura e scrittura.

Questo MCP è utile per:

• interrogare database MongoDB;

• memorizzare e recuperare dati durante le conversazioni;

• gestire dati strutturati in formato documento.

Parametri

Parametro	Descrizione	Formato	Esempio
Connection String	Connection string completo di MongoDB	mongodb:// o mongodb+srv://	mongodb://localhost:27017/ mongodb+srv://user:[email protected]/
Database Name	Nome del database da utilizzare	Stringa alfanumerica	aisuru_test, production_db

Come ottenere i parametri

1. Dopo la registrazione, crea un cluster (scegli il piano M0 Free);

2. Clicca su "Connect" sul tuo cluster;

3. Scegli "Connect your application";

4. Seleziona Driver: Node.js o Python;

5. Copia il Connection String:

   mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/

6. Sostituisci <password> con la password del tuo database user;

7. Database Name: scegli tu (es. test_db, aisuru).

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON per configurare opzioni avanzate della connessione MongoDB.

Formato:

{
  "timeout": 30000,
  "maxPoolSize": 10,
  "retryWrites": true,
  "readPreference": "primary"
}

4. AIsuru Data Analysis

AIsuru Data Analysis è un MCP JavaScript che supporta l'analisi di dati con ambiente di esecuzione isolato. Consente al tuo Agente di eseguire codice JavaScript/TypeScript per analisi complesse, elaborazioni e business intelligence.

Questo MCP è utile per:

• analizzare dataset complessi;

• eseguire calcoli e aggregazioni;

• elaborare dati in tempo reale durante le conversazioni.

Parametri di configurazione

Questo MCP non richiede parametri obbligatori nella configurazione base. L'ambiente di esecuzione viene fornito automaticamente.

Parametri personalizzati

Puoi specificare parametri personalizzati in formato JSON per configurare l'ambiente di esecuzione.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

I parametri comuni includono:

• timeout: tempo massimo di esecuzione del codice in secondi (limite di 5 secondi);

• retries: numero di tentativi in caso di errore;

• api_version: versione dell'API;

• region: regione geografica.

Note importanti

• Il codice viene eseguito in un ambiente isolato (isolated-vm);

• Il timeout massimo è limitato a 128MB;

• L'accesso a URL esterni è limitato;

• Il codice può gestire sia espressioni semplici che codice complesso con variabili e refactoring;

• Verifica sempre i limiti di memoria e timeout prima di utilizzare questo MCP per analisi intensive.

Esempio di come si usa data analysis in un system prompt:

Questo MCP funziona molto bene su enormi quantità di dati, in questo esempio abbiamo un agente che fornisce quiz di pedagogia su un dataset con oltre 1000 quiz:

[16:46] 
## 📚 SISTEMA DI QUIZ CON MCP

### Accesso al Database Quiz (1.069 quiz)

Hai accesso a un **database di 1.069 quiz** tramite URL:

**URL Database**: `https://gist.githubusercontent.com/username/837b861112cb6ac7568f686c2a344fc2/raw/66d613cd1fa31ae8231beedea953d157b072246b/gistfile1.txt`

**IMPORTANTE**: Usa l'MCP js-executor per accedere al database da URL.

### Workflow per Accedere ai Quiz

**All'inizio della sessione**, usa l'MCP js-executor con l'URL del database:

```javascript
// Carica database da URL usando MCP js-executor
url: "https://gist.githubusercontent.com/username/837b861112cb6ac7568f686c2a344fc2/raw/66d613cd1fa31ae8231beedea953d157b072246b/gistfile1.txt"
code: "
  // Seleziona 10 quiz random
  const randomQuiz = data.sort(() => Math.random() - 0.5).slice(0, 10);
  return randomQuiz;
"
```

Questo carica automaticamente il JSON dall'URL e lo rende disponibile come variabile `data`.

### Esempi di Selezione Quiz con MCP

```javascript
// Esempio: Seleziona 10 quiz random
const randomQuiz = data.sort(() => Math.random() - 0.5).slice(0, 10);
return randomQuiz;
```

```javascript
// Esempio: Seleziona quiz per categoria
const quizCategoria = data.filter(q => q.category === 'pedagogia').slice(0, 10);
return quizCategoria;
```

```javascript
// Esempio: Statistiche database
const stats = {
  total: data.length,
  byCategory: data.reduce((acc, q) => {
    acc[q.category] = (acc[q.category] || 0) + 1;
    return acc;
  }, {})
};
return stats;
```

### Struttura Quiz nel Database

Ogni quiz ha questa struttura:
```json
{
  "id": 1,
  "category": "pedagogia",
  "difficulty": "C1",
  "question": "Domanda in spagnolo?",
  "options": ["Opción A", "Opción B", "Opción C", "Opción D"],
  "correct_answer": "A",
  "explanation": "Spiegazione dettagliata...",
  "tags": []
}
```

5. PostgreSQL MCP Server

Il PostgreSQL MCP Server consente al tuo Agente di connettersi a database PostgreSQL ed eseguire operazioni di lettura e scrittura.

Questo MCP è utile per:

• interrogare database relazionali PostgreSQL;

• eseguire query SQL complesse;

• gestire dati strutturati in tabelle relazionali.

Parametri

Parametro	Descrizione	Formato	Esempio
Connection String	Connection string completo PostgreSQL	postgresql://user:pass@host:port/db	postgresql://postgres:pass@localhost:5432/mydb postgresql://postgres:[email protected]:5432/postgres

Parametro	Descrizione	Default	Valori possibili
Access Mode	Modalità di accesso al database	read-write	read-write, read-only
Ssl Mode	Modalità SSL per la connessione	prefer	disable, allow, prefer, require, verify-ca, verify-full
Ssl Cert Path	Percorso del certificato client SSL	-	/path/to/client-cert.pem
Ssl Key Path	Percorso della chiave privata SSL	-	/path/to/client-key.pem
Ssl Ca Path	Percorso del CA certificate	-	/path/to/ca-cert.pem
Ssl Reject Unauthorized	Rifiuta connessioni con certificati non validi	true	true, false

Come ottenere i parametri

1. Dopo la registrazione, crea un nuovo progetto;

2. Vai su Settings (icona ingranaggio) → Database;

3. Copia la Connection string in formato URI:

   postgresql://postgres:[YOUR-PASSWORD]@db.xxxxx.supabase.co:5432/postgres

4. Ssl Mode: usa require (Supabase richiede SSL);

Nota su Supabase Connection Pooler:

• Porta 5432: Connessione diretta (per transazioni e operazioni complesse);

• Porta 6543: Connection pooler (per applicazioni con molte connessioni simultanee).

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON.

Formato:

{
  "poolSize": 20,
  "timeout": 60,
  "schema": "public",
  "applicationName": "aisuru_mcp"
}

6. n8n Workflow Server

L'n8n Workflow Server permette al tuo Agente di accedere ai tools reali dei workflow n8n tramite supergateway. n8n è una piattaforma di automazione che consente di creare workflow complessi connettendo diversi servizi.

Questo MCP è utile per:

• integrare workflow n8n esistenti;

• automatizzare processi complessi;

• collegare il tuo Agente a centinaia di servizi supportati da n8n.

Parametri

Parametro	Descrizione	Formato	Esempio
Workflow Url	URL del webhook o endpoint n8n	https:// URL completo	https://myinstance.app.n8n.cloud/webhook/xxx http://localhost:5678/webhook/test

Parametro	Descrizione	Default	Esempio
Workflow Name	Nome identificativo del workflow	-	process_orders, sync_customers
Supergateway Args	Argomenti aggiuntivi per supergateway NPX	-	Parametri specifici per esecuzione via NPX
Auth Token	Token di autenticazione (se il webhook lo richiede)	-	Bearer token123...

Come ottenere i parametri

Opzione A: n8n Cloud

1. Dopo la registrazione e login su n8n Cloud

2. Crea un workflow con un nodo Webhook

3. Nel nodo Webhook:

   • Clicca su "Webhook URLs"

   • Copia l'URL di produzione o test

   • Esempio: https://your-instance.app.n8n.cloud/webhook/abc123xyz

4. Questo URL è il tuo Workflow Url

Tip: Attiva il workflow per rendere l'URL funzionante!

Parametri personalizzati:

{
  "timeout": 60,
  "retries": 3,
  "headers": {
    "X-Custom-Header": "value"
  }
}

7. Fetch Url

Fetch Url è uno strumento per recuperare informazioni da un link e convertirle in formato HTML, JSON o markdown.

Questo MCP è utile per:

• estrarre contenuti da pagine web;

• recuperare dati da API pubbliche;

• convertire contenuti web in formati elaborabili dall'Agente.

Parametri di configurazione

Questo MCP non richiede parametri obbligatori. La configurazione base permette di recuperare contenuti da qualsiasi URL pubblico.

Parametri personalizzati

Puoi specificare parametri personalizzati in formato JSON per controllare il recupero dei dati.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

I parametri comuni includono:

• timeout: tempo massimo di attesa per la risposta;

• retries: numero di tentativi in caso di errore;

• api_version: versione dell'API;

• region: regione geografica.

Note importanti

Per maggiori informazioni sul funzionamento di questo MCP, consulta la documentazione su GitHub: https://github.com/modelcontextprotocol/servers/tree/main/src/fetch.

Esempio di come si usa Fetch url in un system prompt:

# System Prompt: Assistente con Fetch URL

Sei un assistente AI che può recuperare contenuti da pagine web specifiche.

## Quando usare fetch_url
Usa lo strumento fetch_url quando:
- L'utente fornisce un URL specifico da analizzare
- Hai trovato un URL rilevante tramite ricerca web
- Devi verificare il contenuto attuale di una pagina

## Come funziona
```json
{
  "tool": "fetch_url",
  "url": "https://example.com/articolo"
}
```

Lo strumento restituisce il contenuto completo della pagina, che poi analizzi e riassumi.

## Esempio pratico

**Utente:** "Analizza questo articolo: https://www.corriere.it/economia/lavoro/25_articolo"

**Tu:**
1. Chiami fetch_url con l'URL fornito
2. Ricevi il contenuto della pagina
3. Estrai le informazioni chiave
4. Rispondi all'utente con un riassunto chiaro

**Risultato:** L'utente ottiene informazioni fresche direttamente dalla fonte, senza che tu debba basarti solo sulla tua conoscenza pregressa.

8. Microsoft SQL Server MCP

Il Microsoft SQL Server MCP consente al tuo Agente di connettersi a database Microsoft SQL Server e Azure SQL. Supporta query SQL, gestione schema, metriche e sicurezza enterprise.

Questo MCP è utile per:

• interrogare database SQL Server;

• eseguire query complesse su database enterprise;

• gestire dati in ambienti Microsoft Azure.

Parametri

Parametro	Descrizione	Formato	Esempio
DB_HOST	Indirizzo del server SQL	nomeserver.database.windows.net (Azure) o localhost	aisuru-sql.database.windows.net
DB_DATABASE	Nome del database	Stringa alfanumerica	aisuru_db, production
DB_USER	Username per autenticazione	admin o admin@servername	sqladmin
DB_PASSWORD	Password dell'utente	Stringa complessa	MySecureP@ssw0rd123!

Parametro	Descrizione	Default	Valori possibili
DB_PORT	Porta del server SQL	1433	Qualsiasi porta TCP
DB_ENCRYPT	Abilita crittografia TLS/SSL	true	true, false
DB_TRUST_SERVER_CERTIFICATE	Accetta certificati self-signed	false	true, false
CONNECTION_TIMEOUT	Timeout connessione in secondi	15	5-120
REQUEST_TIMEOUT	Timeout query in secondi	15	5-300
POOL_SIZE	Dimensione connection pool	10	1-100

Come ottenere i parametri

Opzione A: Azure SQL Database (Cloud)

1. Dopo aver creato un Azure SQL Database;

2. Vai su Azure Portal → SQL databases → seleziona il tuo database;

3. Nel menu laterale, clicca su Connection strings;

4. Troverai una stringa tipo:

   Server=tcp:myserver.database.windows.net,1433;
   Initial Catalog=mydatabase;
   User ID=sqladmin;
   Password={your_password};
   Encrypt=True;

5. Estrai i parametri:

   • DB_HOST: myserver.database.windows.net

   • DB_DATABASE: mydatabase

   • DB_USER: sqladmin

   • DB_PASSWORD: la password che hai impostato

   • DB_PORT: 1433 (o lascia vuoto, usa default)

   • DB_ENCRYPT: true

   • DB_TRUST_SERVER_CERTIFICATE: false

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON.

Formato: {"timeout": 30, "retries": 3}

Esempio:

{
  "timeout": 30,
  "retries": 3,
  "connectionTimeout": 15,
  "requestTimeout": 30
}

9. Monday.com MCP Server

Il Monday.com MCP Server consente al tuo Agente di interagire con la piattaforma Monday.com per gestire progetti, task e collaborazione del team.

Questo MCP è utile per:

• creare e aggiornare task in Monday.com;

• recuperare informazioni su progetti;

• automatizzare la gestione del lavoro.

Parametri

Parametro	Descrizione	Formato	Esempio
Workspace Name	Nome del workspace Monday.com	Stringa	Main Workspace, Marketing Team
Api Key	API token di autenticazione	Stringa alfanumerica lunga	eyJhbGciOiJIUzI1NiJ9...
Token Param	Nome del parametro per passare il token	Stringa	Authorization, api_token

Come ottenere i parametri

1. Dopo la registrazione e login su Monday.com

2. Workspace Name:

   • Guarda nella sidebar a sinistra;

   • Vedrai il nome del workspace corrente (es. "Main Workspace", "Marketing Team");

   • Usa esattamente quel nome;

3. Api Key (API Token):

   • Clicca sulla tua foto profilo (in basso a sinistra);

   • Seleziona Admin (se sei admin) o Developers;

   • Nel menu laterale, vai su Developers → Token API;

   • Oppure vai direttamente a: https://monday.com/admin/integrations/api ;

   • Nella sezione "Token API":

     • Clicca su "Generate" per creare un nuovo token ;

     • Oppure "Show" per vedere un token esistente;

   • Copia il token (inizia spesso con eyJ...);

IMPORTANTE: Salva il token in modo sicuro!

1. Token Param:

   • Questo specifica come passare il token nelle richieste API;

   • Per Monday.com, usa: Authorization;

   • Il formato standard è: Authorization: Bearer {token};

Esempio di configurazione completa

Workspace Name: Main Workspace
Api Key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWI...
Token Param: Authorization

Sicurezza API Token

• L'API token ha gli stessi permessi dell'utente che lo ha generato;

• Può accedere a tutte le board e workspace dell'utente;

• Non condividere mai il token pubblicamente;

• Ruota il token periodicamente per sicurezza;

Informazioni aggiuntive

Trovare Workspace ID (per riferimento):

• URL: https://mycompany.monday.com/workspaces/12345678

• L'ID è 12345678

Trovare Board ID (per riferimento):

• URL: https://mycompany.monday.com/boards/123456789

• L'ID è 123456789

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON per configurare opzioni avanzate.

Formato:

{
  "apiVersion": "2024-01",
  "timeout": 60,
  "retries": 3
}

10. Salesforce MCP Server

Il Salesforce MCP Server consente al tuo Agente di interagire con Salesforce tramite NPX. Permette di accedere ai dati e alle funzionalità di Salesforce utilizzando OAuth 2.0 Client Credentials.

Questo MCP è utile per:

• recuperare informazioni da Salesforce CRM;

• aggiornare record e opportunità;

• automatizzare processi di vendita.

Parametri

Parametro	Descrizione	Formato	Esempio
Salesforce Client Id	L'identificativo client OAuth 2.0 per l'autenticazione	client_id_string	3MVG9xyz123abc...
Salesforce Client Secret	Il segreto client OAuth 2.0	client_secret_string	a1b2c3d4e5f6...
Salesforce Instance Url	L'URL della tua istanza Salesforce	https://yourinstance.salesforce.com	https://company.my.salesforce.com
Salesforce Connection Type	Il tipo di connessione Salesforce da utilizzare	oauth2	oauth2

Parametro	Descrizione	Default	Esempio
Parametri personalizzati	Parametri aggiuntivi in formato JSON per timeout, retry, versione API, ecc.	-	{"timeout": 30, "retries": 3, "api_version": "v58.0"}

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

11. Wikipedia

L'MCP Wikipedia permette al tuo Agente di accedere direttamente ai contenuti di Wikipedia per recuperare informazioni enciclopediche.

Questo MCP è utile per:

• arricchire le risposte con informazioni enciclopediche;

• fornire contesto su persone, luoghi o eventi;

• accedere a conoscenze verificate e strutturate.

Parametri di configurazione

Questo MCP non richiede parametri obbligatori. L'accesso a Wikipedia è pubblico e non necessita di autenticazione.

Parametri personalizzati

Puoi specificare parametri personalizzati in formato JSON per controllare il recupero delle informazioni.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

Esempio di come si usa Wikipedia MCP in un system prompt:

Sei un assistente AI che può accedere direttamente a Wikipedia per recuperare informazioni enciclopediche.

## Quando usare Wikipedia MCP
Usa lo strumento Wikipedia quando:
- L'utente chiede informazioni su persone, luoghi, eventi storici, concetti
- Serve una fonte enciclopedica autorevole e neutrale
- Vuoi dati strutturati (infobox, categorie, link correlati)

## Come funziona
```json
{
  "tool": "wikipedia_search",
  "query": "Impero Romano",
  "language": "it"
}
```

Lo strumento restituisce articoli Wikipedia con contenuto completo, infobox e metadata.

## Esempio pratico

**Utente:** "Chi era Giulio Cesare?"

**Tu:**
1. Chiami wikipedia_search con "Giulio Cesare"
2. Ricevi l'articolo completo con date, eventi, infobox
3. Estrai le informazioni più rilevanti
4. Rispondi in modo conciso citando Wikipedia

**Risultato:** L'utente ottiene informazioni verificate da fonte enciclopedica, con date precise e contesto storico accurato.

Note importanti

L'Agente può utilizzare Wikipedia per recuperare informazioni aggiornate durante le conversazioni. I contenuti sono soggetti alle licenze e ai termini d'uso di Wikipedia.

12. Zapier MCP Server

Il Zapier MCP Server consente al tuo Agente di accedere ai tools reali di Zapier tramite supergateway. Zapier permette di automatizzare workflow connettendo migliaia di applicazioni diverse.

Questo MCP è utile per:

• integrare Zapier nel tuo Agente;

• automatizzare processi tra diverse applicazioni;

• collegare servizi che non hanno MCP dedicati.

Al interno del pannello di configurazione del tuo mcp su Zapier MCP ricordati di:

• Inserire "other" nella sezione riguardante il Client;

• Andando nella sezione "connect" devi mettere come transport "SSE"

Parametri

Parametro	Descrizione	Formato	Esempio
Zapier Webhook Url	L'URL completo del webhook Zapier	https:// URL completo	https://hooks.zapier.com/hooks/catch/123456/abcdef/<br><br>http://localhost:5678/webhook/test

Parametro	Descrizione	Default	Esempio
Automation Name	Nome identificativo dell'automazione Zapier	-	process_orders, sync_customers
Supergateway Args	Argomenti aggiuntivi per supergateway NPX	-	Parametri specifici per esecuzione via NPX
Auth Token	Token di autenticazione (se il webhook lo richiede)	-	Bearer token123...

Parametri personalizzati

Puoi aggiungere parametri personalizzati in formato JSON.

Formato: {"timeout": 30, "retries": 3}

Esempio: {"timeout": 30, "retries": 3, "api_version": "v2", "region": "eu-west-1"}

Best practices

Quando configuri gli MCP per il tuo Agente, considera questi suggerimenti:

• sicurezza: non condividere mai API key, password o token di autenticazione. Utilizza sempre connessioni sicure (HTTPS, SSL/TLS) quando disponibili;

• testing: prova sempre la configurazione dell'MCP in un ambiente di test prima di utilizzarlo in produzione;

• limitazioni: verifica i limiti di rate (numero di richieste per minuto/ora) dei servizi esterni per evitare blocchi;

• errori: implementa una gestione degli errori appropriata nelle istruzioni dell'Agente per gestire eventuali problemi di connessione;

• documentazione: consulta sempre la documentazione ufficiale dei servizi esterni per comprendere le funzionalità disponibili e i requisiti di configurazione;

• parametri personalizzati: utilizza i parametri personalizzati in formato JSON per configurazioni avanzate, ma verifica sempre che siano supportati dall'MCP specifico.

Limitazioni

Gli MCP hanno alcune limitazioni da considerare:

• timeout: ogni richiesta a un MCP ha un timeout massimo oltre il quale viene interrotta;

• rate limiting: i servizi esterni potrebbero limitare il numero di richieste in un determinato periodo;

• sicurezza dei dati: i dati passati attraverso gli MCP potrebbero essere visibili ai servizi esterni. Non utilizzare MCP per dati sensibili senza verificare le policy di privacy del servizio;

• disponibilità: gli MCP dipendono dalla disponibilità dei servizi esterni. Se un servizio è offline, l'MCP non funzionerà;

• versioni API: alcuni servizi potrebbero deprecare versioni API. Mantieni aggiornata la configurazione degli MCP.

Risoluzione problemi comuni

L'MCP non si connette

Verifica che:

• tutti i parametri obbligatori siano compilati correttamente;

• le credenziali (API key, password, token) siano valide e non scadute;

• gli URL siano corretti e raggiungibili;

• il servizio esterno sia online e funzionante.

L'Agente non utilizza l'MCP

Assicurati che:

• l'MCP sia stato salvato correttamente dopo la configurazione;

• le istruzioni dell'Agente includano indicazioni su quando e come utilizzare l'MCP;

• la richiesta dell'utente sia effettivamente gestibile dall'MCP configurato.

Errori di autenticazione

Controlla che:

• le credenziali siano state copiate correttamente senza spazi aggiuntivi;

• le API key non siano scadute o revocate;

• i permessi associati alle credenziali includano le operazioni richieste.

Timeout o lentezza

Considera di:

• aumentare il valore del parametro timeout nei parametri personalizzati;

• verificare la connessione di rete;

• ottimizzare le query o le richieste per ridurre i tempi di elaborazione.