/start-12-3.es

description: "Lesson command"
chapter: "courses/aiagent/lesson03-core/module12-notion"
duration: "~30 min"
prerequisites: ["start-0-1"]
level: "intermediate"
tags: ["notion", "mcp", "api"]
nonInteractiveMode: incompatible

🎓 Lesson 12-3: Creacion de paginas de Notion

📍 Lo que hara en esta sesion

**Lesson 12-3** !

| Elemento | Contenido | |------|------| | Objetivo | Operar paginas y bases de datos de Notion desde Claude Code usando MCP/Notion API | | Duracion | ~30 min | | Habilidades utilizadas | Notion API, MCP（Model Context Protocol） | | Requisitos previos | Cuenta de Notion, permisos de creacion de integracion | | Pagina del curso | [Module 12: Notion](https://ai-agent.camp/es/course/module-12) como referencia paralela |

**Flujo de la sesion:** 1. Crear una integración de Notion 2. Obtener la clave API y el ID de la base de datos 3. Leer y escribir páginas y bases de datos

Al final de esta sesion, podra operar Notion desde Claude Code.

> **💡 Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continue" o "siga adelante" para reanudar. Este es un comportamiento de Cursor, no un mal funcionamiento.

---

Browser Authentication at Lesson Start (Notion MCP)

Al proceder con `/start-12-3`, puede abrirse una pantalla de **"Connect with Notion MCP"** en el navegador del lado de Notion. Esto se muestra cuando el MCP local recibe tokens a través de una URL de callback `127.0.0.1`.

**Puntos clave de operación en pantalla:**

1. **Título**: Dirá algo como "Connect with Notion MCP" o "Grant 127.0.0.1 access to Notion", indicando que es una conexión a una aplicación local. 2. **Select workspace**: Elija el espacio de trabajo para conectar del menú desplegable. 3. **Descripción de permisos**: Se enumeran elementos como el respeto al acceso de páginas/bases de datos, operaciones basadas en sus permisos, búsqueda (según el plan) y visualización de información del usuario. 4. **Cuadro de advertencia amarillo**: Se muestra una URL como **`http://127.0.0.1:<puerto>/callback`** como destino de redirección. **El número de puerto puede cambiar cada vez que se inicia**. 5. **"I recognize and trust this URL."**: **Continue** puede no activarse/avanzar a menos que **marque esta casilla**. Verifique que el contenido es un callback local antes de marcar. 6. Complete la autenticación con **Continue** y regrese al editor o al lado del cliente MCP.

Pantalla de referencia:


> **Nota**: El texto y los elementos de la interfaz pueden cambiar con las actualizaciones de Notion. Si el contenido difiere significativamente, consulte la ayuda oficial o las instrucciones más recientes del curso.

---

🎯 Verificacion de preparacion

Primero verifiquemos que todo este listo.

**Configuracion de AskQuestion:**

{
  "title": "🎯 Verificacion previa a la sesion",
  "questions": [{
    "id": "readiness",
    "prompt": "Esta listo/a?",
    "options": [
      {"id": "ready", "label": "Listo! Comencemos"},
      {"id": "check_prereq", "label": "Verificar requisitos previos"},
      {"id": "view_html", "label": "Ver primero la pagina del curso"},
      {"id": "different_lesson", "label": "Ir a otra leccion"}
    ]
  }]
}

(ready → Ir al Step 1) (check_prereq → Ejecutar verificacion de requisitos previos) (view_html → Mostrar ruta de la pagina del curso) (different_lesson → Mostrar lista de modulos)

---

🚀 Step 1: Create Notion Integration

**Requisito previo:** El servidor Notion MCP debe estar configurado. Si no está configurado, ejecute `/setup-notion` primero.

**What the AI automatically verifies:** 1. Verificar que el servidor `notion` está definido en el archivo de configuración MCP:

• Claude Code: Leer `~/.claude/mcp_settings.json` y verificar que existe `mcpServers.notion`
• Cursor: Leer `.cursor/mcp.json` y verificar que existe `mcpServers.notion`

2. Si ya está configurado -> proceder al Step 2 (creación del archivo de configuración MCP) 3. Si no está configurado -> guiar la ejecución de `/setup-notion`

**Configuracion de AskQuestion:**

{
  "title": "🚀 Step 1: Verificar integración de Notion",
  "questions": [{
    "id": "step_action",
    "prompt": "Verificaremos el estado de configuración de NOTION_API_KEY.",
    "options": [
      {"id": "check", "label": "Verificar estado de configuración"},
      {"id": "setup_notion", "label": "Configurar con /setup-notion"},
      {"id": "skip", "label": "Omitir (si ya está configurado)"}
    ]
  }]
}

(check → Verificar la entrada notion en el archivo de configuración MCP. Si está configurado, proceder al Step 2) (setup_notion → Guiar la ejecución de /setup-notion) (skip → Proceder al Step 2)

---

🚀 Step 2: Create MCP Configuration File

Utilice AskQuestion para elegir "Continuar / Solo ver el ejemplo / Omitir".

**Configuracion de AskQuestion:**

{
  "title": "🚀 Step 2: Crear archivo de configuración MCP",
  "questions": [{
    "id": "step_action",
    "prompt": "Que desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar"},
      {"id": "review", "label": "Solo ver el ejemplo"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

**Indicaciones tras la seleccion:** Entrada:

Por favor, cree el archivo de configuración MCP para Claude Code.

Archivo: ~/.claude/mcp_settings.json

Contenido (reemplace NOTION_API_KEY con su token real):
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_KEY": "secret_your_token_here"
      }
    }
  }
}

Por favor, cree el archivo.

**Resultado esperado:** Se crea el archivo de configuracion MCP. Reemplace el token real manualmente.

---

🚀 Step 3: Grant Workspace Access Permission

Si aparece **Connect with Notion MCP** en el navegador, siga las ins