sigaa-ifsc-mcp

Servidor MCP para consultar o portal do discente do SIGAA do IFSC: perfil, turmas, notas, frequência, tarefas, notícias e avaliações.

A navegação e a extração de dados foram portadas da biblioteca sigaa-api, de Geovane Schmitz.

Projeto não oficial, sem vínculo com o IFSC.

Autenticação

O login do SIGAA tem um CAPTCHA (Cloudflare Turnstile), então este servidor não digita a sua senha nem resolve o CAPTCHA. Quem loga é você, numa janela do navegador que o próprio servidor abre:

1. Você pede algo ao Claude (por exemplo, "quais são minhas notas?").

2. Se não houver sessão válida, o servidor abre uma janela do Edge (no Windows) ou do Chromium na tela de login do SIGAA.

3. Você entra normalmente. Quando o portal do discente abre, o servidor captura o cookie JSESSIONID, fecha a janela e responde ao que você pediu.

O perfil desse navegador fica salvo em ~/.sigaa-mcp/browser-profile. Se você deixar o navegador lembrar a senha, os próximos logins são só clicar em "Entrar".

Para logar sem esperar uma consulta, use a ferramenta login_navegador ou o comando sigaa-mcp login. Para desligar a janela automática, use SIGAA_AUTO_LOGIN=0.

Alternativa: colar o cookie. Entre em https://sig.ifsc.edu.br/sigaa no seu navegador, abra as ferramentas de desenvolvedor (F12) > Application > Cookies > https://sig.ifsc.edu.br, copie o valor de JSESSIONID e chame definir_cookie, ou rode:

sigaa-mcp cookie SEU_JSESSIONID

O cliente MCP precisa esperar enquanto você loga. No Claude Code, se a ferramenta der timeout antes de você terminar, aumente MCP_TOOL_TIMEOUT (em milissegundos).

Manter a sessão viva

A sessão do SIGAA expira por inatividade. Enquanto o servidor estiver rodando, ele acessa o portal a cada 10 minutos (SIGAA_KEEPALIVE_MIN) para a sessão não cair. Para manter a sessão ativa também com o cliente MCP fechado, deixe isto rodando num terminal:

sigaa-mcp keepalive

O keepalive não evita que a sessão termine se o SIGAA reiniciar ou impuser um tempo máximo de sessão. Quando ela cair, as ferramentas avisam e explicam como reconectar.

O cookie fica salvo em ~/.sigaa-mcp/session.json. Ele dá acesso à sua conta enquanto a sessão estiver ativa: não compartilhe esse arquivo.

Related MCP server: sigaa-ufrpe

Instalação

Cole no terminal o comando do seu sistema. O instalador coloca o uv (se faltar), instala o servidor, prepara o navegador do login por janela e registra o servidor no Claude Code e no Claude Desktop, se estiverem instalados.

Linux (inclusive Arch) e macOS

curl -fsSL https://raw.githubusercontent.com/heitorsDev/sigaa-ifsc-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/heitorsDev/sigaa-ifsc-mcp/main/install.ps1 | iex

Rodar o mesmo comando de novo atualiza para a versão mais recente.

No Arch, o instalador usa o pacman (pede sudo) para instalar o uv e, se não houver Chromium/Chrome, o chromium. No Windows, o login usa o Edge. Nos outros casos, ele usa o Chrome/Chromium do sistema ou baixa o do Playwright.

Variáveis opcionais do instalador: SIGAA_MCP_REF (branch ou tag), SIGAA_MCP_NAME (nome do servidor, padrão sigaa) e SIGAA_BROWSER_PATH.

Instalação manual

uv tool install "sigaa-ifsc-mcp @ https://github.com/heitorsDev/sigaa-ifsc-mcp/archive/main.zip"
claude mcp add --scope user sigaa -- sigaa-mcp

Para o Claude Desktop (claude_desktop_config.json), use o caminho completo mostrado por uv tool dir --bin:

{
  "mcpServers": {
    "sigaa": { "command": "/caminho/para/sigaa-mcp", "args": [] }
  }
}

Fora do Windows, sem Chrome/Chromium no sistema, rode sigaa-mcp install-browser.

Ferramentas

turma aceita o código ou um trecho do nome da disciplina, sem acentos.

Moodle

O servidor também acessa o Moodle do IFSC pela API oficial do app Moodle Mobile. O instalador pergunta usuário e senha do Moodle no terminal e troca por um token de API; a senha não é salva, só o token (em ~/.sigaa-mcp/moodle.json). Para refazer o login:

sigaa-mcp moodle-login

Os cursos de antes de 2026 ficam em outro site (moodle4.ifsc.edu.br). Para acessá-los, rode sigaa-mcp moodle-login --antigo e use site="antigo" nas ferramentas.

Os cursos do Moodle são criados a partir das turmas do SIGAA: o idnumber é COMPONENTE<id da turma> e o nome curto começa com o código do componente. moodle_cursos devolve esses dois campos, e curso aceita o código do componente (ex.: CAB22402).

Todas aceitam site ("atual" ou "antigo"). Entregar tarefa, postar em fórum e mandar mensagem só acontecem com confirmar=true; antes disso a ferramenta devolve uma prévia para você aprovar.

Envios

enviar_tarefa e enviar_formulario mudam dados no SIGAA em seu nome. Por isso, sem confirmar=true elas só mostram uma prévia do que seria enviado. O Claude deve mostrar essa prévia e pedir a sua aprovação antes de confirmar.

O formulário de entrega de tarefa ainda não foi visto aberto: quando o explorei, nenhuma tarefa estava no prazo. enviar_tarefa procura o campo de arquivo, o de comentário e o botão "Enviar" por heurística. Se falhar, a navegação genérica (formularios_pagina + enviar_formulario) cobre o caso.

Variáveis de ambiente

Limitações

• A grade de horários do SIGAA do IFSC só existe no comprovante de matrícula, e turmas de horário flexível não aparecem desenhadas nela. grade_horarios monta a grade decodificando os códigos de horário (24M34 = seg e qua, manhã, 3ª e 4ª aulas), respeitando o período de validade de cada padrão.

• A área pública do SIGAA (/sigaa/public) exige CAPTCHA mesmo para quem está logado, então o servidor não a usa. As buscas partem do portal do discente.

• A biblioteca (SophiA) é um sistema separado, fora do SIGAA, e não está coberta.

• Se você tiver mais de um vínculo (por exemplo, dois cursos), o servidor usa o vínculo escolhido na sessão do navegador.

• O HTML do SIGAA muda com o tempo; se uma ferramenta parar de funcionar, secao_turma e abrir_pagina ainda devolvem o texto cru da página.