Donnez à votre assistant IA un outil de transcription

Le plus rapide passe par la ligne de commande, depuis le dossier où vous travaillez :

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

Créez un fichier .mcp.json à la racine du projet : toute l'équipe partage alors la même déclaration.

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

Vérifiez avec /mcp dans une session : le serveur doit apparaître comme connecté, avec ses cinq outils.

Créez .cursor/mcp.json dans le projet pour un seul projet, ou ~/.cursor/mcp.json pour rendre le serveur disponible partout.

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

Ouvrez Settings, puis MCP pour confirmer que le serveur est bien listé. Si l'interrupteur est éteint, activez-le à cet endroit.

VS Code utilise la clé servers et non mcpServers. Il sait aussi demander la clé au lancement plutôt que de la stocker dans le fichier, ce qui est préférable dans un dépôt destiné à être commité.

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

VS Code réclame la clé au premier démarrage du serveur, puis la conserve. Les outils apparaissent ensuite en mode agent, dans le sélecteur d'outils.

Claude Desktop offre deux portes d'entrée, et aucune n'accepte une clé porteuse telle quelle. Le panneau Connectors prend bien l'adresse d'un serveur distant, mais il s'authentifie en OAuth et ne propose aucun champ pour une clé fixe. Le fichier de configuration, claude_desktop_config.json, lance quant à lui des commandes locales au lieu d'appeler une URL. Le chemin qui fonctionne aujourd'hui passe donc par un petit relais installé sur votre machine : Claude Desktop le démarre comme une commande, et il transmet chaque échange à https://dokitscript.com/mcp en HTTPS, votre clé dans l'en-tête.

Node.js 18 ou plus récent, c'est lui qui apporte npx. Vérification dans un terminal :

node -v

Sous Windows, npm doit en plus être installé globalement, sans quoi npx refuse de démarrer. Une commande suffit : npm install -g npm.

Le plus rapide : Settings, puis Developer, puis Edit Config. Le fichier s'ouvre, et se crée s'il n'existait pas encore.

{
  "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_VOTRE_CLE"
      }
    }
  }
}

Si le fichier contient déjà un objet mcpServers, ajoutez-y "dokitscript" au lieu de remplacer tout le fichier.

La clé passe par env. Sous Windows, Claude Desktop transmet les args à npx sans protéger les espaces. Écrit en clair, "Authorization: Bearer dks_live_…" se coupe sur l'espace : le relais lit alors un en-tête vide, le reste de la clé traîne en argument orphelin, et le serveur répond 401 alors que la clé, elle, est parfaitement valide. Garder l'espace à l'intérieur de la variable le met hors d'atteinte de ce qui découpe. L'argument nomme l'en-tête avant les deux-points, et la variable porte Bearer, une espace, puis votre clé.

--transport http-only supprime une devinette. Notre serveur répond en POST et renvoie 405 à tout le reste, volontairement. Laissé à choisir le transport tout seul, le relais traite un 405 comme l'invitation à se rabattre sur un mode de flux poussé que nous n'implémentons pas : une impasse qui n'a rien à voir avec votre clé. Nommer le transport retire cette branche du jeu.

1. Quittez complètement l'application, pas seulement sa fenêtre : Cmd + Q sur macOS, quitter depuis la zone de notification sous Windows. La configuration n'est lue qu'au démarrage.
2. Rouvrez-la, puis ouvrez la liste Connectors depuis le bouton en bas à gauche de la zone de saisie. dokitscript doit y figurer avec ses cinq outils.
3. Demandez quelque chose d'ordinaire, du genre liste mes trois dernières transcriptions. Il doit aller chercher list_transcripts de lui-même, sans que vous nommiez l'outil.

Le relais se tient entre vous et nous : le client signale un serveur qui ne démarre pas et n'affiche jamais notre statut HTTP. Deux commandes désignent la moitié fautive. Celle-ci nous parle sans relais, et une clé valide répond avec les cinq définitions d'outils :

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

Celle-là lance le relais à la main, là où sa vraie erreur s'affiche au lieu d'être avalée. Les espaces sont ici sans danger : ce n'est pas le terminal qui les découpait.

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

Le relais écrit ses propres erreurs dans le journal du client : ~/Library/Logs/Claude/mcp-server-dokitscript.log sur macOS, %APPDATA%\Claude\logs\mcp-server-dokitscript.log sous Windows. Pour les codes que renvoie le serveur lui-même, voyez le tableau plus bas.

N'importe quel client qui parle MCP en HTTP et permet de poser un en-tête fonctionne. Le serveur accepte des requêtes POST portant du JSON-RPC 2.0 et répond en application/json. Il n'y a ni session ni flux poussé par le serveur : GET et DELETE renvoient donc 405, et c'est voulu. Pour tester votre clé à la main :

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

Une clé valide renvoie la définition des cinq outils. Un appel ressemble à ceci :

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