Aymar Agents ha un proprio server MCP (Model Context Protocol): espone il tuo account — lead, contatti, conversazioni, appuntamenti e ticket — come un insieme di tool che il tuo assistente IA può leggere e, con la tua conferma, scrivere. È esattamente ciò che consente l’API pubblica, non un endpoint in più — i suoi tool sono generati dalla stessa definizione OpenAPI.
Cos'è e cosa non èUn adattatore deterministico sopra la tua stessa API pubblica, senza un modello linguistico proprio.
Collegare il tuo assistenteURL, header X-Api-Key e trasporto Streamable HTTP.
Collega il tuo client
Sezione intitolata “Collega il tuo client”Claude DesktopConfigurazione del client desktop.
Claude CodeVia CLI o con .mcp.json.
CursorConfigurazione dell'editor.
Riferimento
Sezione intitolata “Riferimento”Catalogo dei toolOgni tool disponibile, generato dalla stessa definizione OpenAPI dell'API pubblica.
La conferma nelle scrittureNessuna scrittura avviene senza la tua conferma esplicita.
Limiti, errori e risoluzione dei problemiCosa fare quando qualcosa non funziona.
Strumenti correlati
Sezione intitolata “Strumenti correlati”Riferimento APILa stessa superficie, in REST diretto.
llms.txtIndice di tutto il portale in testo semplice.
Domande frequenti
Sezione intitolata “Domande frequenti”Che differenza c'è tra il server MCP proprio e un server MCP esterno (BYO-MCP)?
Sono direzioni opposte: il server MCP di Aymar Agents espone il tuo account al tuo assistente IA esterno (Claude Desktop, Claude Code, Cursor); un server MCP esterno inserisce strumenti di terze parti dentro l'agente che parla con i tuoi clienti, e si collega da Impostazioni, non dal tuo client MCP. Vedi Cos'è e cosa non è.
Cosa serve per collegare il mio client MCP?
Un piano Pro o Enterprise e una chiave API con gli scope delle risorse che vuoi usare — lo stesso meccanismo che useresti per chiamare /public/v1 direttamente.
Il server MCP può fare più cose dell'API pubblica?
No — i suoi tool sono generati leggendo la stessa definizione OpenAPI di /public/v1. Qualsiasi cosa puoi fare tramite MCP potresti farla anche con una chiamata curl diretta all'API.
Perché il mio assistente chiede conferma prima di creare o modificare qualcosa?
Ogni tool di scrittura richiede l'argomento confirm: true; senza di esso, il server rifiuta la chiamata prima di toccare l'API e restituisce un riepilogo di ciò che stava per fare. È lo stesso principio "l'LLM non è mai l'unica barriera" che regola il resto del prodotto. Vedi La conferma nelle scritture.
Un tool MCP può cancellare dati?
No — nessun tool può cancellare nulla, perché l'API pubblica non ha nessun endpoint DELETE.
Vedo solo il tool di stato nel mio client MCP, nient'altro. Perché?
O il tuo tenant non è su un piano Pro/Enterprise, o la tua chiave non ha nessuno scope di lettura. Chiama il tool di stato per confermare quale dei due casi è. Vedi Limiti, errori e risoluzione dei problemi.
Prossimo passo
Sezione intitolata “Prossimo passo”Collegare il tuo assistenteBlocchi di configurazione per Claude Desktop, Claude Code e Cursor.