Su agente de IA debería poder mostrar las notas de la reunión del martes pasado sin que usted tenga que buscar en carpetas. Con la API de ScreenApp y el Model Context Protocol (MCP), puede dar a los agentes de OpenClaw acceso directo a sus grabaciones, transcripciones y resúmenes de IA.

Esta guía explica cómo construir una habilidad de servidor MCP de ScreenApp para que su agente de OpenClaw pueda buscar grabaciones, obtener transcripciones y ejecutar análisis de IA en su contenido, todo desde un mensaje de chat en Telegram, WhatsApp o Discord.

Si es nuevo en los servidores MCP para grabaciones de reuniones, consulte nuestra comparación de los mejores servidores MCP para reuniones para ver cómo se compara ScreenApp.

¿Qué es OpenClaw?

OpenClaw es una puerta de enlace autoalojada que conecta aplicaciones de mensajería (WhatsApp, Telegram, Discord, iMessage) con agentes de codificación de IA. Usted ejecuta un único proceso en su máquina y este conecta sus aplicaciones de chat a un asistente de IA siempre disponible.

La idea clave: usted envía un mensaje a su agente desde su teléfono, y este puede usar herramientas, leer archivos, navegar por la web y, ahora, acceder a sus grabaciones de ScreenApp.

OpenClaw utiliza habilidades para enseñar a los agentes a usar herramientas. Cada habilidad es una carpeta con un archivo SKILL.md que describe los comandos disponibles. Las habilidades también pueden envolver servidores MCP, que es como conectaremos ScreenApp.

OpenClaw descubre habilidades a través de un sistema de tres niveles. Al inicio de la sesión, el agente escanea el name y la description de la portada de cada habilidad. Cuando una habilidad parece relevante, carga el SKILL.md completo. Esto significa que su campo de descripción es el factor más importante para que el agente elija su habilidad. Escríbalo como si le estuviera diciendo a un compañero de trabajo qué hace la habilidad y cuándo usarla.

¿Qué es MCP?

Model Context Protocol es un estándar creado por Anthropic que permite a los modelos de IA acceder a fuentes de datos externas. Piense en ello como USB-C para aplicaciones de IA. En lugar de copiar y pegar transcripciones en ChatGPT, un servidor MCP permite que la IA obtenga lo que necesita directamente.

Los servidores MCP se ejecutan localmente y exponen herramientas (acciones que la IA puede realizar) y recursos (datos que la IA puede leer). Para ScreenApp, las herramientas incluirían cosas como “buscar grabaciones”, “obtener transcripción” y “hacer una pregunta sobre un video”.

MCP funciona con Claude Desktop, ChatGPT Desktop, Cursor y, a través de OpenClaw, cualquier aplicación de mensajería.

Descripción general de la API de ScreenApp

ScreenApp proporciona una API REST que cubre todo lo que necesita para una integración MCP. Los principales puntos finales:

• Listar grabaciones - Explore su biblioteca de grabaciones con filtros
• Obtener grabación con transcripción - Obtenga una grabación y su transcripción completa, con marcas de tiempo y etiquetas de orador
• Análisis de IA - Haga preguntas sobre una grabación usando el punto final de análisis multimodal (/v2/files/{fileId}/ask/multimodal)
• Buscar - Encuentre grabaciones por palabra clave en todo su contenido
• Cargar - Envíe nuevos archivos de audio/video para su procesamiento

La autenticación utiliza tokens Bearer. Puede generar un token de API desde la configuración de su cuenta de ScreenApp.

Para la referencia completa, consulte la documentación de la API de ScreenApp.

Pasos de configuración

1. Obtén tu token de API de ScreenApp

Inicia sesión en ScreenApp, ve a Configuración > API y genera un nuevo token. Cópialo en un lugar seguro. Lo necesitarás en el siguiente paso.

2. Crea la carpeta de la habilidad

Las habilidades de OpenClaw residen en ~/.openclaw/skills/ (compartidas entre agentes) o en la carpeta /skills/ de tu espacio de trabajo (por agente). El nombre de la carpeta de la habilidad debe coincidir con el campo name en el frontmatter de tu SKILL.md. Crea la estructura completa:

mkdir -p ~/.openclaw/skills/screenapp/references

El diseño final de la carpeta:

screenapp/
├── SKILL.md              # Obligatorio: frontmatter + instrucciones del agente
├── claw.json             # Para la publicación en ClawHub (opcional)
└── references/
    └── api-endpoints.md  # Documentos detallados de los endpoints cargados bajo demanda

3. Escribe el SKILL.md

El campo description es lo que determina si el agente selecciona esta habilidad. OpenClaw escanea el name y description de cada habilidad instalada al inicio de cada sesión. Incluye frases de activación y variantes de palabras clave para que el agente lo relacione con solicitudes sobre transcripciones, reuniones, grabaciones y toma de notas.

Crea ~/.openclaw/skills/screenapp/SKILL.md:

---
name: screenapp
description: Busca grabaciones y transcripciones de reuniones, obtiene notas de reuniones y elementos de acción, transcribe audio y video, hace preguntas de IA sobre contenido grabado. Usa cuando el usuario menciona transcripción, notas de reuniones, grabaciones, audio a texto, voz a texto, búsqueda de reuniones, o quiere encontrar o analizar reuniones y llamadas grabadas.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---

# Integración con ScreenApp

Accede a las grabaciones, transcripciones y análisis de IA de ScreenApp del usuario.

## Autenticación

Todas las solicitudes requieren la variable de entorno SCREENAPP_API_TOKEN.

Cabeceras: Authorization: Bearer $SCREENAPP_API_TOKEN
URL base: https://api.screenapp.io

## Acciones disponibles

#

## Buscar grabaciones por palabra clave
GET /v2/files?searchQuery={query}

Usa esto cuando el usuario quiera encontrar una reunión, grabación o tema específico.

#

## Obtener una grabación con su transcripción
GET /v2/files/{fileId}

Devuelve el objeto de grabación completo, incluyendo la transcripción con marcas de tiempo y etiquetas de orador. Usa esto para recuperar notas de reuniones, releer lo que se dijo u obtener el texto completo de una llamada.

#

## Preguntar a la IA una pregunta sobre una grabación
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "tu pregunta aquí" }

Analiza tanto el contenido de la transcripción como el del video. Usa esto para resumir reuniones, extraer elementos de acción o responder preguntas específicas sobre lo que ocurrió en una grabación.

#

## Listar grabaciones recientes
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10

Usa esto cuando el usuario pregunte por sus últimas reuniones o grabaciones recientes.

Opcionalmente, crea references/api-endpoints.md con documentación de parámetros más detallada. El agente carga los archivos de referencia solo cuando los necesita, manteniendo el escaneo inicial de habilidades ligero.

4. Establecer el token de la API

Añade tu token de ScreenApp al entorno de OpenClaw. Edita ~/.openclaw/openclaw.json:

{
  "env": {
    "SCREENAPP_API_TOKEN": "tu-token-aquí"
  }
}

O expórtalo en tu perfil de shell si lo prefieres.

5. Reiniciar OpenClaw

openclaw gateway restart

El agente adoptará la nueva habilidad en la próxima sesión. Puedes verificar que se cargó preguntándole a tu agente: “¿Qué habilidades tienes?“

6. Pruébalo

Envía un mensaje a tu agente de OpenClaw en Telegram o WhatsApp:

• “Busca en mis grabaciones de ScreenApp la discusión sobre la hoja de ruta del producto”
• “Obtén la transcripción de mi última reunión”
• “¿Qué elementos de acción surgieron del standup de ayer?”

El agente utilizará la habilidad de ScreenApp para obtener los datos y responder a tu pregunta.

Publicar en ClawHub

Si quieres que otros usuarios de OpenClaw encuentren e instalen tu habilidad de ScreenApp, publícala en ClawHub, el registro oficial de habilidades de OpenClaw. ClawHub utiliza la búsqueda vectorial, por lo que las consultas en lenguaje natural como “buscar transcripciones de reuniones” o “transcribir grabaciones de audio” harán que tu habilidad aparezca siempre que la descripción cubra esos términos.

Añade un manifiesto claw.json a la carpeta de tu habilidad:

{
  "name": "screenapp",
  "version": "1.0.0",
  "description": "Busca grabaciones de reuniones, obtén transcripciones, extrae elementos de acción y haz preguntas a la IA sobre el contenido grabado a través de la API de ScreenApp.",
  "author": "your-clawhub-username",
  "license": "MIT",
  "permissions": ["network"],
  "entry": "SKILL.md",
  "tags": ["transcription", "meetings", "recordings", "note-taking", "productivity", "speech-to-text"],
  "models": ["claude-*", "gpt-*", "gemini-*"],
  "minOpenClawVersion": "0.8.0"
}

Luego publica:

clawhub publish ~/.openclaw/skills/screenapp

Una vez publicada, cualquiera puede instalarla con:

clawhub install screenapp

Tu habilidad también aparecerá en Moltbook, un índice multiplataforma que lista habilidades para OpenClaw, Claude Code, Cursor y otras herramientas de codificación de IA. Moltbook indexa ClawHub automáticamente, por lo que no hay ningún paso adicional.

Construyendo un servidor MCP (avanzado)

Si deseas un servidor MCP adecuado en lugar de un enfoque basado en habilidades, puedes envolver la API de ScreenApp en un servidor MCP de Node.js. Esto te proporciona compatibilidad con Claude Desktop, Cursor y cualquier otro cliente MCP, no solo con OpenClaw.

// screenapp-mcp/index.js
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

const server = new McpServer({
  name: "screenapp",
  version: "1.0.0",
});

const API_BASE = "https://api.screenapp.io";
const TOKEN = process.env.SCREENAPP_API_TOKEN;

server.tool(
  "search_recordings",
  { query: z.string() },
  async ({ query }) => {
    const res = await fetch(
      `${API_BASE}/v2/files?searchQuery=${encodeURIComponent(query)}`,
      { headers: { Authorization: `Bearer ${TOKEN}` } }
    );
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

server.tool(
  "get_transcript",
  { fileId: z.string() },
  async ({ fileId }) => {
    const res = await fetch(`${API_BASE}/v2/files/${fileId}`, {
      headers: { Authorization: `Bearer ${TOKEN}` },
    });
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data.transcript, null, 2) }],
    };
  }
);

server.tool(
  "analyze_recording",
  { fileId: z.string(), question: z.string() },
  async ({ fileId, question }) => {
    const res = await fetch(
      `${API_BASE}/v2/files/${fileId}/ask/multimodal`,
      {
        method: "POST",
        headers: {
          Authorization: `Bearer ${TOKEN}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ promptText: question }),
      }
    );
    const data = await res.json();
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

Luego regístralo en la configuración de OpenClaw o úsalo de forma independiente con Claude Desktop.

Casos de uso

Seguimiento de reuniones: Pregúntale a tu agente “¿Qué dijo Sarah sobre el cronograma en la llamada de ayer?” y extraerá la transcripción, encontrará la sección relevante y te dará la respuesta.

Resúmenes semanales: “Resume todas mis reuniones de esta semana” activa una búsqueda en tus grabaciones y genera un informe consolidado.

Seguimiento de elementos de acción: “¿Qué elementos de acción pendientes tengo de las reuniones de este mes?” busca en tus transcripciones compromisos y plazos.

Reutilización de contenido: “Convierte la grabación de mi último seminario web en un esquema de publicación de blog” utiliza el endpoint de análisis de IA para generar contenido estructurado a partir de tu video.

Funciones relacionadas de ScreenApp

• Resumidor de reuniones con IA: Genera resúmenes de cualquier grabación
• Software de Transcripción: Conversión automática de voz a texto con etiquetas de orador
• Tomador de notas con IA: Notas estructuradas de tus conversaciones

Preguntas frecuentes

¿Qué es un servidor MCP?

Un servidor MCP (Model Context Protocol) es un programa local que expone datos y herramientas a modelos de IA. Permite a asistentes de IA como Claude o agentes de OpenClaw acceder a servicios externos sin copiar y pegar datos manualmente.

¿Necesito un plan pago de ScreenApp para el acceso a la API?

El acceso a la API está disponible en los planes pagos de ScreenApp. Verifica la configuración de tu cuenta para ver si la sección de la API está disponible. Las cuentas gratuitas tienen acceso limitado a la API.

¿Puedo usar esto con Claude Desktop en lugar de OpenClaw?

Sí. El enfoque del servidor MCP funciona con cualquier cliente compatible con MCP. Claude Desktop, ChatGPT Desktop y Cursor son compatibles con los servidores MCP. OpenClaw añade el beneficio de acceder a él desde aplicaciones de mensajería móvil.

¿Se envían mis datos de grabación a los servidores de OpenClaw?

No. OpenClaw es autoalojado y se ejecuta completamente en tu máquina. Tu token de API de ScreenApp y los datos de grabación permanecen locales. El modelo de IA procesa los datos, pero OpenClaw en sí mismo no almacena ni reenvía tu contenido.

¿Cómo encuentra el agente la habilidad correcta?

OpenClaw escanea los campos name y description de cada habilidad instalada al inicio de cada sesión. Cuando preguntas algo como “encuentra mi última reunión”, el agente lo compara con las descripciones de las habilidades y carga el SKILL.md completo de la habilidad que mejor se adapte. Esta es la razón por la que la descripción debe incluir frases de activación concretas como “transcripción”, “notas de reunión” y “grabaciones” en lugar de un lenguaje vago como “ayuda con las grabaciones”.

¿Cuántas grabaciones puede manejar el servidor MCP?

La API de ScreenApp maneja la paginación, por lo que puedes trabajar con bibliotecas de cualquier tamaño. Para obtener mejores resultados, utiliza consultas de búsqueda para acotar los resultados en lugar de listar todo a la vez.