Notamos MCP

Conecta tus agentes con lo que realmente ocurrió

Notamos MCP es una conexión read-only por workspace. Entrega retrieval y datos estructurados; Codex, Claude u otro agente conectado realiza la síntesis con tu propia cuenta.

Antes de comenzar

  • Necesitas una cuenta Notamos con MCP habilitado.
  • La conexión se crea para un workspace específico y sin PHI.
  • En Codex puedes usar OAuth remoto sin instalar Node.js, abrir PowerShell ni copiar una clave.
  • El CLI manual requiere Node.js 18 o superior.

Conectar Codex sin Terminal (recomendado)

  1. En Codex abre Settings → MCP servers → Add server.
  2. Elige Streamable HTTP, nómbralo “Notamos” y usa:
    https://notamos.app/api/mcp
  3. Guarda y pulsa Authenticate. Se abrirá Notamos en el navegador.
  4. Inicia sesión y elige el único workspace que quieres entregar al agente. Los demás permanecen aislados.
  5. Reinicia Codex y escribe /mcp para comprobar que Notamos está conectado.
  6. Instala los cuatro skills para obtener artifacts visuales, no solo respuestas de texto:
    notamos skills install --client codex

Este camino usa el login de Notamos, PKCE y tokens renovables. No guarda tu contraseña en Codex y no requiere pegar secretos.

Alternativa manual con CLI

Úsala para Claude Code u otros clientes que todavía no manejen OAuth remoto. Instala primero npm install -g @notamos/cli y crea la credencial dedicada desde Configuración.

Comando según tu sistema

Copia y pega el comando sin ejecutarlo; después copia la clave y presiona Enter en Terminal. Así el portapapeles envía la clave al CLI sin escribirla en el historial. No copies otro texto entre esos pasos.

Windows PowerShell

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

macOS

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

Linux con xclip

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

Para Claude Code, reemplaza codex por claude-code. Para otro cliente, guarda primero la clave con notamos mcp configure --token-stdin y usa la configuración STDIO que devuelve notamos mcp print-config.

Fallback STDIO en Codex Desktop para Windows

notamos setup --client codex configura también la aplicación gráfica, aunque el comando codex no esté instalado. Si el diagnóstico todavía marca el cliente con error, revisa estos valores:

  1. Abre Settings → MCP servers y crea “Notamos”.
  2. En “Comando” usa C:\Program Files\nodejs\npx.cmd. Si Node está en otra ruta, PowerShell puede encontrarla con:
    (Get-Command npx.cmd).Source
  3. Agrega cuatro argumentos en filas separadas: -y, @notamos/cli@latest, mcp y serve.
  4. Deja el directorio vacío o usa la carpeta de tu usuario.
  5. Instala los skills explícitamente:
    notamos skills install --client codex

“Autenticación no admitida” solo es normal para este fallback STDIO. En la opción remota recomendada debe aparecer el botón Authenticate.

Comprueba que quedó listo

notamos doctor --client codex
notamos mcp status
notamos skills status --client codex

Después del reinicio, prueba en una conversación nueva:

Usa Notamos para listar mis últimas clases y sus fechas.
Usa Notamos para crear flashcards interactivas de mis clases recientes.

Skills académicos incluidos

notamos-study-guide

Guías estructuradas con objetivos, conceptos, práctica y fuentes.

notamos-flashcards

Tarjetas para active recall, también exportables a TSV o JSON.

notamos-quiz

Quizzes con respuestas, rúbrica, corrección y citas.

notamos-study-presentation

Presentaciones con narrativa, notas y fuentes por diapositiva.

Los skills consultan el MCP read-only y el agente conectado hace la generación con el modelo del usuario. Los artifacts visuales pueden usar la identidad de Notamos; hoy no se guardan automáticamente dentro de Notamos.

Otros clientes MCP

Obtén la configuración STDIO sin incluir la clave:

notamos mcp print-config

El endpoint remoto es https://notamos.app/api/mcp. Los clientes HTTP que admiten headers pueden usar la credencial como Authorization: Bearer ….

Herramientas disponibles

get_workspace_profile

Confirma el workspace y su categoría.

list_courses

Lista cursos y carpetas con paginación.

list_notes

Recorre notas por curso y fecha.

search_notes

Busca texto y devuelve extractos citables.

get_note

Lee resumen, contenido y metadatos autorizados.

get_transcript_segments

Lee el transcript por segmentos, hablantes y tiempos.

list_tasks

Consulta tareas y fechas civiles.

list_moments

Consulta banderas y momentos analizados.

Seguridad y límites

  • OAuth usa PKCE y credenciales renovables; el fallback guarda solo el hash de la clave.
  • Cada request revalida membresía, workspace, permisos y estado PHI.
  • Las herramientas son de lectura y tienen paginación y límites de uso.
  • La generación sucede en tu agente: los skills no llaman a /api/ask ni consumen una generación de Notamos.
  • La auditoría registra herramienta y cliente, no la consulta ni su contenido.

Solución de problemas

La clave no tiene formato MCP

Vuelve a copiar únicamente la clave que comienza con ntm_mcp_.

Codex dice que Notamos no está disponible

Si usas OAuth, confirma la URL, pulsa Authenticate y reinicia Codex. Si usas el fallback, ejecuta notamos doctor --client codex.

No aparecen los skills

Ejecuta notamos skills install --client codex o --client claude-code y vuelve a iniciar el cliente.

La nota no aparece

Confirma que la conexión fue creada dentro del workspace correcto y que todavía tienes acceso a esa nota.