How to Connect ScreenApp to OpenClaw AI Agents via MCP Server
On this page
Your AI agent should be able to pull up last Tuesday’s meeting notes without you digging through folders. With ScreenApp’s API and the Model Context Protocol (MCP), you can give OpenClaw agents direct access to your recordings, transcripts, and AI summaries.
This guide walks through building a ScreenApp MCP server skill so your OpenClaw agent can search recordings, fetch transcripts, and run AI analysis on your content, all from a chat message on Telegram, WhatsApp, or Discord.
If you are new to MCP servers for meeting recordings, check out our comparison of the best MCP servers for meetings to see how ScreenApp stacks up.
What is OpenClaw?
OpenClaw is a self-hosted gateway that connects messaging apps (WhatsApp, Telegram, Discord, iMessage) to AI coding agents. You run a single process on your machine and it bridges your chat apps to an always-available AI assistant.
The key idea: you message your agent from your phone, and it can use tools, read files, browse the web, and now, access your ScreenApp recordings.
OpenClaw uses skills to teach agents how to use tools. Each skill is a folder with a SKILL.md file that describes available commands. Skills can also wrap MCP servers, which is how we will connect ScreenApp.
OpenClaw discovers skills through a three-tier system. On session start, the agent scans the name and description from every skill’s frontmatter. When a skill looks relevant, it loads the full SKILL.md. This means your description field is the single most important factor for whether the agent picks your skill. Write it like you are telling a coworker what the skill does and when to use it.
What is MCP?
Model Context Protocol is a standard created by Anthropic that lets AI models access external data sources. Think of it like USB-C for AI apps. Instead of copy-pasting transcripts into ChatGPT, an MCP server lets the AI pull what it needs directly.
MCP servers run locally and expose tools (actions the AI can take) and resources (data the AI can read). For ScreenApp, the tools would include things like “search recordings,” “get transcript,” and “ask a question about a video.”
MCP works with Claude Desktop, ChatGPT Desktop, Cursor, and through OpenClaw, any messaging app.
ScreenApp API overview
ScreenApp provides a REST API that covers everything you need for an MCP integration. The main endpoints:
- List recordings - Browse your recording library with filters
- Get recording with transcript - Fetch a recording and its full transcript, with timestamps and speaker labels
- AI analysis - Ask questions about a recording using the multimodal analysis endpoint (
/v2/files/{fileId}/ask/multimodal) - Search - Find recordings by keyword across all your content
- Upload - Send new audio/video files for processing
Authentication uses Bearer tokens. You generate an API token from your ScreenApp account settings.
For the full reference, see the ScreenApp API documentation.
Setup steps
1. Obtén tu token de API de ScreenApp
Inicia sesión en ScreenApp, ve a Ajustes > 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 # Requerido: frontmatter + instrucciones del agente
├── claw.json # Para publicación en ClawHub (opcional)
└── references/
└── api-endpoints.md # Documentos detallados de endpoints cargados bajo demanda
3. Escribe el SKILL.md
El campo description es lo que determina si el agente elige 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 la asocie 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, obtén notas de reuniones y elementos de acción, transcribe audio y video, haz preguntas de IA sobre contenido grabado. Úsalo cuando el usuario mencione transcripción, notas de reuniones, grabaciones, audio a texto, voz a texto, búsqueda de reuniones, o quiera 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 de 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.
Encabezados: Authorization: Bearer $SCREENAPP_API_TOKEN
URL base: https://api.screenapp.io
## Acciones disponibles
#
## Buscar grabaciones por palabra clave
GET /v2/files?searchQuery={query}
Use 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, incluida la transcripción con marca de tiempo y etiquetas de orador. Use esto para recuperar notas de reuniones, leer lo que se dijo o obtener el texto completo de una llamada.
#
## Hacer una pregunta a la IA sobre una grabación
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "su pregunta aquí" }
Analiza tanto el contenido de la transcripción como el del video. Use esto para resumir reuniones, extraer elementos de acción o responder preguntas específicas sobre lo que sucedió en una grabación.
#
## Listar grabaciones recientes
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
Use esto cuando el usuario pregunte sobre sus últimas reuniones o grabaciones recientes.
Opcionalmente, cree 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 API
Agregue su token de ScreenApp al entorno de OpenClaw. Edite ~/.openclaw/openclaw.json:
{
"env": {
"SCREENAPP_API_TOKEN": "su-token-aquí"
}
}
O expórtelo en su perfil de shell si lo prefiere.
5. Reiniciar OpenClaw
openclaw gateway restart
El agente detectará la nueva habilidad en la próxima sesión. Puedes verificar que se cargó preguntando 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 de la reunión diaria de ayer?”
El agente usará la habilidad de ScreenApp para obtener los datos y responder tu pregunta.
Publicación 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 usa búsqueda vectorial, así que las consultas en lenguaje natural como “buscar transcripciones de reuniones” o “transcribir grabaciones de audio” harán que tu habilidad aparezca siempre y cuando 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 contenido grabado a través de la API de ScreenApp.",
"author": "tu-nombre-de-usuario-clawhub",
"license": "MIT",
"permissions": ["network"],
"entry": "SKILL.md",
"tags": ["transcripción", "reuniones", "grabaciones", "toma de notas", "productividad", "voz-a-texto"],
"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, así que no hay ningún paso adicional.
Construyendo un servidor MCP (avanzado)
Si quieres 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 da compatibilidad con Claude Desktop, Cursor y cualquier otro cliente MCP, no solo 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: Pregunta 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.
Reaprovechamiento 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 (Protocolo de Contexto de Modelo) es un programa local que expone datos y herramientas a los modelos de IA. Permite a los asistentes de IA, como Claude o los agentes de OpenClaw, acceder a servicios externos sin copiar y pegar datos manualmente.
¿Necesito un plan de pago de ScreenApp para acceder a la API?
El acceso a la API está disponible en los planes de pago de ScreenApp. Consulta 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 los datos de mi 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 ajuste. Por eso la descripción debe incluir frases desencadenantes 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 los mejores resultados, utiliza consultas de búsqueda para acotar los resultados en lugar de listar todo a la vez.
