Cos'è e cosa non è

MCP (Model Context Protocol) è uno standard aperto perché un assistente IA (Claude Desktop, Claude Code, Cursor, o un tuo agente) usi strumenti esterni in modo strutturato, invece che tramite testo libero. Aymar Agents ha un proprio server MCP: espone il tuo account — leads, contatti, conversazioni, appuntamenti e ticket — come un insieme di tool che il tuo assistente può leggere e, con la tua conferma, scrivere.

Cos’è

• Un adattatore deterministico, senza un proprio modello linguistico: l’LLM che decide quale tool chiamare vive sempre nel tuo client (Claude Desktop, Claude Code, Cursor…), mai in questo server.
• Esattamente ciò che permette la API pubblica (/public/v1), non un endpoint in più — i suoi tool sono generati leggendo la stessa definizione OpenAPI che documenta il riferimento REST, quindi qualsiasi cosa tu possa fare via MCP potresti farla anche con una chiamata curl diretta alla API. Vedi il catalogo completo dei tool.
• Senza accesso al tuo database, né a nessun dato che la API non esponga già: ogni chiamata di un tool inoltra la tua stessa chiave API a /public/v1, così com’è — il server MCP non salva la tua chiave e non ha nessun’altra via di accesso al tuo account. Tutto il controllo (permessi, piano, limiti, isolamento per account) lo applica la API, non questo adattatore.

Cosa non è

Non confonderlo con i “server MCP esterni” che puoi collegare al tuo agente IA da Impostazioni → Server MCP (BYO-MCP) — vanno nella direzione opposta:

	Server MCP di Aymar Agents (questa sezione)	Server MCP esterni (BYO-MCP)
Direzione	Espone il tuo account Aymar Agents al tuo assistente IA esterno	Inserisce strumenti di terzi dentro l’agente IA del tuo account
Chi lo collega	Tu, dal tuo client MCP (Claude Desktop, Claude Code, Cursor…)	Tu, dalla Piattaforma, perché li usi l’agente che serve i tuoi clienti
Dove si configura	Nella configurazione del tuo client MCP (vedi Collega il tuo assistente)	In Impostazioni → Server MCP della Piattaforma

Se quello che cerchi è dare al tuo agente IA accesso a strumenti esterni (il tuo CRM, il tuo catalogo, il tuo calendario…), è l’altro componente — consulta la guida Impostazioni e integrazioni, sezione 8. Questa sezione riguarda l’opposto: dare al tuo assistente IA accesso a Aymar Agents.

Requisiti

• Piano Pro o Enterprise — con il piano Starter, ogni tool risponde con lo stesso 403 PLAN_NOT_ELIGIBLE della API pubblica (vedi Piani e limiti). Il server continua sempre a elencare il tool aymar_status perché il tuo client possa mostrare un messaggio chiaro sul perché non c’è altro.
• Una chiave API con gli scope delle risorse che vuoi usare — lo stesso meccanismo, e la stessa schermata, della chiave che useresti per chiamare /public/v1 direttamente (guida Chiavi API, catalogo completo degli scope in Autenticazione). I tool che vede il tuo client MCP sono esattamente quelli che la tua chiave può usare — niente di più.

Come funziona, in tre passi

Il tuo client MCP (Claude Desktop / Claude Code / Cursor / un tuo agente)
      │  Streamable HTTP, header X-API-Key: <la tua chiave>
      ▼
Server MCP di Aymar Agents  (senza database, senza stato, senza LLM proprio)
      │  inoltra la stessa chiave, chiamata dopo chiamata
      ▼
API pubblica di Aymar Agents  (/public/v1 — qui si decide tutto: permessi, piano, limiti)

Continua con Collega il tuo assistente per i blocchi di configurazione concreti. Se vuoi anche che il tuo backend parli direttamente con l’API pubblica, con la stessa chiave, vedi La mia IA e il mio backend, che parlano con i miei dati.