Conecte seus agentes ao que realmente aconteceu

Antes de começar

• Você precisa de uma conta Notamos com MCP habilitado.
• A conexão é criada para um workspace específico sem PHI.
• Pode ser um workspace privado da sua conta, ou um workspace de trabalho onde um owner ou admin habilitou agentes externos (Configurações → Conecte o Notamos ao seu agente). Eles escolhem quem pode conectar: ninguém, apenas owners e admins, ou todos os membros.
• Em um workspace de trabalho, seu agente lê as notas que você criou, com transcrições, tarefas e momentos. Se um owner ou admin permitir, também poderá ler notas compartilhadas com você pela empresa ou por uma equipe da qual participa, com suas transcrições e os momentos de quem as criou. Nunca lê notas privadas de outra pessoa, mesmo que você seja owner ou admin. Para uma reunião gravada por outra pessoa e não compartilhada, seu agente recebe o título e a data do seu cartão, não o conteúdo.
• O que seu agente pode ler aparece nas Configurações e ao autorizar a conexão. Isso pode mudar conforme as decisões dos owners e admins do workspace.
• No Codex, você pode usar OAuth remoto sem instalar Node.js, abrir o PowerShell ou copiar uma chave.
• A CLI manual requer Node.js 18 ou superior.

Conectar o Codex sem Terminal (recomendado)

1. No Codex, abra Settings → MCP servers → Add server.
2. Escolha Streamable HTTP, dê o nome “Notamos” e use:

   https://notamos.app/api/mcp

3. Salve e clique em Authenticate. O Notamos será aberto no navegador.
4. Entre e escolha o único workspace ao qual deseja dar acesso ao agente. Os demais permanecem isolados.
5. Reinicie o Codex e digite /mcp para verificar se o Notamos está conectado.
6. Opcional: para instalar as quatro skills no Codex, você precisa do Node.js 18 ou superior e da CLI do Notamos. Execute primeiro npm install -g @notamos/cli e depois:

   notamos skills install --client codex

Este método usa o login do Notamos, PKCE e tokens renováveis. Não armazena sua senha no Codex nem exige colar segredos.

Alternativa manual com CLI

Use para Claude Code ou outros clientes que ainda não suportam OAuth remoto. Primeiro instale npm install -g @notamos/cli e crie a credencial dedicada nas Configurações.

Comando para seu sistema

Cole o comando sem executá-lo; depois copie a chave e pressione Enter no Terminal. Assim, a área de transferência envia a chave à CLI sem gravá-la no histórico. Não copie outro texto entre essas etapas.

Get-Clipboard | notamos setup --token-stdin --client codex

pbpaste | notamos setup --token-stdin --client codex

xclip -selection clipboard -o | notamos setup --token-stdin --client codex

Para Claude Code, substitua codex por claude-code. Para outro cliente, primeiro salve a chave com notamos mcp configure --token-stdin e use a configuração STDIO retornada por notamos mcp print-config.

Alternativa STDIO no Codex Desktop para Windows

notamos setup --client codex também configura o aplicativo gráfico, mesmo que o comando codex não esteja instalado. Se o diagnóstico ainda indicar erro no cliente, confira estes valores:

1. Abra Settings → MCP servers e crie “Notamos”.
2. Em “Comando”, use C:\Program Files\nodejs\npx.cmd. Se o Node estiver em outro caminho, o PowerShell pode encontrá-lo com:

   (Get-Command npx.cmd).Source

3. Adicione quatro argumentos em linhas separadas: -y, @notamos/cli@latest, mcp e serve.
4. Deixe o diretório vazio ou use a pasta do seu usuário.
5. Instale as skills explicitamente:

   notamos skills install --client codex

“Autenticação não suportada” é normal apenas nesta alternativa STDIO. Na opção remota recomendada, o botão Authenticate deve aparecer.

Verifique se está tudo pronto

notamos doctor --client codex

notamos mcp status

notamos skills status --client codex

Após reiniciar, teste em uma nova conversa:

Use o Notamos para listar minhas últimas aulas e suas datas.

Use o Notamos para criar flashcards interativos das minhas aulas recentes.

Skills acadêmicas incluídas

A CLI instala estas skills para Codex e Claude Code. Conectar o MCP no Claude web, ChatGPT ou Grok não instala essas skills. O agente gera o conteúdo com o modelo do usuário e suas capacidades; os artefatos não são salvos automaticamente no Notamos.

Outros clientes MCP

Obtenha a configuração STDIO sem incluir a chave:

notamos mcp print-config

O endpoint remoto é https://notamos.app/api/mcp. Clientes HTTP que suportam cabeçalhos podem usar a credencial como Authorization: Bearer ….

Ferramentas disponíveis

Segurança e limites

• O OAuth usa PKCE e credenciais renováveis. Para chaves manuais, o servidor guarda apenas o hash; a CLI armazena a chave em um arquivo local com permissões restritas (0600).
• Cada requisição revalida a associação, o workspace, as permissões e o status de PHI.
• Em um workspace de trabalho, desabilitar agentes externos ou o acesso ao conteúdo compartilhado afeta imediatamente as conexões existentes. Owners e admins podem pausar o acesso a qualquer momento sem excluir a conexão. Ao sair do workspace, suas conexões a ele são revogadas.
• Se compartilhar uma nota com a empresa ou uma equipe em um workspace onde agentes podem ler conteúdo compartilhado, os agentes de quem pode vê-la também poderão ler sua transcrição completa. O conteúdo já lido por um agente não pode ser retirado.
• As ferramentas são somente leitura e têm paginação e limites de uso.
• A geração acontece no seu agente: as skills não chamam /api/ask nem consomem uma geração do Notamos.
• A auditoria registra a ferramenta e o cliente, não a consulta nem seu conteúdo.

Solução de problemas