IA con ApuntesIA

Usa IA con ApuntesIA Beta

Usa las herramientas de IA que ya estan en ApuntesIA, o conecta la IA que ya usas para que lea y escriba tus paginas a traves del servidor MCP de paginas FYI.

Esta pagina esta en Beta. Inicia sesion para usar las herramientas integradas. Las cuentas verificadas pueden crear un token MCP en Ajustes y usarlo desde Cursor, Claude u otro cliente MCP. Los skills le dicen a tu IA como usar esas herramientas con cuidado.

Herramientas de IA integradas

Abre Herramientas IA en la cabecera. Estas herramientas necesitan una cuenta. Revisa lo que escribe la IA; puede equivocarse.

Conecta tu propia IA con MCP

MCP permite que tu cliente de IA llame a las herramientas de pagina de ApuntesIA por HTTPS. Sigues en Cursor, Claude u otra app MCP, y las paginas llegan a tus documentos en la nube.

Como configurarlo

1. Inicia sesion en ApuntesIA y verifica tu correo desde Ajustes.
2. Abre Ajustes y elige Obtener token MCP. Copia el unico token de tu cuenta.
3. Anade el servidor MCP de paginas FYI a tu cliente de IA. Conserva la barra final de la URL.
4. Crea un skill con uno de los prompts de abajo para que tu IA use las herramientas nativas de pagina.

Endpoint MCP

https://api.fyinotes.com/mcp/

Ejemplo de configuracion MCP de Cursor

Guarda tu token en una variable de entorno. No lo subas a git. Reinicia el cliente de IA despues de cambiar este archivo.

{
  "mcpServers": {
    "fyi-pages": {
      "url": "https://api.fyinotes.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Skills

Un skill es un archivo corto de instrucciones que tu IA carga cuando le pides trabajar con paginas de ApuntesIA. En Cursor, guardalo como SKILL.md en .cursor/skills/ de un proyecto o en tu carpeta personal de skills. Otras IAs pueden usar el mismo texto como instruccion personalizada o skill de proyecto.

• Prefiere las herramientas nativas: create_fyi_page, get_fyi_page, add_fyi_notes y update_fyi_notes.
• Pasa updt de la ultima lectura o escritura para no sobrescribir una pagina mas nueva en la nube.
• Usa update_project_page solo si quieres reconstruir toda la pagina desde markdown. Ese camino sustituye los ids de las notas.
• Lee la especificacion markdown en /fyi-page-instructions.md antes de crear un archivo .fyi descargable.

Prompts para crear los skills

Pega un prompt en tu IA y pideles que guarden el resultado como skill.

Crea un skill llamado fyi-pages-mcp.

Cuando trabaje con paginas de ApuntesIA desde un cliente de IA, usa el servidor MCP de paginas FYI.

Incluye estas reglas en el skill:
- Nombre del servidor MCP: fyi-pages
- Endpoint: https://api.fyinotes.com/mcp/ (hace falta la barra final)
- Auth: token Bearer Authorization desde Ajustes de ApuntesIA, Obtener token MCP. Solo cuentas verificadas. Un token por cuenta.
- Prefiere las herramientas nativas: create_fyi_page, get_fyi_page, add_fyi_notes, update_fyi_notes.
- Usa add_cloud_pin_notes solo cuando pida fijar algo.
- No uses update_project_page salvo que pida reescribir toda la pagina desde markdown. Ese camino destruye los ids de las notas.
- Pasa siempre updt de la ultima lectura o escritura.
- Tipos de nota: 1 texto, 2 expandible, 3 grande, 4 URL, 5 regla, 7 encabezado, 11 JSON, 12 Mermaid.
- Antes de crear un archivo .fyi local, lee la especificacion para agentes en https://apuntesia.com/fyi-page-instructions.md.
- Manten el contenido seguro: sin scripts, manejadores de eventos, iframes, formularios ni URLs inventadas.
- No pongas contrasenas, secretos ni informacion personal muy sensible en una pagina.

Guardalo como SKILL.md con frontmatter YAML name y description, y un cuerpo markdown que el agente pueda seguir.

Crea un skill llamado fyi-page-format.

Cuando pida crear un archivo .fyi o una pagina de ApuntesIA descargable, sigue la especificacion para agentes en:

https://apuntesia.com/fyi-page-instructions.md

Reglas:
- Devuelve solo JSON valido. No lo envuelvas en markdown.
- Usa ids de nota coincidentes en d y b.
- Prefiere las herramientas MCP nativas cuando el servidor fyi-pages este conectado, en vez de emitir un archivo, salvo que pida un archivo.
- Usa version de pagina 18, version de nota 12 y version pub 4.
- Usa ty 7 para encabezados, 1 para texto, 2 para notas expandibles, 3 para notas largas, 11 para JSON y 12 para Mermaid.
- Manten el JSON seguro: sin scripts, manejadores de eventos, iframes, formularios ni enlaces inventados.

Definicion de pagina .fyi

Las herramientas de IA, scripts y skills que crean paginas fuera de la app deben seguir la definicion oficial JSON .fyi. Los agentes deben leer la especificacion markdown.

https://apuntesia.com/fyi-page-instructions.md