Saltar para o conteúdo
Peladeiros

Documentação · servidor MCP

Liga o Claude, o ChatGPT ou o Gemini ao Peladeiros

O Peladeiros tem um servidor MCP (Model Context Protocol). Ligado a um agente de IA, deixa-te organizar campeonatos de futebol a conversar: criar o campeonato, aprovar inscrições, gerar o calendário, lançar resultados e preparar a partilha no WhatsApp, em português de Angola.

Endereço do servidor
https://peladeiros.ao/mcp
Autenticação
OAuth 2.1 com a tua conta do Peladeiros
Preço
100% grátis, sem limite de jogadores

Requisitos

  • Uma conta no Peladeiros (grátis, com email ou Google).
  • Um agente de IA que aceite servidores MCP remotos: Claude, ChatGPT (modo de programador) ou Gemini CLI.
  • Para gerir um campeonato, tens de ser o organizador ou administrador dele. Para criar links de convite, capitão da equipa.

Como ligar

No primeiro uso, o agente abre a página de autorização do Peladeiros. Entras na tua conta e escolhes Autorizar; o agente fica com acesso só aos teus dados.

Claude

  1. Abre os conectores do Claude. Em claude.ai, nos conectores, carrega em + e escolhe Adicionar conector personalizado.
  2. Preenche o nome e o endereço. Nome: Peladeiros. URL do servidor MCP remoto: https://peladeiros.ao/mcp. Confirma com Adicionar.
  3. Autoriza com a tua conta. O Claude abre o Peladeiros. Entra na tua conta e escolhe Autorizar.
  4. Testa a ligação. Numa conversa nova, escreve: Lista os meus campeonatos no Peladeiros.

ChatGPT

  1. Abre as definições de conectores. Em chatgpt.com, nas definições, abre Aplicações e conectores.
  2. Activa o modo de programador. Em Definições avançadas, liga o Modo de programador. Os conectores personalizados só aparecem com este modo.
  3. Cria o conector. Nome: Peladeiros. URL do servidor MCP: https://peladeiros.ao/mcp. Autenticação: OAuth. Carrega em Criar.
  4. Autoriza e testa. Entra na tua conta do Peladeiros, escolhe Autorizar e, numa conversa nova com o conector Peladeiros, escreve: Lista os meus campeonatos no Peladeiros.

Gemini CLI

  1. Adiciona o servidor. No terminal: gemini mcp add --transport http peladeiros https://peladeiros.ao/mcp
  2. Autoriza com a tua conta. No Gemini CLI, corre /mcp auth peladeiros. O navegador abre o Peladeiros: entra e escolhe Autorizar.
  3. Testa a ligação. Escreve: Lista os meus campeonatos no Peladeiros.

No Claude Code, também podes instalar o plugin do Peladeiros, com o conector e skills em português de Angola: github.com/amarildomiguel/peladeiros-claude-plugin.

Ferramentas

O servidor tem 23 ferramentas: 10 só consultam dados e 13 alteram dados. As que alteram dados estão marcadas para o agente pedir a tua confirmação antes de as usar.

Só consultam

Ver a minha conta ver-minha-conta

Mostra a conta do Peladeiros com que o agente está ligado: nome, nome de utilizador, id do perfil de jogador (se existir), equipas em que jogas com o papel (capitão ou jogador), número de campeonatos que criaste, plano actual e ligações públicas. O id do jogador e os slugs das equipas servem nas ferramentas de perfil e de convites.

Listar os meus campeonatos listar-campeonatos

Lista os campeonatos que geres, com variante de futebol, formato, estado, ligação pública e número de inscrições pendentes. O "id" devolvido identifica o campeonato nas restantes ferramentas.

Ver campeonato ver-campeonato

Mostra um campeonato que geres: variante de futebol, formato, estado, se aceita inscrições (só em rascunho ou com inscrições abertas), inscrições, classificação, próximos jogos e últimos resultados (cada jogo com a ligação para a súmula em PDF). Inclui os identificadores para decidir inscrições e lançar resultados.

Texto para partilhar no WhatsApp texto-partilha

Prepara texto para o WhatsApp com a classificação, os próximos jogos, os resultados ou os melhores marcadores. Inclui a ligação pública do campeonato e uma ligação wa.me com o texto.

Variantes de futebol e formatos listar-modalidades-e-formatos

O Peladeiros é só de futebol. Lista as variantes (futebol 11, futebol 7, futebol 5, futsal e futebol de praia) com jogadores em campo, duração e se permitem empate, e os formatos aceites por "criar-campeonato". As mesmas chaves são aceites nas variantes dos perfis de jogador.

Ver perfil e partilhar jogador ver-perfil-jogador

Mostra o perfil público de um jogador (sem id, o teu próprio perfil), se o perfil é verificado e a categoria de verificação (membro fundador, patrocinador platina, patrocinador ouro, patrocinador, membro associado ou membro verificado), as variantes de futebol que joga, a principal, os níveis e estatísticas reais dos lances registados (jogos, golos, assistências, autogolos, cartões amarelos, azuis e vermelhos, MVP), as linhas por campeonato público e as suspensões em curso. Jogos conta jogos com lances associados ao jogador. Devolve links do perfil, QR SVG e cartão PNG em quadrado (1080x1080) ou story (1080x1920), nas cores verde, azul, laranja ou roxo (por omissão, a cor escolhida pelo jogador; muda-se com "configurar-cartao-jogador"). Sem lances, o cartão mostra "Jogador Peladeiros".

Consultar o meu plano e os planos disponíveis ver-planos

Consulta o teu plano actual, os limites de jogadores e patrocinadores por campeonato, os planos públicos e os contactos para pedir uma alteração. As atribuições são feitas pela administração do Peladeiros; esta ferramenta não altera planos nem dá acesso administrativo.

Ver desafios da equipa ver-desafios

Lista os desafios (jogos amigáveis entre equipas) das equipas em que jogas, por separador: "abertos" (à espera de resposta e jogos marcados), "resultados" (jogos disputados com resultado por lançar ou por validar), "historico" (só resultados validados pelas duas equipas) e "arquivo" (recusados, cancelados, expirados ou arquivados). Mostra a fase, a data (hora de Luanda), o campo, o resultado proposto, as acções disponíveis para a tua equipa e o balanço de vitórias, empates e derrotas. Os ids servem para "gerir-desafio".

Pesquisar equipas e campos pesquisar-equipas-e-campos

Pesquisa equipas (por nome, bairro ou cidade) e campos de jogo (por nome, morada ou tipo de piso), com a mesma pesquisa da aplicação: sem acentos, palavras por qualquer ordem e os nomes mais parecidos primeiro. Filtros opcionais: só equipas com vagas abertas, só as equipas do utilizador e tipo de piso dos campos. Devolve os ids e as ligações públicas; não devolve coordenadas.

Ver o meu calendário de jogos ver-meu-calendario

Mostra os próximos jogos do teu calendário no Peladeiros: os jogos das equipas em que jogas e os dos campeonatos que geres, com data e hora de Luanda, campo e resultado. Mostra também se o Google Calendar está ligado (agenda «Peladeiros»), a última sincronização e a ligação para abrir a agenda. Ligar ou desligar o Google Calendar faz-se no site, na página Calendário.

Alteram dados

Criar campeonato criar-campeonato

Cria um campeonato em rascunho e coloca-te como organizador. O Peladeiros é só de futebol: a variante é futebol 11, 7, 5, futsal ou futebol de praia. As variantes e os formatos aceites estão em "listar-modalidades-e-formatos". O Peladeiros é 100% gratuito, sem limite de jogadores.

Aprovar ou rejeitar inscrição decidir-inscricao

Aprova ou rejeita a inscrição de uma equipa num campeonato que geres. Os capitães da equipa são notificados. A aprovação respeita o limite de jogadores do plano. O id da inscrição vem de "ver-campeonato".

Adicionar equipa ao campeonato adicionar-equipa-campeonato

Inscreve directamente uma equipa num campeonato que geres, já aprovada (respeita o limite de jogadores do plano). Usa "equipa" com o id de uma equipa existente (de "pesquisar-equipas-e-campos") ou "nome" para criar uma equipa nova. Para equipas novas devolve um link de capitão (1 uso) para partilhares: quem o abrir entra como capitão, mesmo que ainda não tenha conta. A ferramenta não envia mensagens.

Gerar calendário gerar-calendario

Gera o calendário com as equipas aprovadas e coloca o campeonato em curso. Aceita liga, eliminatória, grupos, suíço, eliminatória dupla ou amigáveis. Se já houver jogos, apaga-os e gera-os de novo; nesse caso só avança com "confirmar": true e, sem ele, devolve o número de jogos que seriam apagados.

Agendar um jogo agendar-jogo

Marca a data, a hora e o campo de um jogo num campeonato que geres, sem mexer no resultado. Um jogo adiado com nova data volta a ficar agendado. A agenda do Google Calendar e a página pública são actualizadas. O id do jogo vem de "ver-campeonato" e o id do campo de "pesquisar-equipas-e-campos".

Lançar resultado de um jogo lancar-resultado

Regista o resultado de um jogo num campeonato que geres. Também permite alterar o estado, a data e o campo. A classificação, os apuramentos e a página pública são actualizados com o resultado. Modalidades sem empate exigem vencedor (ou desempate nos penáltis). O id do jogo vem de "ver-campeonato".

Configurar cartão do jogador configurar-cartao-jogador

Muda a cor (verde, azul, laranja ou roxo) e a frase curta (até 40 caracteres) do cartão do teu perfil de jogador. Só podes editar o teu perfil. A cor escolhida passa a ser a cor por omissão do cartão PNG; "ver-perfil-jogador" devolve o link actualizado.

Actualizar variantes de futebol do jogador actualizar-modalidades-jogador

Substitui as variantes de futebol que jogas (futebol 11, 7, 5, futsal, futebol de praia) no teu perfil de jogador. Só podes editar o teu perfil. Cada variante aceita nível opcional (iniciante, intermedio, avancado) e apenas uma pode ser principal. Uma lista vazia remove todas. As chaves válidas estão em "listar-modalidades-e-formatos".

Criar link de convite da equipa criar-link-equipa

Cria e devolve um link para convidar jogadores (ou um capitão) para uma equipa que geres: és capitão, ou criaste a equipa e ela ainda não tem capitão. Quem abre o link sem conta entra na equipa logo depois de se registar. Validade e máximo de usos opcionais. O endereço devolvido pode ser copiado ou partilhado; a ferramenta não envia mensagens.

Gerir um desafio gerir-desafio

Actua num desafio em nome de uma equipa em que jogas, com as mesmas regras do site: aceitar ou recusar (equipa desafiada), editar a data, o campo ou a mensagem (qualquer equipa até haver resultado), cancelar, eliminar (só sem jogo marcado), arquivar ou desarquivar (só desafios terminados), lançar o resultado (golos da desafiante e da desafiada) e validar o resultado lançado pela outra equipa. O resultado só conta no histórico depois de validado pelas duas equipas; se a outra equipa lançar o mesmo resultado, fica validado. O id do desafio e as acções disponíveis vêm de "ver-desafios".

Sincronizar o Google Calendar sincronizar-google-calendar

Actualiza já a agenda «Peladeiros» no Google Calendar com os teus jogos (cria, altera e remove eventos). A sincronização também é automática quando um jogo muda e de hora a hora. Exige o Google Calendar ligado; se não estiver, devolve a ligação para o fazer no site. Usa "ver-meu-calendario" para ver o estado.

Exportar o campeonato para o Google Sheets exportar-google-sheets

Cria ou actualiza, na conta Google do organizador, a folha do Google Sheets do campeonato com os separadores Jogos, Classificação, Equipas e Marcadores, e devolve a ligação. Exportar outra vez reescreve a mesma folha. Exige o Google Sheets ligado no site (no campeonato, Partilhar → Exportar).

Importar datas e resultados do Google Sheets importar-google-sheets

Lê o separador Jogos da folha do Google Sheets do campeonato e aplica as datas, horas e resultados alterados (com as mesmas regras de "lancar-resultado"), actualiza a tabela e volta a exportar a folha. Devolve quantas datas e resultados mudaram e as linhas com erro. Jogos com lances na súmula não aceitam resultado pela folha. Exige a folha já exportada com "exportar-google-sheets".

Dados e privacidade

  • O agente age em teu nome, com as permissões da tua conta: só vê e altera os campeonatos que geres e o teu perfil de jogador.
  • O servidor recebe apenas os dados de cada pedido (por exemplo, o nome de um campeonato ou o resultado de um jogo). Não lê as tuas conversas, a memória do agente nem os teus ficheiros.
  • Quando aprovas ou rejeitas uma inscrição, os capitães da equipa recebem a notificação habitual do Peladeiros. O texto para o WhatsApp é devolvido ao agente; quem envia a mensagem és tu.
  • O Peladeiros não mostra publicidade através do servidor MCP e não move dinheiro.
  • Mais detalhes na Política de Privacidade e nos Termos de Utilização.

Revogar o acesso

Em Perfil → Agentes de IA (com sessão iniciada) vês os agentes autorizados e revogas cada um com um clique. Também podes criar ali chaves pessoais para agentes que não suportam OAuth; cada chave pode ser revogada a qualquer momento.

Suporte

Dúvidas ou problemas com a ligação: amarildomgl@gmail.com. O Peladeiros é desenvolvido por Amarildo Miguel e Lisandro Lipi.