Windsurf, oggi chiamato Devin Desktop, è un editor locale: gli SMS passano dal codice server della tua app. Prendi una chiave sandbox Telmian, mettila in un .env escluso da git come TELMIAN_API_KEY e chiedi all'agente una route server che chiami POST /v1/verify e /v1/verify/check. Telmian invia dai propri numeri europei.
Prendi una chiave sandbox gratuita
Nella cartella del progetto accedi a Telmian e lancia init. Scrive una chiave sandbox (sk_test_) nel file .env, senza carta. Controlla che .env sia in .gitignore.
npx telmian@1 login npx telmian@1 initDai le regole all'agente
Devin Desktop legge le regole da AGENTS.md o da un file in .devin/rules/ con trigger: always_on. Aggiungi una regola breve perché l'agente tenga la chiave sul server.
Call Telmian only from server-side code (API route or server function). Read the key from process.env.TELMIAN_API_KEY. Never send it to the browser or prefix it with NEXT_PUBLIC_ or VITE_. Use REST https://app.telmian.com/v1 with Authorization: Bearer, or the npm package telmian. While developing, use the sandbox numbers +393000000001 and +393000000002.Facoltativo: aggiungi il server MCP di Telmian
Serve solo all'agente mentre costruisci; la tua app non ne ha bisogno. Aggiungilo da finestra Agents, Customize, MCPs, oppure in .devin/mcp_config.json come qui sotto. Accedi a Telmian nel browser quando richiesto, poi approva gli strumenti Telmian quando l'agente lo chiede.
{ "mcpServers": { "telmian": { "url": "https://app.telmian.com/mcp", "transport": "http" } } }Crea la route che invia il codice
Chiedi all'agente una route server nel tuo framework, per esempio un route handler Next.js o un endpoint Express. Telmian genera il codice e lo invia. Usa una Idempotency-Key per ogni tentativo di registrazione e riusala solo quando ritenti.
const TELMIAN_API_KEY = process.env.TELMIAN_API_KEY; // signupAttemptId: one id per signup attempt, reused if you retry const res = await fetch('https://app.telmian.com/v1/verify', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': signupAttemptId }, body: JSON.stringify({ phone }) });Crea la route che controlla il codice
Una seconda route server manda il numero e il codice scritto dall'utente. Telmian risponde con valid true o false.
const check = await fetch('https://app.telmian.com/v1/verify/check', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ phone, code }) }); const { valid } = await check.json();Prova nella sandbox
Avvia l'app in locale e aprila nell'anteprima. Nella sandbox gli SMS sono simulati: +393000000001 riceve sempre il codice 000000 e +393000000002 fallisce sempre, così provi entrambi i casi.
Vai live sul tuo hosting
Devin Desktop non ha più il deploy con un clic: pubblica l'app sul tuo hosting e imposta lì TELMIAN_API_KEY con una chiave sk_live_ creata su https://app.telmian.com. Imposta un nome aziendale approvato e ricarica da 5 € per iniziare gli invii reali.
Domande
Windsurf e Devin Desktop sono la stessa cosa?
Sì. Windsurf è stato rinominato Devin Desktop il 2 giugno 2026. È lo stesso editor. L'agente predefinito ora è Devin Local, mentre Cascade è l'agente legacy.
L'agente di Devin Desktop può leggere la mia chiave API nel .env?
Di default Devin Local può leggere i file indicati in .gitignore, compreso .env. Puoi disattivarlo con l'opzione Gitignore access nelle impostazioni di Devin Local; vale per le nuove sessioni. Un file .devinignore non blocca le letture dell'agente.
Devo mettere la chiave API Telmian nella configurazione MCP?
No. Il server MCP di Telmian usa l'accesso dal browser, quindi non serve una chiave. Inoltre .devin/mcp_config.json viene condiviso con git: non metterci mai segreti.
Posso pubblicare l'app da Windsurf con un clic?
No. La funzione Deploys su Netlify è stata rimossa a settembre 2026. Pubblica l'app sul tuo hosting e aggiungi TELMIAN_API_KEY alle sue variabili d'ambiente.
Mi serve un mio telefono o una SIM per inviare SMS?
No. Telmian invia dai propri numeri mobili europei. Costa 0,05 € per segmento SMS verso cellulari in 44 Paesi europei, più IVA, prepagato da 5 €, senza canone mensile.
Aggiornata il