MCP no Claude Desktop

Os “conectores personalizados” do Claude Desktop exigem login por OAuth, que a TopTalking ainda não suporta. A forma de conectar é pelo arquivo de configuração, usando o mcp-remote — uma ponte que roda na sua máquina e fala com o servidor da TopTalking por HTTP.

Requisito: Node.js 18 ou mais novo instalado (o comando npx precisa funcionar no terminal).

Configurar

1. Gere uma chave em Configurações → Desenvolvedor. Para começar, prefira Somente leitura.

2. No Claude Desktop, abra Configurações → Desenvolvedor → Editar configuração. Isso abre o arquivo claude_desktop_config.json:

   Windows

   %APPDATA%\Claude\claude_desktop_config.json

   macOS

   ~/Library/Application Support/Claude/claude_desktop_config.json

3. Cole a configuração abaixo (se o arquivo já tiver outros servidores, adicione só o bloco toptalking dentro de mcpServers) e troque tt_live_SUA_CHAVE pela sua chave:

   claude_desktop_config.json

   {
     "mcpServers": {
       "toptalking": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://platform.toptalking.com.br/mcp",
           "--header",
           "Authorization:${TOPTALKING_AUTH}"
         ],
         "env": {
           "TOPTALKING_AUTH": "Bearer tt_live_SUA_CHAVE"
         }
       }
     }
   }

4. Feche o Claude Desktop por completo (inclusive o ícone perto do relógio, no Windows) e abra de novo.

5. Num chat novo, clique no ícone de ferramentas: a toptalking deve aparecer com as ferramentas listadas.

Por que o cabeçalho está numa variável?

Repare que o argumento é Authorization:${TOPTALKING_AUTH} — sem espaço depois dos dois-pontos — e o valor Bearer tt_live_... fica em env.

No Windows, argumentos com espaço (como Authorization: Bearer tt_live_...) costumam ser quebrados no caminho até o npx, e o cabeçalho chega errado. O mcp-remote substitui ${TOPTALKING_AUTH} pelo valor da variável, então o espaço nunca passa pela linha de comando. Funciona igual no macOS.

Problemas comuns

Sintoma	O que fazer
A toptalking não aparece	Confira se o JSON é válido (vírgulas!) e se você fechou o app por completo antes de abrir de novo.
Erro com npx	Instale o Node.js 18+ e teste npx --version no terminal.
Erro 401	Confira o valor de TOPTALKING_AUTH: precisa começar com Bearer (com espaço) seguido da chave.
Ver os logs	No Windows: %APPDATA%\Claude\logs. No macOS: ~/Library/Logs/Claude. Procure os arquivos mcp*.log.

Veja as ferramentas e os cuidados de segurança em Servidor MCP.