Ligar um assistente de IA (MCP)

O Votinova tem um servidor MCP remoto, para que um assistente possa ler as suas sessões e resultados e agir sobre eles — pela mesma API e com a mesma credencial.

O que é

O MCP (Model Context Protocol) é a norma 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: o 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.

  1. Crie uma credencial com as permissões que o assistente deve ter. Dê-lhe só de leitura, a menos que precise mesmo de alterar coisas.
  2. Adicione o servidor MCP do Votinova ao seu assistente e cole a credencial como chave de API.
  3. Pergunte-lhe por uma sessão. Descobre o que pode fazer a partir do 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 afins.

As ferramentas são filtradas pelos âmbitos REAIS da credencial: uma chave só de leitura nem sequer vê as ferramentas de escrita. A governação e a revogação funcionam exatamente como em qualquer outra utilização da API.

Experimente com o seu agente

  • «Cria uma sessão na minha última apresentação e abre-a.»
  • «Como correu a segunda pergunta da sessão de ontem?»
  • «Subscreve um webhook a question.results.finalized a apontar para o meu backend.»

Um assistente não é uma porta à parte. Vê apenas as capacidades que as permissões da sua credencial permitem, conta para os mesmos limites de pedidos, e desligar o acesso programático da sua organização também o desliga a ele. Falta-lhe uma capacidade de propósito: as exportações são ficheiros, e um ficheiro não serve de nada a um assistente — transfira-os pela API ou pelo espaço de trabalho.

Se uma chave se expõe, revogue-a. É esse o remédio, e faz efeito na chamada seguinte do assistente — nada fica em cache e nada espera que um token expire.