/start-12-1.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: deferred

🎓 Lesson 12-1: Conexion API de Notion

📍 Lo que hara en esta sesion

**Lección 12-1: Fundamentos de Notion API**!

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

---

🎯 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

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

**Configuracion de AskQuestion:**

{
  "title": "🚀 Step 3: Permiso de acceso al espacio de trabajo",
  "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, explique cómo otorgar permisos de acceso a la integración en Notion.

Pasos:
1. Abrir una página en Notion
2. Menú "..." en la esquina superior derecha > Connections
3. Añadir la integración creada "Claude MCP Integration"

Nota: Solo las páginas debajo de la página donde se añadió la integración serán accesibles.

**Resultado esperado:** Se explican los pasos para configurar permisos de acceso a paginas de Notion.

---

🚀 Step 4: Connection Test

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

**Configuracion de AskQuestion:**

{
  "title": "🚀 Step 4: Prueba de conexión",
  "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:

Realizaremos una prueba de conexión de Notion MCP.

Por favor, verifique lo siguiente:
1. El archivo de configuración MCP (~/.claude/mcp_settings.json) existe
2. NOTION_API_KEY está configurado
3. Reinicie Cla