> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Un server MCP per la tua app

> Permetti a Claude, ChatGPT e altri assistenti IA di usare i dati della tua app

Ogni progetto che crei in Macaly può avere il proprio server [MCP](https://modelcontextprotocol.io). In questo modo altri assistenti IA possono usare la tua app. Chi lavora con Claude o ChatGPT può dire "aggiungi una prenotazione per venerdì alle 10" oppure "quanti ordini sono arrivati questa settimana", e l'assistente esegue l'azione attraverso la tua app.

Quali parti dell'app esporre lo decidi tu. La configurazione avviene nella scheda **MCP** della tua [chat](/docs/it/chat/overview), dove trovi anche i dati di connessione.

<Callout icon="user">
  Disponibile in tutti i piani
</Callout>

## Creare il server

Apri la scheda **MCP** e fai clic su **Crea MCP per questa app**. L'agente guarda che cosa fa la tua app e propone una serie di strumenti, per esempio uno per elencare gli elementi, uno per crearli e uno per modificarli. Se ne vuoi altri, dillo all'agente in chat. Poi integra quegli strumenti nel backend della tua app.

Puoi anche chiederlo direttamente in chat: "Trasforma la mia app in un server MCP così Claude può gestire il magazzino". In seguito, **Aggiungi o modifica strumenti** nella scheda MCP ti riporta dall'agente per sistemare ciò che è esposto.

Una volta creato il server, la scheda mostra il suo **URL del server** e il modo in cui autentica:

* **Accesso richiesto**: gli assistenti entrano tramite il login della tua app, quindi ognuno arriva solo ai propri dati. È il metodo richiesto da Claude e ChatGPT.
* **Token di accesso**: una sola chiave segreta. Utile per script e Claude Code, ma le app Claude e ChatGPT non possono usarla. Se il tuo server accetta solo un token, fai clic su **Aggiungi accesso** e l'agente aggiunge un login alla tua app.

<Note>
  Gli assistenti accedono attraverso la tua app pubblicata, quindi devi prima pubblicare il progetto. Se la chat usa il database di test, Claude e ChatGPT accedono comunque al database Live. Quando la versione di test è pronta, passa a Live nella scheda Database. Vedi [Database Live e di test](/docs/it/features/databases#database-live-e-di-test).
</Note>

## Collegare un assistente

La sezione **Collega** contiene istruzioni passo passo per ogni client. Basta collegarsi una volta sola.

<Tabs>
  <Tab title="Claude">
    1. In Claude, apri **Settings → Connectors** e fai clic su **Add custom connector**.
    2. Dagli un nome e incolla l'URL del tuo server nel campo **Remote MCP server URL**.
    3. Fai clic su **Connect**. Claude apre la pagina di accesso della tua app. Accedi e autorizza.
  </Tab>

  <Tab title="ChatGPT">
    1. In ChatGPT, apri **Settings → Apps & Connectors → Advanced settings** e attiva **Developer mode**.
    2. Torna in **Apps & Connectors**, fai clic su **Create**, dai un nome e incolla l'URL del tuo server. Lascia **OAuth** come autenticazione.
    3. Accedi con l'account della tua app e autorizza. In una chat, scegli la tua app dal menu **+**.
  </Tab>

  <Tab title="Claude Code">
    Copia il comando mostrato nella scheda MCP ed eseguilo nel terminale. Contiene il tuo token di accesso, quindi non condividerlo con nessuno. Poi digita `/mcp` in Claude Code e completa l'accesso nel browser.
  </Tab>
</Tabs>

I connettori personalizzati richiedono un piano a pagamento di Claude o ChatGPT e si aggiungono dall'app web o desktop, non dall'app per telefono.

## Cosa possono fare gli assistenti collegati

L'elenco **Strumenti** in fondo alla scheda mostra tutti gli strumenti offerti dal tuo server, con una breve descrizione di ciascuno. Gli strumenti con l'etichetta **Sola lettura** possono solo consultare i dati. Quelli con l'etichetta **Può eliminare dati** possono rimuoverli, quindi fai attenzione quando imposti le loro autorizzazioni.

Se la scheda segnala che il server non risponde, potrebbe essere ancora in fase di deploy. Riprova tra un momento oppure fai clic su **Chiedi a Macaly di sistemarlo** e l'agente ci dà un'occhiata.

## Esempi di utilizzo

* Un'app di prenotazioni in cui i clienti chiedono al proprio assistente di trovare uno slot libero e prenotarlo.
* Un CRM interno in cui il team commerciale chiede a ChatGPT lo storico di un cliente prima di una chiamata.
* Un'app di magazzino in cui Claude controlla le giacenze e registra le consegne.

Il server gira sul [dominio API](/docs/it/features/domains#dominio-api-per-il-backend-della-tua-app) della tua app, quindi il suo indirizzo resta lo stesso anche se rinomini o sposti il sito.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.