Conectar um assistente de IA (MCP)
O Votinova mantém um servidor MCP remoto, então um assistente pode ler suas sessões e seus resultados e agir sobre eles — pela mesmíssima API, com a mesmíssima credencial.
O que é
MCP (Model Context Protocol) é o padrão que os agentes de IA usam para chamar ferramentas. O servidor do Votinova expõe a API pública como 23 ferramentas derivadas do documento OpenAPI: seu agente pode listar apresentações, criar e abrir sessões, ativar perguntas ou ler resultados — sempre com a sua credencial e dentro dos seus limites.
- Crie uma credencial com as permissões que o assistente deve ter. Dê só leitura, a não ser que ele precise mesmo mudar coisas.
- Adicione o servidor MCP do Votinova ao seu assistente e cole a credencial como chave de API.
- Pergunte a ele sobre uma sessão. Ele descobre o que pode fazer pelo mesmo catálogo publicado que esta página lista.
Configuração
{ "mcpServers": { "votinova": { "url": "https://mcp.votinova.com/mcp", "headers": { "Authorization": "Bearer vz_live_…" } } }}Funciona com qualquer cliente MCP por transporte HTTP: Claude, Cursor, VS Code e companhia.
As ferramentas são filtradas pelos escopos REAIS da credencial: uma chave somente leitura nem enxerga as ferramentas de escrita. A governança e a revogação funcionam igual a qualquer outro uso da API.
Teste com o seu agente
- “Crie uma sessão na minha última apresentação e abra.”
- “Como foi a segunda pergunta da sessão de ontem?”
- “Assine um webhook em question.results.finalized apontando para o meu backend.”
Um assistente não é uma porta separada. Ele só enxerga as capacidades que as permissões da credencial deixam, conta nos mesmos limites de taxa, e desligar o acesso programático da sua organização desliga o assistente junto com todo o resto. Uma capacidade fica de fora de propósito: exportações são arquivos, e um arquivo não serve para um assistente — baixe essas exportações pela API ou pelo espaço de trabalho.
Se uma chave vazar, revogue. É esse o remédio, e ele vale já na chamada seguinte do assistente — nada fica em cache e nada espera um token expirar.