mcp-adalove
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-adalove list this week's activities for turma 1T"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-adalove
Servidor MCP (leitura, somente GET) para o Adalove — plataforma acadêmica do Inteli. Ver CLAUDE.md para as regras de segurança do projeto e docs/v1.md para a especificação completa desta versão.
O que esta versão faz
Uma única tool: listar_semana(numero_semana?, turma?, detalhado?), que
retorna markdown com as atividades de uma semana de uma turma.
Related MCP server: MCP-Server-CollageAI
Instalação
Requer Python ≥ 3.11 e uv.
uv syncConfiguração — ADALOVE_REFRESH_TOKEN
O servidor renova o access token automaticamente via Cognito, então só precisa de um refresh token configurado uma vez (dura semanas — ver docs/01-auth-tokenizacao.md).
Como obter o refresh token
Faça login normalmente em https://adalove.inteli.edu.br.
Abra o DevTools do navegador (F12) → aba Application (Chrome) ou Storage (Firefox) → Local Storage →
https://adalove.inteli.edu.br.Procure uma chave no formato
CognitoIdentityServiceProvider.6v6iqlcv6hl5p3u628geho1cjp.<sub>.refreshToken(o<sub>é um UUID específico da sua conta).Copie o valor — é uma string opaca longa (não é um JWT).
Nunca cole esse valor em um arquivo do projeto, em um commit, ou em
qualquer lugar que não seja a configuração de ambiente da sua ferramenta
MCP. Trate-o como uma senha: com ele, qualquer cliente HTTP consegue gerar
access tokens novos em seu nome (ver docs/01, seção "Renovação via
refresh_token").
Claude Desktop
Edite o arquivo de configuração do Claude Desktop
(claude_desktop_config.json) e adicione:
{
"mcpServers": {
"adalove": {
"command": "uv",
"args": ["--directory", "/caminho/absoluto/para/mcp-adalove", "run", "mcp-adalove"],
"env": {
"ADALOVE_REFRESH_TOKEN": "<seu refresh token>"
}
}
}
}Reinicie o Claude Desktop depois de editar.
Se ADALOVE_REFRESH_TOKEN não estiver configurado, o servidor sobe
normalmente (não derruba o processo) — a tool apenas responde explicando
como configurá-lo.
Rodando os testes
Todos os testes rodam contra fixtures locais, sem rede e sem token:
uv run pytestTestando contra a API real
uv run scripts/smoke_test.pyEsse script faz chamadas reais (GET /sections, GET /sections/{uuid}/userdata)
usando o ADALOVE_REFRESH_TOKEN do ambiente e imprime o markdown formatado.
Não é executado automaticamente — é o passo de validação manual do usuário,
fora do escopo do build.
Escopo
Ver docs/v1.md §9 ("Escopo negativo") para o que foi deliberadamente deixado de fora desta versão.
Available Tools
1 toollistar_semanaA
Lista as atividades de uma semana de uma turma do Adalove.
Args: numero_semana: número da semana (ex.: 5 casa com "Semana 05"). Se omitido, a semana é inferida (atividade com data mais próxima de hoje, ou cálculo a partir do início da turma). turma: caption ou uuid da turma. Se omitido, usa a turma aberta (ou pede para escolher, se houver mais de uma). detalhado: se True, mostra a descrição completa de cada atividade em vez de truncada em ~200 caracteres.
Inputs: turma, detalhado, numero_semana. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of confusion between tools. The purpose of listing week activities is clear and unambiguous.
The single tool name 'listar_semana' follows a consistent verb-noun pattern (list + week). While there's no broader pattern to compare, the name is descriptive and internally consistent.
A single tool for an LMS (Adalove) feels thin. The scope appears to be at least course management, but only listing weekly activities is provided, making the count borderline low.
The tool surface is severely incomplete for an LMS domain. Only a read-only list operation exists, with no create, update, delete, or management capabilities for courses, students, or activities.
Maintenance
Related MCP Connectors
Web/PDF to Markdown, transcription, paper search and citation checks. Pay per call in USDC via x402.
Read any public web page as clean Markdown for LLMs. Respects robots.txt. Free tier; x402 paid API.
Read any web page as clean Markdown for AI agents: fetch, search, metadata, links. SSRF-safe.
Web data for marketing agents: traffic, ads, social profiles, search, and any URL as markdown.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceGenerates weekly review reports in Markdown format based on AI session data and optional user annotations.MIT
- FlicenseNot gradedqualityDmaintenanceProvides tools for querying student academic data such as subjects, marks, performance reports, timetable, exams, fees, events, holidays, and assignments via natural language.-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with Moodle LMS, fetching assignments, grades, deadlines, course content, and syncing to Obsidian, with WhatsApp alerts and class-slot filtering.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query METU's ODTUClass LMS for enrolled courses, announcements, syllabi, assignment deadlines, and lab/recitation schedules using credential or token authentication.1GPL 2.0