import { CardGrid, LinkCard } from '@astrojs/starlight/components';
import Faq from '@components/Faq.astro';

**Aymar Agents** ha un proprio server **MCP** ([Model Context Protocol](https://modelcontextprotocol.io)):
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.

<CardGrid>
  <LinkCard title="Cos'è e cosa non è" href="/it/mcp/getting-started/" description="Un adattatore deterministico sopra la tua stessa API pubblica, senza un modello linguistico proprio." />
  <LinkCard title="Collegare il tuo assistente" href="/it/mcp/connect/" description="URL, header X-Api-Key e trasporto Streamable HTTP." />
</CardGrid>

## Collega il tuo client

<CardGrid>
  <LinkCard title="Claude Desktop" href="/it/mcp/clients/claude-desktop/" description="Configurazione del client desktop." />
  <LinkCard title="Claude Code" href="/it/mcp/clients/claude-code/" description="Via CLI o con .mcp.json." />
  <LinkCard title="Cursor" href="/it/mcp/clients/cursor/" description="Configurazione dell'editor." />
</CardGrid>

## Riferimento

<CardGrid>
  <LinkCard title="Catalogo dei tool" href="/it/mcp/tools/" description="Ogni tool disponibile, generato dalla stessa definizione OpenAPI dell'API pubblica." />
  <LinkCard title="La conferma nelle scritture" href="/it/mcp/confirm/" description="Nessuna scrittura avviene senza la tua conferma esplicita." />
  <LinkCard title="Limiti, errori e risoluzione dei problemi" href="/it/mcp/troubleshooting/" description="Cosa fare quando qualcosa non funziona." />
</CardGrid>

## Strumenti correlati

<CardGrid>
  <LinkCard title="Riferimento API" href="/it/api/" description="La stessa superficie, in REST diretto." />
  <LinkCard title="llms.txt" href="/llms.txt" description="Indice di tutto il portale in testo semplice." />
</CardGrid>

## Domande frequenti

<Faq items={[
  { question: "Che differenza c'è tra il server MCP proprio e un server MCP esterno (BYO-MCP)?", answer: "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 <a href=\"/it/mcp/getting-started/\">Cos'è e cosa non è</a>." },
  { question: 'Cosa serve per collegare il mio client MCP?', answer: "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." },
  { question: "Il server MCP può fare più cose dell'API pubblica?", answer: "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." },
  { question: 'Perché il mio assistente chiede conferma prima di creare o modificare qualcosa?', answer: "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 <a href=\"/it/mcp/confirm/\">La conferma nelle scritture</a>." },
  { question: 'Un tool MCP può cancellare dati?', answer: "No — nessun tool può cancellare nulla, perché l'API pubblica non ha nessun endpoint DELETE." },
  { question: 'Vedo solo il tool di stato nel mio client MCP, nient\'altro. Perché?', answer: '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 <a href="/it/mcp/troubleshooting/">Limiti, errori e risoluzione dei problemi</a>.' },
]} />

## Prossimo passo

<LinkCard title="Collegare il tuo assistente" href="/it/mcp/connect/" description="Blocchi di configurazione per Claude Desktop, Claude Code e Cursor." />