Server MCP
Gestisci il tuo negozio WAzion da Claude Desktop, ChatGPT, Cursor, VS Code e qualsiasi client compatibile con MCP.
1. Che cos’è MCP?
MCP (Model Context Protocol) è uno standard aperto che consente agli assistenti IA di connettersi a servizi esterni. È come una “USB universale“ per l’IA: qualsiasi cliente compatibile può utilizzare gli strumenti che WAzion espone.
Cosa significa per te?
- 1 Puoi gestire il tuo negozio WAzion da Claude Desktop, ChatGPT, Cursor o VS Code
- 2 mostrami lo stato del mio negozio o cambia la lingua in inglese
- 3 Tutte le azioni del dashboard sono disponibili come strumenti MCP
2. Come connettere
Dati di connessione:
URL: https://www.wazion.com/api/mcp/
Auth: Bearer IL_TUO_TOKEN
Prerequisito: installa mcp-remote con Node.js di Homebrew:
/opt/homebrew/bin/npm install -g mcp-remoteModifica il file di configurazione:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"wazion": {
"command": "/opt/homebrew/bin/node",
"args": [
"/opt/homebrew/lib/node_modules/mcp-remote/dist/proxy.js",
"https://www.wazion.com/api/mcp/",
"--transport", "http-only",
"--header", "Authorization: Bearer TU_TOKEN"
]
}
}
}Nota: Claude Desktop utilizza il Node.js di sistema (/usr/local/bin/node) che potrebbe essere obsoleto. Per questo motivo facciamo riferimento direttamente al binario di Homebrew.
// .mcp.json en tu proyecto
{
"mcpServers": {
"wazion": {
"type": "url",
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}- 1 Impostazioni → Connessioni → Aggiungi connessione
-
2
URL:
https://www.wazion.com/api/mcp/ - 3 Auth: Bearer token
// .cursor/mcp.json
{
"mcpServers": {
"wazion": {
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}// .vscode/mcp.json
{
"servers": {
"wazion": {
"type": "http",
"url": "https://www.wazion.com/api/mcp/",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}Altri clienti (Windsurf, Cline, ecc.)
Qualsiasi cliente compatibile con MCP Streamable HTTP può connettersi utilizzando l’URL e il Bearer token. Consulta la documentazione del tuo cliente per sapere dove configurare i server MCP.
3. Dove trovare il tuo token
Il tuo token è lo stesso che appare nell’URL quando accedi al dashboard di WAzion:
https://www.wazion.com/dashboard/TU_TOKENPuoi trovarlo anche in Dashboard → Account, nella sezione informazioni del tuo negozio.
Importante: Il tuo token dà accesso completo al tuo negozio. Non condividerlo pubblicamente né includerlo in repository di codice.
4. Cosa puoi fare
Tutte le azioni disponibili nel dashboard sono esposte come strumenti MCP. Alcune categorie:
Impostazione
- Cambiare lingua, fuso orario, formato data
- Visualizza stato del negozio
- Gestire crediti
Agenti
- Creare, modificare ed eliminare agenti
- Gestire i permessi
- Assegnare orari
IA e Prompt
- Aggiornare il prompt dell’IA
- Gestire i dati appresi
- Configurare funzioni personalizzate
Integrazioni
- Collegare/disconnettere Shopify
- Configurare webhook e endpoint CRM
- Gestire i plugin
5. Azioni con conferma
Alcune azioni potenzialmente pericolose (eliminare agenti, disconnettere Shopify, ecc.) richiedono conferma esplicita. Il flusso è:
Prima chiamata (senza conferma)
Il server risponde con un messaggio di avviso che descrive ciò che accadrà. Non esegue l’azione.
Seconda chiamata (con conferma: true)
L’azione viene eseguita realmente. I clienti MCP come Claude gestiscono questo flusso automaticamente.
6. Esempi di utilizzo
Una volta connesso, basta chiedere al tuo assistente IA ciò di cui hai bisogno:
"Mostrami lo stato del mio negozio WAzion"
"Cambia la lingua del mio negozio in inglese"
"Elenca i miei agenti e i loro permessi"
"Quanti crediti mi restano?"
"Crea un agente chiamato Supporto con orario dalle 9 alle 18."
7. Domande frequenti
È sicuro?
Sì. La connessione avviene su HTTPS e richiede il tuo token privato. Le azioni pericolose richiedono una conferma aggiuntiva. Il tuo token non viene mai condiviso con terzi.
Ha un costo aggiuntivo?
No. Il server MCP è incluso in tutti i piani. Le azioni che consumano crediti (come le risposte IA) vengono detratte dal tuo saldo normale.
Posso usarlo con qualsiasi cliente MCP?
Sì. WAzion implementa lo standard MCP Streamable HTTP (spec 2025-03-26), compatibile con qualsiasi client che supporti questo protocollo.
Quali azioni sono disponibili?
Tutte le azioni del dashboard: configurazione, agenti, prompt, plugin, integrazioni, statistiche, WhatsApp Auto, marketing di massa e altro. Gli strumenti vengono generati automaticamente e sono sempre aggiornati.
