Como controlar o Stream Deck com IA

A versão 7.4 do Stream Deck introduz o suporte a MCP, permitindo que os assistentes de IA identifiquem e acionem as ações do seu Stream Deck. Em vez de premir uma tecla, pode utilizar uma ferramenta de IA como o NVIDIA G-Assist, o Claude ou o ChatGPT para ativar ações em seu nome.

Continua a configurar as ações na aplicação Stream Deck da mesma forma que sempre fez. O MCP oferece uma nova forma de as ativar. Este guia explica o que é o MCP, como configurá-lo e como começar a utilizá-lo.

MCP significa Model Context Protocol. Trata-se de um padrão aberto que proporciona às ferramentas de IA uma forma comum de se conectarem a aplicações e serviços.

Pense nisso como o USB. Antes do USB, cada dispositivo precisava do seu próprio tipo de cabo e conector. O USB criou um padrão único que funciona com tudo. O MCP faz o mesmo pelas ferramentas de IA. Em vez de cada assistente de IA precisar de uma ligação personalizada para cada aplicação, o MCP oferece-lhes uma forma comum de comunicar.

O MCP foi lançado em 2024 e tem sido adotado por empresas como a Anthropic, a OpenAI, a Google e a Microsoft. Milhares de aplicações e serviços já o suportam. Com o Stream Deck 7.4, o Stream Deck junta-se a essa lista.

A configuração tem três partes:

1. Ative o MCP na aplicação Stream Deck e escolha as ações a que pretende que a IA tenha acesso. Estas ações são adicionadas a um perfil específico chamado «Ações MCP».
2. Deve instalar uma pequena ponte chamada Elgato MCP Server no seu computador. É ela que liga a sua ferramenta de IA à aplicação Stream Deck.
3. Indique à sua ferramenta de IA onde encontrar o Elgato MCP Server.

Assim que tudo estiver ligado, pode digitar ou ditar pedidos e a sua ferramenta de IA irá ativar a ação correspondente no Stream Deck. Vamos ver cada uma delas.

1. Abra a aplicação Stream Deck.
2. Vá a «Preferências » e selecione o separador «Geral ».
3. Na secção «Integração MCP da Elgato», marque a opção «Ativar ações MCP».

Isto cria um perfil específico chamado «MCP Actions», que pode encontrar no menu suspenso de perfis na parte superior da aplicação Stream Deck.

Arraste as ações do painel de ações à direita para as teclas, tal como faria com qualquer outro perfil. Qualquer ação que colocar aqui fica disponível para as ferramentas de IA ligadas. As ações nos seus outros perfis permanecem privadas, pelo que controla exatamente o que a IA pode aceder.

Cada ação no perfil «Ações» do MCP possui um campo de descrição que indica à IA o que a ação faz e quando deve ser utilizada. Esta é uma das partes mais importantes da configuração, pois é assim que a IA decide qual a ação a acionar quando se faz um pedido.

Para adicionar uma descrição, selecione uma ação e clique no ícone de IA nas definições da ação, na parte inferior do ecrã. Em seguida, escreva uma descrição clara e simples.

Uma boa descrição responde a duas perguntas: o que a ação faz e que tipo de pedido deve acioná-la. Por exemplo:

• Para silenciar: «Isto silencia o áudio do sistema.»
• Para ativar ou desativar a luz principal: «Isto permite ligar ou desligar a minha luz principal esquerda.»
• Para mudar de cena no OBS: «Isto muda para a minha cena "Volto já" no OBS.»

A IA compara os seus pedidos com estas descrições, pelo que, quanto mais específicas forem, melhor funcionará. Isto é especialmente importante quando existem várias ações semelhantes. Se tiver duas ações multimédia no perfil e nenhuma delas tiver uma descrição, a IA não terá como distingui-las.

Antes de ligar qualquer ferramenta de IA, é necessário ter o Node.js instalado no seu computador. O Node.js é uma ferramenta gratuita e amplamente utilizada que está na base de muitas aplicações e serviços. O Elgato MCP Server funciona com ele, e tanto a instalação do G-Assist como a do Claude Desktop requerem a sua presença.

Se ainda não o tiver, descarregue-o e instale-o a partir do site nodejs.org. Escolha a versão LTS (Long Term Support). O instalador funciona como qualquer outra aplicação. Execute-o, siga as instruções e está pronto. Não precisa de configurar nada nem de aprender a utilizá-lo.

O Elgato MCP Server é o que liga a sua ferramenta de IA à aplicação Stream Deck. Para o instalar, abra um terminal (Terminal no macOS, PowerShell no Windows) e execute:

npm install -g @elgato/mcp-server

Isto instala-o permanentemente no seu computador, para que esteja pronto sempre que precisar.

Se quiser apenas experimentar primeiro, pode saltar esta etapa. As instruções de configuração abaixo utilizam o npx, que descarrega e executa o Elgato MCP Server temporariamente, sem instalar nada. Funciona da mesma forma, mas volta a descarregar sempre que o iniciar.

Para obter mais opções e detalhes, visite a página do Elgato MCP Server no npm.

NVIDIA G-Assist é um assistente de IA integrado para PCs com GeForce RTX. Alimentado por um pequeno modelo de linguagem executado localmente na GPU, responde a comandos de voz e de texto. Com o suporte MCP do Stream Deck, o G-Assist pode acionar as suas ações diretamente, inclusive por voz.

Os jogadores podem ativar teclas de atalho no jogo ou gravar um vídeo sem tirar as mãos do teclado. Os streamers podem iniciar toda a sua configuração de transmissão com um único comando de voz. O G-Assist pode agora controlar qualquer dispositivo ao qual o Stream Deck esteja ligado.

Iniciar o Elgato MCP Server

1. Abra um terminal no seu computador (PowerShell no Windows).

2. Execute o seguinte comando: npx -y @elgato/mcp-server@latest --http

3. Deixe esta janela aberta. Deverá ver uma mensagem a indicar que o servidor HTTP está a escutar na porta 9090 e que a aplicação Stream Deck está ligada.

O servidor tem de permanecer em execução em segundo plano enquanto utiliza o G-Assist. Se fechar a janela do terminal, a ligação será interrompida.

Instale o plugin para o G-Assist

O G-Assist utiliza um plugin para comunicar com o Elgato MCP Server. Coloque a pasta do plugin do Stream Deck no diretório de plugins do G-Assist:

%PROGRAMDATA%\NVIDIA Corporation\nvtopps\rise\plugins\stream-deck

Em seguida, reinicie o G-Assist ou atualize os plugins. Na primeira vez que for carregado, o plugin deteta automaticamente as ações disponíveis no Stream Deck.

Confirme a ligação

Pode verificar se o Elgato MCP Server está a funcionar abrindo um navegador e acedendo a:

http://localhost:9090/health

Se o servidor estiver em execução e ligado à aplicação Stream Deck, será apresentada uma resposta de estado.

Claude Desktop liga-se ao Elgato MCP Server através de um ficheiro de configuração local. Se utilizar uma ferramenta de IA diferente, a abordagem geral é semelhante, e pode encontrar instruções de configuração adicionais na página do Elgato MCP Server no npm.

O Claude Desktop armazena as suas ligações MCP num ficheiro de configuração. É necessário adicionar o Elgato MCP Server a este ficheiro para que o Claude saiba onde o encontrar.

1. Abra o Claude Desktop.
2. Vá a «Definições», depois a «Programador» e, em seguida, clique em «Editar configuração». Isto abre a pasta onde o ficheiro de configuração está guardado.
3. Encontre o ficheiro claude_desktop_config.json nessa pasta. Clique com o botão direito do rato sobre ele e abra-o com um editor de texto (Bloco de Notas no Windows, TextEdit no macOS).
4. O ficheiro já terá algum conteúdo. Deve adicionar uma entrada mcpServers dentro da estrutura existente, e não como um bloco separado abaixo dela.

Encontre o último } que encerra uma secção existente. Adicione uma vírgula a seguir a ele e, em seguida, adicione a secção mcpServers antes do } final. Eis como fica um ficheiro típico após a edição:

Tudo deve ficar dentro de um único par de chaves { }, com uma vírgula entre cada secção. Se o bloco mcpServers for colado como um objeto separado abaixo do conteúdo existente, o Claude Desktop apresentará um erro ao iniciar.

Se o ficheiro estiver vazio ou contiver apenas {}, pode substituir todo o conteúdo por:

1. Guarde o ficheiro e saia completamente do Claude Desktop (não basta fechar a janela). No macOS, clique com o botão direito do rato no ícone da dock e selecione «Sair». No Windows, clique com o botão direito do rato no ícone da bandeja do sistema e selecione «Sair». Em seguida, volte a abri-lo.

Confirme a ligação

Para verificar se tudo está a funcionar, aceda a «Definições» e, em seguida, a «Programador». Na secção «Servidores MCP locais», deverá ver o Elgato listado com a indicação «Em execução ».

Se não aparecer ou não estiver a ser executado, verifique se a aplicação Stream Deck está aberta com as Ações MCP ativadas e se o ficheiro de configuração foi guardado corretamente. Em seguida, feche completamente o Claude Desktop e volte a abri-lo.

O Claude Desktop e o NVIDIA G-Assist são duas opções comuns, mas qualquer ferramenta compatível com o MCP pode ligar-se ao Elgato MCP Server.

Para obter todos os detalhes sobre a instalação, outros métodos de ligação e configurações avançadas, visite a página do Elgato MCP Server no npm.

Assim que a sua ferramenta de IA estiver conectada, experimente pedir-lhe para verificar as ações disponíveis. Com o G-Assist, basta dizer «Que ações do Stream Deck tenho?» Com o Claude Desktop, escreva a mesma frase numa nova conversa.

Se a ligação estiver a funcionar, a IA irá listar as ações no seu perfil de Ações do MCP, juntamente com as respetivas descrições. Esta é uma boa forma de confirmar se tudo está configurado corretamente.

A partir daí, basta pedir o que precisas. Diz «silenciar o áudio» ao G-Assist ou escreve-o no Claude Desktop, e a IA irá encontrar a ação correspondente e ativá-la. Funciona da mesma forma que premir a tecla no Stream Deck.

Se uma ação não for acionada, verifique o seguinte:

1. A aplicação Stream Deck está em execução e a opção «Ativar ações MCP» está marcada nas Preferências.
2. A ação encontra-se no perfil «Ações do MCP», e não num perfil diferente.
3. A sua ferramenta de IA está ligada ao Elgato MCP Server. No Claude Desktop, aceda a «Configurações», depois a «Desenvolvedor» e verifique se «elgato» aparece na secção «Servidores MCP locais» com um ícone verde a indicar que está em execução. No G-Assist, verifique se a janela do terminal que executa o servidor continua aberta e se apresenta uma ligação ao Stream Deck.

A integração do Elgato MCP no Stream Deck 7.4 é um primeiro passo rumo a uma conectividade mais profunda com a IA. À medida que o ecossistema MCP cresce, também aumentarão as formas como as ferramentas de IA podem interagir com a sua configuração.

Para ampliar as funcionalidades do seu perfil do MCP Actions, explore os plugins disponíveis no Elgato Marketplace. Qualquer ação de plugin que possa atribuir a uma tecla do Stream Deck também pode ser acionada através do MCP.