Conectar assistentes de IA
Conecte Claude ou modelos GPT aos microdados do SIVEP-Gripe e peça análises epidemiológicas em linguagem natural. Os cálculos são determinísticos e rodam no servidor; o modelo escolhe e explica as operações.
Conector remoto
Cole esta URL como conector personalizado no Claude. O servidor oferece acesso público e somente leitura a dados públicos.
https://siveplens.literato.io/api/mcp- 1No Claude (web ou desktop), abra Configurações → Conectores.
- 2Clique em Adicionar conector personalizado (Add custom connector).
- 3Cole a URL acima e clique em Conectar.
- 4Pronto — comece a pedir análises. O Claude usará as ferramentas automaticamente.
Requisito: conectores personalizados estão disponíveis nos planos Claude Pro, Max, Team e Enterprise. Os dados consultados são públicos (SIVEP-Gripe / OpenDataSUS).
O que o assistente poderá fazer
Oito ferramentas expostas pelo servidor MCP — da descrição auditável à regressão multivariada
resumir_variavelEstatísticas descritivas com N total/válido, ausências, média, DP, mediana, quartis e manifesto reproduzível dos filtros.
consultar_panoramaIndicadores de SRAG (casos, óbitos, letalidade, UTI) e tendência semanal, com desagregação por etiologia, faixa etária ou sexo.
prevalencia_recenteQual vírus predomina nas últimas semanas (SARS-CoV-2, Influenza, VSR…), com positividade de PCR e agente predominante.
consultar_alertasDetecção ao vivo de anomalias na curva semanal (z-score sobre média móvel): sinaliza picos atípicos e o status da última semana.
perfil_sintomatologicoPrevalência de cada sintoma e letalidade entre quem o apresentou — destaca sinais de gravidade (dispneia, saturação baixa…).
consultar_bivariadaTabela de contingência entre duas variáveis com qui-quadrado, V de Cramér, Odds Ratio e Risco Relativo (IC 95%).
consultar_regressaoRegressão logística multivariada (IRLS) com aOR, IC 95% e p-valor para cada preditor, ajustando para os demais. Categoria de referência configurável.
listar_variaveisLista todas as variáveis analisáveis do SIVEP-Gripe — desfechos, comorbidades, sintomas, vacinação — com seus códigos e avisos.
Exemplos para começar
Copie e cole no assistente depois de conectar
GPT via OpenAI Responses API
Use o mesmo servidor remoto como uma ferramenta MCP do modelo
GPT via OpenAI Responses API
Use o mesmo servidor remoto como uma ferramenta MCP do modelo
A Responses API aceita servidores MCP remotos por server_url. O exemplo requer uma chave de API da OpenAI no ambiente e não envia os microdados ao modelo: apenas os resultados das ferramentas.
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-5.6",
tools: [{
type: "mcp",
server_label: "siveplens",
server_url: "https://siveplens.literato.io/api/mcp",
require_approval: "never"
}],
input: "Qual é a média de idade dos óbitos com diabetes classificados como COVID-19? Mostre N e ausências."
});
console.log(response.output_text);Modo local (avançado · desenvolvedores)
Rodar o servidor MCP via stdio no Claude Desktop, a partir do código-fonte
Modo local (avançado · desenvolvedores)
Rodar o servidor MCP via stdio no Claude Desktop, a partir do código-fonte
Para quem clonou o repositório: após npm install e npm run build dentro de mcp/, adicione o bloco abaixo ao claude_desktop_config.json e ajuste o caminho do args.
{
"mcpServers": {
"siveplens": {
"command": "node",
"args": ["/caminho/para/mcp/dist/index.js"],
"env": { "SIVEPLENS_API_URL": "https://siveplens.literato.io" }
}
}
}A variável SIVEPLENS_API_URL aponta o servidor local para a API de análise. Use a URL pública acima ou http://localhost:3000 em desenvolvimento.
Protocolo MCP (Model Context Protocol) por Streamable HTTP. Todas as análises são executadas sobre os microdados SIVEP-Gripe / OpenDataSUS — os mesmos dados do painel e da análise.