Conectando o Painel do Voto a Agentes de IA via MCP
O Painel do Voto implementa nativamente o padrão aberto Model Context Protocol (MCP), permitindo que LLMs no Claude Desktop, Cursor e LangChain invoquem ferramentas de cartografia eleitoral, simulações de quociente partidário e cruzamentos de dados do Censo IBGE diretamente no chat. Baixe a especificação em /docs/mcp.json.
1. O que é o Model Context Protocol (MCP)?
O MCP é o protocolo aberto que conecta assistentes inteligentes (Claude, Gemini, GPT-4) a bancos de dados territoriais em tempo real. Em vez de subir planilhas pesadas do TSE no chat, seu agente executa chamadas de função diretas ao Painel do Voto e recebe dados higienizados e pré-calculados em frações de segundo.
2. Ferramentas Disponíveis no Servidor MCP
| Nome da Tool | Finalidade Estratégica | Parâmetros de Entrada |
|---|---|---|
| consultar_inteligencia_candidato | Histórico de votação, colégios líderes e redutos do candidato | municipio_id, candidato_nome_ou_numero |
| gerar_mapa_calor_secoes | Coordenadas e densidade de votos por escola ou bairro | municipio_id, bairro, metrica |
| simular_quociente_eleitoral | Cálculo de QE, QP e sobras partidárias (regras 80/20) | total_votos_validos, vagas, votos_partido |
| consultar_perfil_censo_secao | Cruzamento com renda, idade e escolaridade do Censo 2022 | secao_id, municipio_id |
| gerar_relatorio_estrategico_ia | Dossiê executivo para discursos e coordenação de rua | municipio_id, cargo, meta_votos |
| disparar_comunicado_whatsapp_bairro | Disparo segmentado para líderes de bairro via WhatsApp | bairro, mensagem |
3. Configuração no Claude Desktop
Adicione o bloco abaixo no seu arquivo claude_desktop_config.json:
{
"mcpServers": {
"paineldovoto": {
"command": "npx",
"args": ["-y", "@paineldovoto/mcp-server@latest"],
"env": {
"PAINELDOVOTO_API_KEY": "SUA_CHAVE_API_AQUI",
"PAINELDOVOTO_BASE_URL": "https://paineldovoto.online"
}
}
}
}4. Exemplo de Uso Prático com o Agente de IA
👤 Estrategista no Chat:
"Claude, analise os três colégios onde nosso candidato a vereador teve mais votos em 2024 e cruze com a faixa de renda do Censo para sabermos as propostas ideais."
🤖 Resposta do Claude (invocando as MCP Tools):
"Consultei o Painel do Voto: O candidato obteve 1.420 votos concentrados na E.E. Afonso Pena (620 votos), Colégio São José (450 votos) e CAIC Alvorada (350 votos). No setor censitário do CAIC Alvorada, a renda domiciliar média é de R$ 1.850 e há alta demanda por vagas em creches. Recomendo focar o discurso de rua em saneamento e tempo integral."