Conectar sua IA ao Canvas

Caderno+ MCP · um programa separado da extensão · não oficial · beta

Os três passos em 16 segundos, com notas de exemplo.

Com o Caderno+ MCP, a sua IA (Claude, ChatGPT desktop, Gemini CLI, Codex, Claude Code e outras) consegue responder "quanto falta em cada matéria?", "o que eu ainda não entreguei?" e "o que vence esta semana?" com os seus dados do Canvas da PUCPR. Ele roda no seu computador e pergunta para a extensão Caderno+, que lê o Canvas com o login do seu navegador: sem token, sem arquivo de dados e sem servidor nosso no meio. Só lê: não entrega trabalho, não responde quiz, não manda mensagem, não marca nada.

Antes de conectar, saiba:

O que a IA consulta (notas, prazos, títulos de avisos e módulos, nomes das matérias) vai para o app de IA e, por ele, para a nuvem da empresa da IA (por exemplo, a Anthropic no Claude). Fica no histórico da conversa.
A IA consulta sozinha durante a conversa, sem pedir a cada vez (as consultas só leem). Títulos escritos no Canvas podem ter nomes de professores ou colegas.
O navegador precisa estar aberto, com o Caderno+, e você logado no Canvas. Enquanto a ponte estiver ligada, o processo de fundo do Caderno+ fica acordado.
A ponte só aceita leituras de uma lista fixa de endereços do Canvas e do Centro de Notas. Ela fica num canal do seu computador que só o seu usuário abre; programas que rodam com o seu próprio usuário conseguem usá-la.
É uma ferramenta não oficial. A política de API da Instructure (dona do Canvas), item 3(i), proíbe acessar o Canvas por servidores MCP que ela não aprovou, e o Caderno+ MCP não é aprovado pela Instructure nem pela PUCPR. Use por sua conta. (A documentação do Canvas não permite que um app usado por várias pessoas peça um token criado à mão; por isso a ponte não usa token. OAuth exigiria uma chave da PUCPR.)

1. Instale o Caderno+ MCP no app da IA beta

Versão beta, só por estes caminhos. Instale só o arquivo desta página ou o pacote caderno-mcp do npm, publicado por bossmann (npmjs.com/package/caderno-mcp). Não instale cópias com nome parecido.

Claude Desktop (Mac e Windows)

Baixe caderno-mcp-1.7.3.mcpb e abra com dois cliques. O Claude pede o id da extensão: copie da página Sua IA do Caderno+ (Mais → Sua IA). Com ele, o Caderno+ MCP registra a ponte no seu navegador sozinho.

Outros apps (ChatGPT desktop, Codex, Gemini CLI, Claude Code, Cursor, VS Code)

Precisam do Node.js 18 ou mais novo. No terminal (o comando da ponte, com o seu id, está pronto para copiar na página Sua IA do Caderno+):

npm install -g caderno-mcp
caderno-mcp ponte <id da extensão>
caderno-mcp setup

O ponte registra a ponte nos navegadores que você tem (Chrome, Brave, Edge, Chromium): um arquivo de registro do navegador, nenhum dado seu. O setup mostra a linha de configuração pronta para cada app; cole a do seu. O ChatGPT desktop usa a mesma configuração do Codex (~/.codex/config.toml).

2. Ligue a ponte

Na extensão: Mais → Sua IA → Ligar a ponte. O navegador pede para o Caderno+ "se comunicar com aplicativos nativos cooperativos": é a ponte. Depois, caderno-mcp ponte status diz se está tudo ligado.

Só pela web (ChatGPT web, Claude web, Gemini app)

Não funcionam: esses apps só falam com servidores na internet, e o Caderno+ MCP fica no seu computador de propósito. No ChatGPT, use o app desktop.

3. Pergunte

"Quanto falta em cada matéria?", "o que vence esta semana?", "o que eu ainda não entreguei?", "quantas tentativas tenho no quiz de Conectividade?", "quais avisos novos?", "quais módulos tem em Banco de Dados?". Pode chamar a matéria pelo nome, sem acento ou só por um pedaço ("banco", "imperativa"). O Caderno+ MCP lê só o Canvas da PUCPR (pucpr.instructure.com) e o Centro de Notas, e os números de "quanto falta" seguem as mesmas regras do painel do Caderno+.

Parar

caderno-mcp ponte remove tira a ponte dos navegadores; remova também o Caderno+ MCP do app (no Claude Desktop, em Configurações → Extensões).

Uso pessoal com token (sem a ponte)

Para usar sem o navegador aberto, dá para guardar um token do Canvas seu (Conta → Configurações → + Novo token de acesso) no cofre do sistema com caderno-mcp login. A documentação do Canvas não permite pedir isso a outros alunos: é só para você. O token dá acesso total à sua conta; nunca cole em chat. Revogue no Canvas quando quiser; caderno-mcp logout apaga do cofre. Com a ponte ligada, ela é usada primeiro.

Veja também a política de privacidade. Código aberto: github.com/Bossmann007/Campus.