Come faccio a far trascrivere audio e video a Cursor?

Aggiungi il server MCP di KolWrite a ~/.cursor/mcp.json (oppure apri il link di installazione qui sotto). L’agente di Cursor potrà trascrivere le registrazioni del tuo progetto in testo, sottotitoli o traduzioni. Si paga al secondo, dai tuoi crediti KolWrite.

Ottieni una chiave API Guida rapida Lingue supportate

Ultimo aggiornamento: · Markdown

Cosa fai una volta sola

Crea tu l’account e la chiave su console.kolwrite.com: registrati, aggiungi crediti, apri API Keys e crea una chiave. Un agente non può farlo al posto tuo.

Metti la chiave nel file di profilo della tua shell (~/.zshrc, ~/.bashrc) in modo che ogni sessione di agente che avvii possa leggerla, poi apri un nuovo terminale:

export KOLWRITE_API_KEY=...   # paste the key from API Keys

Gli strumenti leggono la chiave solo da questa variabile. Non incollarla in una chat e non farne il commit in un repository.

Aggiungere il server MCP

In ~/.cursor/mcp.json (tutti i progetti) o .cursor/mcp.json (un progetto). ${env:KOLWRITE_API_KEY} legge la chiave dall’ambiente in cui è stato avviato Cursor:

{
  "mcpServers": {
    "kolwrite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz"
      ],
      "env": {
        "KOLWRITE_API_KEY": "${env:KOLWRITE_API_KEY}"
      }
    }
  }
}

Oppure apri questo link in un browser sul computer dove è installato Cursor; Cursor chiede conferma prima di aggiungere il server: Add KolWrite to Cursor

Il server dà all’agente sei strumenti: transcribe_file, transcribe_url, upload_file, get_job, list_models, list_languages. Gira sul tuo computer con Node.js 18 o successivo e si scarica da https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca).

Se gli strumenti non compaiono, avvia Cursor da un terminale dove KOLWRITE_API_KEY è impostata, oppure apri Cursor Settings, poi MCP, e controlla lo stato del server.

Aggiungere una regola al progetto

Perché l’agente conosca l’API anche quando scrive codice, aggiungi una regola in .cursor/rules/kolwrite.mdc:

---
description: Speech-to-text with the KolWrite API
alwaysApply: false
---
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md first. The key is in KOLWRITE_API_KEY; never print it.

Cosa chiedere

Tre richieste da fare a Cursor:

Trascrivi ~/Downloads/interview.m4a con KolWrite e salva il testo come interview.txt accanto al file.

Crea sottotitoli SRT in inglese per talk.mp4 con KolWrite, un sottotitolo per frase.

Chi ha detto cosa in team-call.mp3? Trascrivilo con il riconoscimento degli interlocutori sul modello oracle, poi elenca le attività di ciascuno.

Quanto costa

OperazioneModelloCosto
Un’intervista di 30 minuti, solo testobase0,24 US$
Una riunione di un’ora con riconoscimento degli interlocutorioracle1,56 US$
Un intervento di un’ora in ebraico con sottotitoli in ingleseoracle1,44 US$
Un’ora di audio rumoroso con voci sovrapposteoracle_max3,60 US$

Si paga al secondo di audio, dai tuoi crediti, senza minimo. Il riconoscimento degli interlocutori aggiunge 0,10 crediti per ora di audio. Il server MCP e kolwrite.py usano base se tu o l’agente non indicate un altro modello, e oracle_mini per tradurre. Tutte le tariffe: /it/models.

Cosa l’agente non deve fare

  • Chiederti la chiave nella chat, stamparla o scriverla in un file, in un comando o in un commit.
  • Riavviare la stessa trascrizione dopo un timeout o un errore di rete. Ogni avvio è un nuovo job e viene fatturato; deve invece controllare il job esistente o chiedere a te.
  • Scrivere i timestamp da solo. Per tagliare o citare in base al minutaggio, prende i numeri dei segmenti dalla trascrizione e calcola i tempi via codice a partire dai timestamp delle parole.
  • Inviare come file multimediale l’indirizzo di un video di YouTube o di un’altra pagina web. Serve il file multimediale vero e proprio.
  • Trascrivere registrazioni lunghe (oltre un’ora) senza dirti prima il costo previsto.

Domande e risposte

Funziona in modalità Ask?

Gli strumenti MCP girano nell’agente. Usa l’agente per trascrivere; in modalità Ask puoi leggere la trascrizione in un secondo momento.