MCP

Usa WAMA con l’AI (MCP)

WAMA può dialogare con strumenti AI popolari tramite MCP (Model Context Protocol). Dopo una breve configurazione, puoi chiedere all’assistente di prodotti, stock e vendite per un punto vendita — quello che scegli quando ti colleghi.

Indirizzo del server (uguale per tutti gli strumenti):

https://mcp.wama.cloud/mcp

Due modi per collegarti

Accedi con WAMA

1. Aggiungi l’indirizzo del server sopra nel tuo strumento AI.
2. Se chiede un client id, inserisci: wama-mcp
3. Completa il login nel browser, scegli un punto vendita e l’ambito read o read & write.
4. Torna allo strumento AI — sei collegato.

Puoi revocare l’accesso in seguito nell’app web: Impostazioni → Integrazioni.

Incolla una chiave API

1. Nell’app web WAMA: Impostazioni → Integrazioni → Crea chiave API.
2. Scegli punto vendita e ambito, poi copia la chiave (mostrata una sola volta).
3. Nello strumento AI, aggiungi lo stesso indirizzo del server e metti la chiave nell’header Authorization così:

Bearer wama_…tua_chiave…

Dettagli: Integrazioni e guida API.

Cursor

1. Apri Cursor Settings → MCP (o modifica il file di config MCP).
2. Aggiungi un server chiamato wama con URL https://mcp.wama.cloud/mcp.
3. Preferisci l’accesso: client id wama-mcp e scope read (o read_write se serve).
4. Approva il login nel browser, poi prova una domanda semplice tipo “Elenca alcuni prodotti”.

Esempio di config (accesso):

{
  "mcpServers": {
    "wama": {
      "url": "https://mcp.wama.cloud/mcp",
      "auth": {
        "CLIENT_ID": "wama-mcp",
        "scopes": ["read"]
      }
    }
  }
}

Alternativa con chiave: stesso URL e header Authorization con Bearer wama_….

Claude Code

Nel terminale:

claude mcp add --transport http --client-id wama-mcp wama https://mcp.wama.cloud/mcp

Poi esegui claude mcp login wama (o usa /mcp in Claude Code) e completa il login nel browser.

Claude.ai

1. Apri le impostazioni Claude.ai per connector / MCP personalizzato.
2. Aggiungi l’URL https://mcp.wama.cloud/mcp.
3. Se chiede un client id, usa wama-mcp.
4. Completa login e consenso WAMA nel browser.

ChatGPT

1. Attiva la Developer mode (o MCP / connector personalizzati, a seconda del piano ChatGPT).
2. Aggiungi un server MCP con URL https://mcp.wama.cloud/mcp.
3. Preferisci il client id wama-mcp (senza secret) se l’interfaccia lo consente.
4. Se ChatGPT offre solo la registrazione automatica del client e fallisce, usa incolla una chiave API.

VS Code / GitHub Copilot

1. Apri le impostazioni MCP / Copilot MCP (JSON).
2. Aggiungi un server HTTP verso https://mcp.wama.cloud/mcp con OAuth client id wama-mcp.
3. Completa il login nel browser quando richiesto.

Esempio:

{
  "servers": {
    "wama": {
      "type": "http",
      "url": "https://mcp.wama.cloud/mcp",
      "oauth": {
        "clientId": "wama-mcp"
      }
    }
  }
}

OpenAI Codex CLI

Aggiungi un server MCP HTTP con URL https://mcp.wama.cloud/mcp e client id OAuth wama-mcp. Segui la documentazione attuale di Codex per il file di config. Completa il login nel browser se richiesto.

Windsurf

Aggiungi un MCP remoto https://mcp.wama.cloud/mcp con client id wama-mcp, poi completa il login nel browser.

Altri strumenti AI

Se lo strumento supporta MCP remoto su HTTPS:

1. Usa l’URL https://mcp.wama.cloud/mcp.
2. Client id wama-mcp (senza secret) per l’accesso.
3. Oppure incolla una chiave API come Authorization: Bearer wama_….

Le app desktop che aprono un URL locale (http://localhost… o http://127.0.0.1…) sono supportate automaticamente.

Cosa puoi chiedere

Con un assistente collegato (esempi):

• “Cerca prodotti che contengono …”
• “Qual è lo stock del prodotto …?”
• “Dammi un breve riepilogo vendite di questa settimana”

Le azioni di scrittura (modificare stock, creare o completare una vendita) richiedono ambito read & write. Preferisci read finché non ti servono.

Consigli di sicurezza

• Una connessione = un punto vendita. Crea un’altra chiave o ricollegati se ti serve un altro magazzino/negozio.
• Tratta le chiavi API come password. Non condividerle in chat, email o ticket pubblici.
• Revoca le chiavi inutilizzate in Impostazioni → Integrazioni.
• Per sviluppatori sull’API REST (non MCP), vedi la guida API.