Futebol brasileiro no Claude: o servidor MCP da API

Publicado em , atualizado em .

Discussão de futebol nasce de pergunta que ninguém previu. Conecte a API Dados Futebol a assistentes de IA via MCP e pergunte sobre tabela, artilharia e partidas em português.

Ninguém discute futebol em formulário

Repare em como uma conversa de futebol acontece de verdade. Ela nunca começa com um filtro.

Começa com alguém afirmando alguma coisa — “esse time só ganha em casa” — e a mesa inteira querendo checar. Aí vem a pergunta seguinte, que não estava no plano: e fora de casa, quanto ele pontua? E contra os quatro primeiros? E quantos gols ele tomou depois dos 80 minutos nesta temporada?

É assim há um século, no rádio, no bar, no grupo da família. A discussão de futebol avança por perguntas que ninguém previu — cada resposta produz duas novas.

O problema de todo painel de futebol

Dashboard não funciona assim. Um painel responde exatamente às perguntas que alguém antecipou no momento de construí-lo: tem a tela de tabela, a tela de artilharia, a tela de estatísticas da partida. Todas ótimas, todas fixas.

A pergunta que surgiu no meio da conversa não tem tela. Para respondê-la, alguém precisa abrir a documentação, montar a requisição, cruzar dois endpoints e escrever um script — dez minutos de trabalho para uma curiosidade que dura trinta segundos. Na prática, a pergunta morre.

Esse é o custo que o MCP derruba para zero.

O que é MCP

O MCP (Model Context Protocol) é o padrão que permite a assistentes como o Claude usarem APIs externas como ferramentas. Em vez de o assistente adivinhar dados de futebol de memória — com todos os erros que isso implica —, ele chama a API de verdade e responde com o dado do momento.

A API Dados Futebol expõe um servidor MCP oficial. Você conecta uma vez e passa a perguntar “como está a tabela do Brasileirão?” em vez de escrever requisições.

Conecte no Claude Code

claude mcp add --transport http dadosfutebol \
  https://api.dadosfutebol.com.br/mcp/v1 \
  --header "Authorization: Bearer SUA_CHAVE_AQUI"

No claude.ai (e em outros clientes MCP com suporte a OAuth), dá para conectar sem colar chave nenhuma: o fluxo OAuth abre a tela de autorização do portal e você aprova o acesso da sua conta.

O que fica disponível

O servidor expõe os recursos da API como tools nomeadas em português:

  • listar-campeonatos, tabela-de-classificacao, artilharia
  • listar-partidas, partidas-ao-vivo, eventos-da-partida, estatisticas-da-partida
  • buscar-times, buscar-jogadores, ranking-fifa-selecoes
  • meu-plano e minhas-estatisticas-de-uso — para consultar sua própria cota

Na prática, uma conversa vira uma consulta estruturada. Pergunte “quem é o artilheiro do Brasileirão?” e o assistente chama artilharia, recebe o JSON real e responde com os dados do momento — hoje, Viveros e Pedro, com 12 gols cada.

Mesmas regras da API

As tools reencaminham para os endpoints /v1 internamente: valem a mesma autenticação, o mesmo plano e o mesmo rate limit da sua chave. Se a cota estourar, a tool retorna “Limite atingido” — nada de surpresa na fatura.

Voltando à mesa de bar

Aquelas perguntas do começo do post — “quanto esse time pontua fora de casa?”, “quantos gols saíram depois dos 80 minutos nesta rodada?” — não têm tela em painel nenhum. Mas todas elas são combinações de dados que a API já entrega.

Com o MCP no meio, a distância entre a curiosidade e a resposta deixa de ser um script e passa a ser uma frase.

Para começar do início, veja Primeiros passos com a API.