Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Demonstração: Ligar o Pokémon Showdown via MCP

Aula 12 de 14 Atualizada a 2 de novembro de 2026 Intermediario
Nesta página
  1. Aprender a jogar
  2. O conceito
  3. Arquitetura do servidor MCP
  4. O padrão de orientação por resposta
  5. Princípios aplicáveis aos seus projetos
  6. Limitações em tempo real
  7. Pontos-chave

Atualização de 2 de novembro de 2026 — O Le Chat é agora o Vibe. Desde 28 de maio de 2026, o Le Chat foi rebatizado como Vibe (ainda em chat.mistral.ai): um único agente para trabalho e código, que mantém as suas conversas, definições e subscrições. A experiência legada do Le Chat permanece disponível no modo Chat; no modo Work, os agentes tornaram-se competências (invocadas com @), as memórias servem de base de conhecimento e a pesquisa profunda é agora a competência Deep Research. Os planos designam-se agora Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; note que alguns menus aqui descritos podem ter alterado de nome ou de localização.

Aprender a jogar

Para ilustrar concretamente a criação e utilização de um conector MCP personalizado, vamos abordar um caso divertido, mas instrutivo: ligar o Pokémon Showdown, o famoso simulador de batalhas Pokémon online, ao Vibe via MCP. Este estudo de caso, apresentado pela equipa da Mistral AI durante as suas sessões em direto, implementa princípios diretamente transferíveis para qualquer integração profissional. O tema é ligeiro, mas as lições técnicas não o são.

O conceito

O Pokémon Showdown é uma plataforma web onde os jogadores se enfrentam em batalhas estratégicas por turnos. O objetivo do servidor MCP é permitir que o Vibe se ligue à plataforma como um jogador, desafie um oponente, analise o estado da batalha (Pokémon ativos, PV, movimentos disponíveis) e escolha a melhor ação em cada turno. Este exercício é valioso porque concentra quatro desafios raramente encontrados em conjunto: comunicação em tempo real, gestão de estado, tomada de decisão sequencial e orientação do modelo através de respostas de ferramentas.

Arquitetura do servidor MCP

O servidor expõe primeiro uma ferramenta battle_player que inicia uma batalha. Recebe um nome de utilizador como parâmetro e devolve um ID de batalha único, o estado inicial da batalha (Pokémon de cada equipa, PV, etc.) e instruções para o modelo sobre quais as ferramentas a chamar a seguir. Este terceiro elemento está longe de ser trivial: incorporar instruções de fluxo de trabalho nos valores de retorno das ferramentas é um padrão de design MCP avançado, que revisitaremos abaixo.

Segue-se a ferramenta de ação de batalha. Em cada turno, o Vibe deve escolher entre atacar, trocar de Pokémon ou usar um objeto. A ferramenta recebe o ID da batalha, o tipo de ação e o ID do movimento ou do Pokémon a enviar, devolvendo depois o novo estado da batalha após a ação. O ciclo repete-se até o jogo terminar, servindo cada resposta como ponto de partida para a próxima decisão.

O padrão de orientação por resposta

A lição mais importante desta demonstração é orientar o modelo através dos valores de retorno. Em vez de depender apenas do pedido do utilizador para dirigir o fluxo de trabalho, o servidor MCP insere instruções nas suas respostas:

Result: Battle started. Your active Pokémon is Pikachu (HP: 100%).
The opponent sent out Charizard.

→ Use the 'choose_move' tool to select an attack,
  or 'switch_pokemon' to change Pokémon.
  Available moves: Thunderbolt, Surf, Quick Attack, Protect.

O modelo já não tem de adivinhar o próximo passo: é-lhe dito explicitamente, juntamente com as opções válidas para o momento. O comportamento final emerge de uma simbiose entre o pedido do utilizador, que carrega a intenção geral (“jogar uma batalha Pokémon”), as descrições das ferramentas, que explicam quando e como usar cada ferramenta, e as respostas das ferramentas, que especificam qual a ferramenta a chamar a seguir e com que argumentos.

Antes de ligar este servidor ao Vibe, a equipa da Mistral executa-o através do MCP Inspector: verifica se o battle_player responde corretamente com o estado inicial da batalha, testa as ações de batalha uma a uma, garante que as instruções de orientação estão presentes nas respostas e valida o formato JSON dos parâmetros e das respostas. Num jogo por turnos, o mais pequeno erro de formatação interrompe a partida; o Inspector permite depurar sem consumir mensagens da conversa.

Princípios aplicáveis aos seus projetos

O primeiro princípio transferível é a gestão de estado nas respostas. Qualquer sistema que evolua ao longo das interações — um processo de encomenda, um pipeline de CI/CD, um fluxo de validação — beneficia de o servidor devolver o estado atual e as ações disponíveis em cada passo. Um servidor MCP que gere encomendas devolveria assim o estado da encomenda e os próximos passos disponíveis: validar pagamento, confirmar expedição, cancelar.

O segundo é a integração de instruções de fluxo de trabalho nas respostas e não no pedido do utilizador, onde a lógica seria longa de escrever e frágil de manter. Um servidor MCP de implementação poderia, por exemplo, responder após um passo bem-sucedido: “Testes aprovados. Utilize a ferramenta ‘deploy_staging’ para implementar no ambiente de staging.”

O terceiro diz respeito a descrições claras e tipadas. Cada ferramenta no servidor Pokémon tem uma descrição precisa, parâmetros tipados e valores de retorno documentados, para que o modelo saiba exatamente o que a ferramenta faz e que argumentos fornecer. Aplicado à lógica de negócio, isto significa nomear explicitamente (create_invoice em vez de process), tipar de forma útil (user_email: string em vez de user: string) e descrever os retornos esperados.

O quarto é a decomposição em ferramentas especializadas. O servidor não oferece uma única ferramenta “play_pokemon” que trate de tudo: cada ação tem a sua própria ferramenta e responsabilidade. Da mesma forma, prefira start_order, add_item, confirm_payment e track_shipment a um manage_order genérico, que é mais difícil de descrever e, portanto, mais frequentemente mal utilizado.

Limitações em tempo real

A demonstração destaca também uma limitação atual: os servidores MCP no Vibe ainda não suportam nativamente tarefas de longa duração ou streaming em tempo real, pois cada chamada de ferramenta aguarda uma resposta síncrona. Para sistemas que exigem atualizações contínuas, a solução recomendada é expor uma ferramenta start_task que lança a operação e uma ferramenta get_status que o utilizador chama para verificar o progresso.

Pontos-chave

  • O caso Pokémon Showdown ilustra padrões MCP avançados aplicáveis a qualquer projeto
  • A orientação por resposta é um padrão poderoso para orquestrar fluxos de trabalho em várias etapas
  • As descrições das ferramentas, as respostas estruturadas e a decomposição em ferramentas especializadas são as chaves de um bom servidor MCP
  • Teste sempre com o MCP Inspector antes de integrar com o Vibe
  • Os princípios são idênticos para um jogo ou para um processo de negócio complexo