Chatty nel tuo client AI

Un endpoint MCP remoto per gestire assistenti, cataloghi e conversazioni con una API key.

Collega il client

1. Apri API / Integrazioni AI nel pannello Chatty. Serve un account Pro o Business.
2. Crea una API key e copiala subito: viene mostrata una sola volta.
3. Configura un client Streamable HTTP che supporti header Bearer personalizzati, come Claude Code.

claude mcp add --transport http chatty https://api-chatty.romiltec.it/mcp \
  --header "Authorization: Bearer chatty_sk_..."

Sostituisci il segnaposto nella tua configurazione privata. Non pubblicare la chiave negli snippet del widget.

La chiave mantiene le autorizzazioni complete del tuo account e puoi revocarla dal pannello API. I permessi granulari restano nella fase 2.

ChatGPT e client con OAuth

ChatGPT e gli altri client che non permettono di impostare header si collegano con OAuth: niente chiavi da copiare, accedi con il tuo account Chatty.

1. In ChatGPT apri Impostazioni → App e connettori → Impostazioni avanzate e attiva la modalità sviluppatore (le voci del menu possono cambiare).
2. Crea un connettore: URL del server MCP https://api-chatty.romiltec.it/mcp, autenticazione OAuth.
3. ChatGPT apre una pagina Chatty che mostra il sito a cui tornerai: accedi con email e password e premi Autorizza. Serve un account Pro o Business.
4. Chatty crea una API key chiamata «ChatGPT (OAuth)» nel pannello API / Integrazioni AI: revocala per scollegare ChatGPT.

Il collegamento non scade finché non revochi la chiave e ha gli stessi permessi completi di una API key. Lo stesso flusso vale per i connettori personalizzati di Claude.ai e per i client MCP che supportano la registrazione OAuth automatica.

Scegli il client

MCP collega il client, non il modello: servono strumenti, Streamable HTTP e header Bearer. Le configurazioni qui sotto seguono la documentazione dei produttori; non certificano ogni modello o applicazione. La API key deve essere disponibile nel processo che avvia il client.

[mcp_servers.chatty]
url = "https://api-chatty.romiltec.it/mcp"
bearer_token_env_var = "CHATTY_API_KEY"
tool_timeout_sec = 180

{
  "mcpServers": {
    "chatty": {
      "url": "https://api-chatty.romiltec.it/mcp",
      "headers": {
        "Authorization": "Bearer ${env:CHATTY_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "chatty": {
      "httpUrl": "https://api-chatty.romiltec.it/mcp",
      "headers": {
        "Authorization": "Bearer chatty_sk_..."
      },
      "timeout": 180000,
      "trust": false
    }
  }
}

{
  "mcpServers": {
    "chatty": {
      "type": "http",
      "url": "https://api-chatty.romiltec.it/mcp",
      "headers": {
        "Authorization": "Bearer chatty_sk_..."
      }
    }
  }
}

Verifica il collegamento

Chiedi di eseguire list_assistants, poi get_assistant sull’UUID scelto. Per AI mode usa update_assistant con body: {ai_mode_enabled: true}. Dopo import_catalog controlla list_catalog_items e status: ready. Prova ask_assistant e riusa il session_id per le domande successive. Le schede grafiche si vedono nel widget; il client MCP può mostrare soltanto testo e JSON.

Dal catalogo alle risposte

1. Chiedi di elencare i tuoi assistenti con list_assistants e scegli l’istanza.
2. Importa i prodotti con import_catalog: CSV/JSON oppure feed Google Merchant XML/TSV inline, massimo 10 MB e 10.000 righe. external_id aggiorna i prodotti già presenti; i prodotti assenti dal file restano.
3. Prova una domanda con ask_assistant. La chiamata salva una conversazione e consuma inferenza.
4. Leggi le statistiche con get_stats: prodotti consigliati, clic e conversazioni aiutano a valutare le risposte.

Il trasporto accetta 60 richieste al minuto per chiave. I tool remoti non leggono percorsi locali e non scaricano URL; l’importazione attende l’indicizzazione.

Hai PDF o file sul computer?

L’estensione locale .mcpb per Claude Desktop resta disponibile nel pannello API / Integrazioni AI per caricare file dal disco.

Il bundle locale 0.2.0 usa list_chatbots e send_test_message e non include i tool catalogo. Per i cataloghi usa l’endpoint HTTP.