Dê ao seu assistente de IA uma ferramenta de transcrição

O caminho mais rápido é a linha de comando, dentro da pasta em que você trabalha:

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

Crie um .mcp.json na raiz do projeto: assim o time inteiro compartilha a mesma declaração.

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

Confira com /mcp dentro de uma sessão: o servidor deve aparecer como conectado, com as cinco ferramentas.

Crie .cursor/mcp.json no projeto para um projeto só, ou ~/.cursor/mcp.json para deixar o servidor disponível em todos.

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

Abra Settings e depois MCP para confirmar que o servidor aparece. Se a chave estiver desligada, ligue por ali.

O VS Code usa a chave servers, não mcpServers. Ele também sabe pedir a chave ao iniciar em vez de guardá-la no arquivo, que é o que você quer num repositório que vai para o commit.

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

O VS Code pede a chave na primeira vez que o servidor sobe e guarda depois. As ferramentas aparecem então no modo agente, no seletor de ferramentas.

O Claude Desktop tem duas portas, e nenhuma aceita uma chave Bearer do jeito que ela é. O painel Connectors até recebe o endereço de um servidor remoto, mas se identifica por OAuth e não oferece campo nenhum para uma chave fixa. Já o arquivo de configuração, claude_desktop_config.json, dispara comandos locais em vez de chamar uma URL. Por isso o caminho que funciona hoje passa por um pequeno retransmissor na sua máquina: o Claude Desktop o inicia como um comando, e ele repassa cada troca para https://dokitscript.com/mcp por HTTPS, com a sua chave no cabeçalho.

Node.js 18 ou mais novo, que é o que traz o npx junto. Confira num terminal:

node -v

No Windows, o npm também precisa estar instalado globalmente, senão o npx se recusa a subir. Um comando resolve: npm install -g npm.

Caminho mais curto: Settings, depois Developer, depois Edit Config. Abre o arquivo e cria, se ele ainda não existia.

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

Se o arquivo já tiver um objeto mcpServers, acrescente "dokitscript" dentro dele em vez de substituir o arquivo inteiro.

A chave viaja pelo env. No Windows, o Claude Desktop entrega os args ao npx sem proteger os espaços. Escrito direto no argumento, "Authorization: Bearer dks_live_…" quebra no espaço: o retransmissor lê um cabeçalho vazio, o resto da chave fica solto como argumento órfão, e o servidor devolve 401 mesmo com a chave perfeitamente válida. Manter o espaço dentro da variável o coloca fora do alcance de quem corta. O argumento nomeia o cabeçalho antes dos dois-pontos, e a variável carrega Bearer, um espaço e a sua chave.

--transport http-only tira um palpite do caminho. O nosso servidor responde em POST e devolve 405 a todo o resto, de propósito. Deixado para escolher o transporte sozinho, o retransmissor lê um 405 como sinal para recuar até um modo de fluxo empurrado pelo servidor que não implementamos: um beco sem saída que nada tem a ver com a sua chave. Nomear o transporte descarta esse caminho.

1. Feche o aplicativo por completo, não só a janela: Cmd + Q no macOS, sair pela bandeja do sistema no Windows. A configuração só é lida ao iniciar.
2. Abra de novo e chame a lista Connectors pelo botão no canto inferior esquerdo da caixa de mensagem. O dokitscript deve estar lá, com as cinco ferramentas.
3. Peça algo banal, do tipo liste minhas três últimas transcrições. Ele deve buscar o list_transcripts por conta própria, sem você nomear a ferramenta.

O retransmissor fica entre você e nós: o cliente avisa que um servidor não sobe e nunca mostra o nosso código HTTP. Dois comandos apontam qual metade falhou. Este fala conosco sem retransmissor no meio, e uma chave boa responde com as cinco definições de ferramentas:

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

E este sobe o retransmissor na mão, onde o erro de verdade aparece em vez de sumir. Aqui os espaços não atrapalham, porque não é o terminal que os quebrava:

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

O retransmissor grava os próprios erros no log do cliente: ~/Library/Logs/Claude/mcp-server-dokitscript.log no macOS, %APPDATA%\Claude\logs\mcp-server-dokitscript.log no Windows. Para os códigos que o servidor devolve, veja a tabela mais abaixo.

Serve qualquer cliente que fale MCP por HTTP e permita colocar um cabeçalho. O servidor aceita requisições POST com JSON-RPC 2.0 e responde em application/json. Não há sessão nem fluxo puxado pelo servidor: GET e DELETE devolvem 405, e isso é intencional. Para testar a sua chave na mão:

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

Uma chave válida devolve a definição das cinco ferramentas. Uma chamada fica assim:

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