Dale a tu asistente de IA una herramienta de transcripción

Lo más rápido es la línea de comandos, desde la carpeta en la que trabajas:

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

Crea un .mcp.json en la raíz del proyecto: así todo el equipo comparte la misma declaración.

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

Compruébalo con /mcp dentro de una sesión: el servidor debe salir como conectado, con sus cinco herramientas.

Crea .cursor/mcp.json en el proyecto para un proyecto suelto, o ~/.cursor/mcp.json para tener el servidor disponible en todas partes.

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

Abre Settings y luego MCP para confirmar que el servidor aparece. Si el interruptor está apagado, actívalo ahí.

VS Code usa la clave servers y no mcpServers. Además sabe pedirte la clave al arrancar en lugar de guardarla en el archivo, que es lo que quieres en un repositorio que se va a subir.

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

VS Code pide la clave la primera vez que arranca el servidor y luego la recuerda. Las herramientas aparecen después en modo agente, en el selector de herramientas.

Claude Desktop tiene dos puertas, y ninguna admite una clave Bearer tal cual. El panel Connectors sí acepta la dirección de un servidor remoto, pero se identifica por OAuth y no ofrece ningún campo para una clave fija. El archivo de configuración, claude_desktop_config.json, lanza comandos locales en lugar de llamar a una URL. Por eso el camino que funciona hoy pasa por un pequeño relé instalado en tu máquina: Claude Desktop lo arranca como un comando y él reenvía cada intercambio a https://dokitscript.com/mcp por HTTPS, con tu clave en la cabecera.

Node.js 18 o posterior, que es lo que trae npx. Compruébalo en una terminal:

node -v

En Windows, npm además tiene que estar instalado de forma global, o npx se niega a arrancar. Con un comando basta: npm install -g npm.

La vía rápida: Settings, luego Developer, luego Edit Config. Abre el archivo, y lo crea si aún no existía.

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

Si el archivo ya tiene un objeto mcpServers, añade "dokitscript" dentro en vez de reemplazar el archivo entero.

La clave viaja por env. En Windows, Claude Desktop pasa los args a npx sin proteger los espacios. Escrito en el propio argumento, "Authorization: Bearer dks_live_…" se parte en el espacio: el relé lee entonces una cabecera vacía, el resto de la clave queda suelto como argumento huérfano y el servidor responde 401 aunque la clave sea perfectamente válida. Dejar el espacio dentro de la variable lo pone fuera del alcance de lo que corta. El argumento nombra la cabecera antes de los dos puntos, y la variable lleva Bearer, un espacio y tu clave.

--transport http-only quita una adivinanza. Nuestro servidor responde por POST y devuelve 405 a todo lo demás, a propósito. Si se le deja elegir el transporte por su cuenta, el relé toma un 405 como señal para replegarse a un modo de flujo enviado por el servidor que no implementamos: un callejón sin salida que nada tiene que ver con tu clave. Nombrar el transporte descarta esa rama.

1. Cierra la aplicación por completo, no solo su ventana: Cmd + Q en macOS, salir desde el área de notificación en Windows. La configuración solo se lee al arrancar.
2. Vuelve a abrirla y despliega la lista Connectors desde el botón de abajo a la izquierda del cuadro de mensaje. dokitscript debería aparecer ahí con sus cinco herramientas.
3. Pide algo corriente, del tipo lista mis tres últimas transcripciones. Debería recurrir a list_transcripts por su cuenta, sin que nombres la herramienta.

El relé se interpone entre tú y nosotros: el cliente avisa de un servidor que no arranca y nunca enseña nuestro código HTTP. Dos comandos señalan cuál de las dos mitades falla. Este nos habla sin relé de por medio, y una clave buena responde con las cinco definiciones de herramientas:

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

Y este arranca el relé a mano, donde su error real se imprime en vez de perderse. Aquí los espacios no molestan, porque no es la terminal la que los partía:

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

El relé escribe sus propios errores en el registro del cliente: ~/Library/Logs/Claude/mcp-server-dokitscript.log en macOS, %APPDATA%\Claude\logs\mcp-server-dokitscript.log en Windows. Para los códigos que devuelve el servidor, mira la tabla de más abajo.

Sirve cualquier cliente que hable MCP por HTTP y permita poner una cabecera. El servidor acepta peticiones POST con JSON-RPC 2.0 y responde en application/json. No hay sesiones ni flujo iniciado por el servidor: GET y DELETE devuelven 405, y es intencionado. Para probar tu clave a mano:

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

Una clave válida devuelve la definición de las cinco herramientas. Una llamada se ve así:

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