Dai al tuo assistente IA uno strumento di trascrizione

La via più rapida è la riga di comando, dalla cartella in cui lavori:

claude mcp add --transport http dokitscript https://dokitscript.com/mcp \
  --header "Authorization: Bearer dks_live_LA_TUA_CHIAVE"

Crea un .mcp.json nella radice del progetto: così tutta la squadra condivide la stessa dichiarazione.

{
  "mcpServers": {
    "dokitscript": {
      "type": "http",
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer dks_live_LA_TUA_CHIAVE"
      }
    }
  }
}

Verifica con /mcp dentro una sessione: il server deve comparire come connesso, con i suoi cinque strumenti.

Crea .cursor/mcp.json nel progetto per un progetto solo, oppure ~/.cursor/mcp.json per rendere il server disponibile ovunque.

{
  "mcpServers": {
    "dokitscript": {
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer dks_live_LA_TUA_CHIAVE"
      }
    }
  }
}

Apri Settings, poi MCP per confermare che il server compaia. Se l'interruttore è spento, accendilo lì.

VS Code usa la chiave servers e non mcpServers. Sa anche chiedere la chiave all'avvio invece di conservarla nel file, che è quello che serve in un repository destinato al commit.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "dokitscript-key",
      "description": "Chiave API Dokitscript",
      "password": true
    }
  ],
  "servers": {
    "dokitscript": {
      "type": "http",
      "url": "https://dokitscript.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:dokitscript-key}"
      }
    }
  }
}

VS Code chiede la chiave la prima volta che avvia il server, poi se la ricorda. Gli strumenti compaiono quindi in modalità agente, nel selettore degli strumenti.

Claude Desktop ha due porte, e nessuna delle due accetta una chiave Bearer così com'è. Il pannello Connectors prende sì l'indirizzo di un server remoto, ma si autentica in OAuth e non offre alcun campo per una chiave fissa. Il file di configurazione, claude_desktop_config.json, avvia invece comandi locali anziché chiamare un URL. La strada che funziona oggi passa quindi da un piccolo ponte installato sulla tua macchina: Claude Desktop lo avvia come comando, e lui inoltra ogni scambio a https://dokitscript.com/mcp via HTTPS, con la tua chiave nell'header.

Node.js 18 o successivo, è lui che porta con sé npx. Verifica da terminale:

node -v

Su Windows serve anche npm installato a livello globale, altrimenti npx non parte affatto. Basta un comando: npm install -g npm.

La via più corta: Settings, poi Developer, poi Edit Config. Apre il file, e lo crea se ancora non c'era.

{
  "mcpServers": {
    "dokitscript": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dokitscript.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer dks_live_LA_TUA_CHIAVE"
      }
    }
  }
}

Se il file contiene già un oggetto mcpServers, aggiungici "dokitscript" dentro invece di sostituire l'intero file.

La chiave passa da env. Su Windows, Claude Desktop consegna gli args a npx senza proteggere gli spazi. Scritto dentro l'argomento, "Authorization: Bearer dks_live_…" si spezza sullo spazio: il ponte legge allora un header vuoto, il resto della chiave resta lì come argomento orfano, e il server risponde 401 mentre la chiave è perfettamente valida. Tenere lo spazio dentro la variabile lo mette al riparo da chi taglia. L'argomento nomina l'header prima dei due punti, e la variabile porta Bearer, uno spazio e poi la tua chiave.

--transport http-only toglie di mezzo un indovinello. Il nostro server risponde in POST e restituisce 405 a tutto il resto, di proposito. Lasciato a scegliere il trasporto da sé, il ponte legge un 405 come segnale per ripiegare su una modalità di flusso spinto dal server che non implementiamo: un vicolo cieco che non c'entra nulla con la tua chiave. Nominare il trasporto elimina quel ramo.

1. Chiudi del tutto l'applicazione, non solo la sua finestra: Cmd + Q su macOS, esci dall'area di notifica su Windows. La configurazione si legge soltanto all'avvio.
2. Riaprila, poi apri l'elenco Connectors dal pulsante in basso a sinistra della casella di messaggio. dokitscript dovrebbe essere lì con i suoi cinque strumenti.
3. Chiedi una cosa qualunque, del tipo elenca le mie ultime tre trascrizioni. Dovrebbe andare a prendere list_transcripts da solo, senza che tu nomini lo strumento.

Il ponte sta fra te e noi: il client segnala un server che non si avvia e non mostra mai il nostro stato HTTP. Due comandi dicono quale metà è in difetto. Questo parla con noi senza ponte di mezzo, e una chiave buona risponde con le cinque definizioni degli strumenti:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Quest'altro avvia il ponte a mano, dove il suo errore vero viene stampato invece che inghiottito. Qui gli spazi non danno fastidio, perché non era il terminale a spezzarli:

npx -y mcp-remote https://dokitscript.com/mcp \
  --transport http-only --debug \
  --header "Authorization: Bearer dks_live_LA_TUA_CHIAVE"

I propri errori il ponte li scrive nel registro del client: ~/Library/Logs/Claude/mcp-server-dokitscript.log su macOS, %APPDATA%\Claude\logs\mcp-server-dokitscript.log su Windows. Per i codici che restituisce il server, guarda la tabella più sotto.

Va bene qualunque client che parli MCP su HTTP e permetta di impostare un header. Il server accetta richieste POST con JSON-RPC 2.0 e risponde in application/json. Non ci sono sessioni né flussi aperti dal server: GET e DELETE restituiscono 405, ed è voluto. Per provare la chiave a mano:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Una chiave valida restituisce la definizione dei cinque strumenti. Una chiamata si presenta così:

curl -X POST https://dokitscript.com/mcp \
  -H "Authorization: Bearer dks_live_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"list_transcripts","arguments":{"limit":5}}}'