Collegare un client MCP (Claude, ChatGPT e altri)
MCP (Model Context Protocol) è uno standard aperto che permette agli assistenti IA di collegarsi a strumenti esterni. Collega Samsa tramite MCP e il tuo assistente può generare immagini e video, usare i tuoi modelli addestrati e controllare i crediti — direttamente in una conversazione, senza uscire dalla chat.
Il server MCP di Samsa
Imposta il tuo client MCP su questo indirizzo:
https://api.samsa.ai/mcp
Questo singolo indirizzo è tutto ciò di cui la maggior parte dei client ha bisogno — niente da installare e nessun software locale da tenere in esecuzione.
Client supportati
La documentazione per sviluppatori include una configurazione passo passo per i client più diffusi, tra cui Claude (web e desktop), ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Codex, n8n, Gemini CLI e Microsoft Copilot Studio. Trovi i passaggi esatti per ogni app in Collegare i client MCP (si apre in una nuova scheda).
Due modi per accedere
Accedi con Samsa (OAuth) — ideale per app interattive come Claude e ChatGPT. Accedi con il tuo account Samsa e approvi una schermata di consenso; l'app gestisce la connessione e non incolli mai una chiave. Vedi Autorizzare la connessione sotto.
Chiave API — ideale per strumenti da sviluppatore come Claude Code, Cursor e VS Code. Incolli una chiave API (che inizia con
samsa_sk_) nella configurazione del client. Creane prima una — vedi Creare e gestire le chiavi API.
Autorizzare la connessione
Quando ti colleghi con OAuth, Samsa mostra una schermata "Autorizza l'accesso" che ti dice quale app sta chiedendo, quale organizzazione userà e cosa potrà fare esattamente. Controllala e scegli Autorizza solo per le app di cui ti fidi con la tua organizzazione. Puoi annullare qualsiasi richiesta che non riconosci.
Cosa può fare il tuo assistente
Una volta collegato, il tuo assistente può:
Elencare e visualizzare i tuoi modelli — vedere i modelli addestrati disponibili nella tua organizzazione
Generare immagini — trasformare un prompt in immagini, componendo opzionalmente i tuoi modelli addestrati di stile, oggetto, persona e scena
Modificare immagini — fare modifiche basate su prompt con Magic Edit
Generare video — da un fotogramma iniziale, da testo o da testo stilizzato con i tuoi modelli
Controllare lo stato dei job e il saldo crediti
La generazione viene eseguita come job in background: il tuo assistente lo avvia e poi torna a controllare quando è pronto.
I crediti valgono comunque
Tutto ciò che il tuo assistente crea tramite MCP usa i crediti della tua organizzazione, esattamente come l'app e l'API. Le azioni di sola lettura (elencare i modelli, controllare lo stato o il saldo) sono gratuite. Vedi Utilizzo dell'API, crediti e rate limit per i dettagli.