> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xkat.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de IA MCP

> Conecta agentes de IA como Claude, Cursor y Antigravity para generar e importar cursos al instante.

Conecta agentes de IA externos (Claude Code, Cursor, Antigravity y otras herramientas compatibles con Model Context Protocol) a xkat. Con una sola instrucción en lenguaje natural, el agente de IA puede explorar entornos de laboratorio disponibles, redactar una guía práctica completa según las reglas del dominio e importarla directamente a tu cuenta como borrador privado.

## Flujo de trabajo rápido

<Steps>
  <Step title="Conectar mediante token de acceso personal">
    Genera un token de acceso en [Ajustes → Tokens de IA](https://xkat.space/es/settings/ai-tokens) y registra el endpoint remoto de MCP (`https://mcp.xkat.space/mcp`) en la configuración de tu agente.
  </Step>

  <Step title="Pedir al agente con una instrucción">
    Pídele en lenguaje natural: *"Crea una guía práctica para instalar Debian 12 en QEMU."*
  </Step>

  <Step title="Exploración y generación de la guía">
    El agente consulta `list_lab_profiles` y `get_guide_spec` para conocer los entornos admitidos (`debian_qemu`) y las reglas de redacción (un comando por tarjeta, diagramas Mermaid, sin exponer fontanería interna).
  </Step>

  <Step title="Importación instantánea y enlace del reproductor">
    El agente invoca `import_draft_guide` para guardar el curso como borrador privado en tu cuenta y devuelve el enlace directo del reproductor (`https://xkat.space/es/player/<id>`).
  </Step>
</Steps>

## Configuración del cliente

Añade el servidor MCP remoto de xkat al archivo de configuración de tu agente:

<Tabs>
  <Tab title="Claude Code (.mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "type": "http",
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor (.cursor/mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Antigravity (mcp_config.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "serverUrl": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Herramientas MCP disponibles

| Herramienta | Propósito |
| :- | :- |
| `import_draft_guide` | Valida y guarda directamente una guía (XML/YAML/JSON) como borrador privado en tu cuenta, devolviendo el enlace del reproductor. |
| `get_guide_spec` | Devuelve especificaciones y reglas de redacción para dominios como `os-install`, `linux-cli` o `database-sql`. |
| `list_plugins` | Devuelve los complementos de visor disponibles (`desktop-viewer`, `linux-wasix`, etc.). |
| `list_lab_profiles` | Devuelve los entornos de laboratorio admitidos (`debian_qemu`, `ubuntu_qemu`, etc.). |
| `validate_course` | Valida la estructura del curso y el esquema XML sin escribir en la base de datos. |
| `build_course` | Valida el curso y devuelve el XML formateado sin persistir en la base de datos. |

## Recursos expuestos

| URI del recurso | Descripción |
| :- | :- |
| `catalog://plugins` | Catálogo de complementos de visor y funciones de ejecución. |
| `catalog://lab-profiles` | Catálogo de perfiles de laboratorio y máquinas virtuales/contenedores. |
| `spec://os-install` | Pautas de redacción y reglas de insignias para guías de instalación de SO. |
| `schema://course` | Esquema JSON para la validación de la estructura del curso. |
| `template://sample-course` | Curso de referencia en YAML para el aprendizaje del agente. |

## Cuotas y límites de importación

La importación con `import_draft_guide` consume la cuota mensual de tu membresía:

* **Free** — Importación MCP no disponible (validación y construcción sí).
* **Basic** — 5 importaciones al mes.
* **Pro** — 10 importaciones al mes.
* **Creator** — Ilimitado.

<Tip>
  Las guías importadas mediante MCP se guardan con `isPublished: false`, por lo que permanecen estrictamente privadas en tu cuenta hasta que las revises y publiques en Studio.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.