Conecta tus agentes con lo que realmente ocurrió

Antes de comenzar

• Necesitas una cuenta Notamos con MCP habilitado.
• La conexión se crea para un workspace específico y sin PHI.
• Puede ser un workspace privado de tu cuenta, o uno de trabajo si un owner o admin abrió ahí los agentes externos (Configuración → Conecta Notamos con tu agente). Él decide quién puede conectar: nadie, solo owners y admins, o todos los miembros.
• En un workspace de trabajo tu agente lee las notas que tú creaste, con sus transcripciones, tareas y momentos. Si un owner o admin lo permite, lee además las notas que otra persona compartió contigo (como Empresa, o con un equipo donde estás), con su transcripción y los momentos de quien las creó. Nunca lee las notas privadas de otra persona, tampoco si eres owner o admin. De una reunión que grabó otra persona y no compartió, tu agente recibe el título y la fecha de tu tarjeta, no su contenido.
• Qué lee tu agente en cada workspace se ve en Configuración y al autorizar la conexión, y puede cambiar: lo deciden los owners y admins de ese workspace.
• 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. Opcional: para instalar las cuatro skills en Codex, necesitas Node.js 18 o superior y la CLI de Notamos. Ejecuta primero npm install -g @notamos/cli y después:

   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.

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, 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

La CLI instala estas skills para Codex y Claude Code. Conectar el MCP en Claude web, ChatGPT o Grok no instala estas skills. El agente genera el contenido con el modelo del usuario y sus capacidades; los artefactos no se guardan automáticamente en 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

Seguridad y límites

• OAuth usa PKCE y credenciales renovables. Para claves manuales, el servidor conserva solo el hash; la CLI guarda la clave en un archivo local con permisos restringidos (0600).
• Cada request revalida membresía, workspace, permisos y estado PHI.
• En un workspace de trabajo, si un owner o admin cierra los agentes externos o deja de permitir que lean lo compartido, aplica de inmediato a las conexiones que ya existen (cerrar se puede en cualquier momento, y es una pausa: no borra la conexión); al salir del workspace, tus conexiones a él se revocan.
• Si compartes una nota como Empresa o con un equipo en un workspace donde los agentes leen lo compartido, los agentes de quienes la ven pueden leerla, con su transcripción completa. Lo que un agente ya leyó no se puede retirar.
• 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