Hoe ScreenApp te verbinden met OpenClaw AI-agents via MCP-server
On this page
Uw AI-agent zou in staat moeten zijn om de notulen van de vergadering van afgelopen dinsdag op te roepen zonder dat u door mappen hoeft te graven. Met de API van ScreenApp en het Model Context Protocol (MCP), kunt u OpenClaw-agenten directe toegang geven tot uw opnames, transcripten en AI-samenvattingen.
Deze gids beschrijft het bouwen van een ScreenApp MCP-servervaardigheid zodat uw OpenClaw-agent opnames kan zoeken, transcripten kan ophalen en AI-analyse kan uitvoeren op uw inhoud, allemaal vanuit een chatbericht op Telegram, WhatsApp of Discord.
Als u nieuw bent met MCP-servers voor vergaderingsopnames, bekijk dan onze vergelijking van de beste MCP-servers voor vergaderingen om te zien hoe ScreenApp presteert.
Wat is OpenClaw?
OpenClaw is een zelf gehoste gateway die berichtenapps (WhatsApp, Telegram, Discord, iMessage) verbindt met AI-codeeragenten. U draait één enkel proces op uw machine en het overbrugt uw chat-apps naar een altijd beschikbare AI-assistent.
Het kernidee: u stuurt een bericht naar uw agent vanaf uw telefoon, en deze kan tools gebruiken, bestanden lezen, op het web browsen, en nu, toegang krijgen tot uw ScreenApp-opnames.
OpenClaw gebruikt vaardigheden om agenten te leren hoe ze tools moeten gebruiken. Elke vaardigheid is een map met een SKILL.md-bestand dat beschikbare commando’s beschrijft. Vaardigheden kunnen ook MCP-servers omvatten, en zo zullen we ScreenApp verbinden.
OpenClaw ontdekt vaardigheden via een drielaags systeem. Bij het starten van een sessie scant de agent de naam en beschrijving uit de frontmatter van elke vaardigheid. Wanneer een vaardigheid relevant lijkt, laadt deze de volledige SKILL.md. Dit betekent dat uw beschrijvingsveld de enige belangrijkste factor is of de agent uw vaardigheid kiest. Schrijf het alsof u een collega vertelt wat de vaardigheid doet en wanneer deze te gebruiken.
Wat is MCP?
Model Context Protocol is een standaard gecreëerd door Anthropic die AI-modellen toegang geeft tot externe gegevensbronnen. Zie het als USB-C voor AI-apps. In plaats van transcripten te kopiëren en plakken in ChatGPT, laat een MCP-server de AI direct ophalen wat het nodig heeft.
MCP-servers draaien lokaal en stellen tools (acties die de AI kan uitvoeren) en bronnen (gegevens die de AI kan lezen) beschikbaar. Voor ScreenApp zouden de tools dingen omvatten zoals “opnames zoeken”, “transcript ophalen” en “een vraag stellen over een video”.
MCP werkt met Claude Desktop, ChatGPT Desktop, Cursor, en via OpenClaw, elke berichtenapp.
ScreenApp API overzicht
ScreenApp biedt een REST API die alles omvat wat u nodig heeft voor een MCP-integratie. De belangrijkste endpoints:
- Lijst opnames - Blader door uw opnamebibliotheek met filters
- Opname ophalen met transcript - Haal een opname en het volledige transcript op, met tijdstempels en sprekerslabels
- AI-analyse - Stel vragen over een opname met behulp van het multimodale analyse-endpoint (
/v2/files/{fileId}/ask/multimodal) - Zoeken - Vind opnames op trefwoord in al uw inhoud
- Uploaden - Stuur nieuwe audio-/videobestanden voor verwerking
Authenticatie gebruikt Bearer-tokens. U genereert een API-token vanuit uw ScreenApp-accountinstellingen.
Voor de volledige referentie, zie de ScreenApp API-documentatie.
Installatiestappen
1. Haal je ScreenApp API-token op
Log in bij ScreenApp, ga naar Instellingen > API, en genereer een nieuwe token. Kopieer deze ergens veilig. Je hebt deze nodig in de volgende stap.
2. Maak de vaardigheidsmap aan
OpenClaw-vaardigheden bevinden zich in ~/.openclaw/skills/ (gedeeld over agents) of in de map /skills/ van je werkruimte (per agent). De naam van de vaardigheidsmap moet overeenkomen met het name veld in de frontmatter van je SKILL.md. Creëer de volledige structuur:
mkdir -p ~/.openclaw/skills/screenapp/references
De uiteindelijke mapindeling:
screenapp/
├── SKILL.md # Vereist: frontmatter + agentinstructies
├── claw.json # Voor ClawHub-publicatie (optioneel)
└── references/
└── api-endpoints.md # Gedetailleerde eindpuntdocumentatie die op aanvraag wordt geladen
3. Schrijf de SKILL.md
Het description veld bepaalt of de agent deze vaardigheid kiest. OpenClaw scant van elke geïnstalleerde vaardigheid de name en description aan het begin van elke sessie. Voeg triggerzinnen en trefwoordvarianten toe, zodat de agent deze kan matchen met verzoeken over transcripties, vergaderingen, opnames en notulen.
Maak ~/.openclaw/skills/screenapp/SKILL.md:
---
name: screenapp
description: Zoek vergaderingsopnames en transcripties, haal vergaderingsnotulen en actiepunten op, transcribeer audio en video, stel AI-vragen over opgenomen inhoud. Gebruik wanneer de gebruiker transcriptie, vergaderingsnotulen, opnames, audio-naar-tekst, spraak-naar-tekst, vergaderingszoekopdracht noemt, of opgenomen vergaderingen en gesprekken wil vinden of analyseren.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---
# ScreenApp Integratie
Krijg toegang tot de ScreenApp-opnames, transcripties en AI-analyse van de gebruiker.
## Authenticatie
Alle verzoeken vereisen de omgevingsvariabele SCREENAPP_API_TOKEN.
Headers: Authorization: Bearer $SCREENAPP_API_TOKEN
Base URL: https://api.screenapp.io
## Beschikbare acties
#
## Zoek opnamen op trefwoord
GET /v2/files?searchQuery={query}
Gebruik dit wanneer de gebruiker een specifieke vergadering, opname of onderwerp wil vinden.
#
## Ontvang een opname met transcript
GET /v2/files/{fileId}
Geeft het volledige opnameobject terug, inclusief het getimede transcript met sprekerslabels. Gebruik dit om notulen van vergaderingen op te halen, terug te lezen wat er gezegd is, of de volledige tekst van een gesprek te krijgen.
#
## Stel AI een vraag over een opname
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "uw vraag hier" }
Analyseert zowel het transcript als de video-inhoud. Gebruik dit voor het samenvatten van vergaderingen, het extraheren van actiepunten of het beantwoorden van specifieke vragen over wat er in een opname is gebeurd.
#
## Toon recente opnamen
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
Gebruik dit wanneer de gebruiker vraagt naar hun laatste vergaderingen of recente opnamen.
Maak optioneel references/api-endpoints.md aan met meer gedetailleerde parameterdocumentatie. De agent laadt referentiebestanden alleen wanneer deze ze nodig heeft, waardoor de initiële skillscan licht blijft.
4. Stel de API-token in
Voeg uw ScreenApp-token toe aan de omgeving van OpenClaw. Bewerk ~/.openclaw/openclaw.json:
{
"env": {
"SCREENAPP_API_TOKEN": "your-token-here"
}
}
Of exporteer deze in uw shell-profiel indien u dat verkiest.
5. OpenClaw herstarten
openclaw gateway restart
De agent zal de nieuwe vaardigheid bij de volgende sessie oppikken. Je kunt controleren of deze is geladen door je agent te vragen: “Welke vaardigheden heb je?”
===SECTION 2===
6. Testen
Stuur een bericht naar je OpenClaw agent op Telegram of WhatsApp:
- “Zoek in mijn ScreenApp-opnames naar de discussie over de productroadmap”
- “Haal het transcript op van mijn laatste vergadering”
- “Welke actiepunten kwamen uit de stand-up van gisteren?”
De agent zal de ScreenApp vaardigheid gebruiken om de gegevens op te halen en je vraag te beantwoorden.
===SECTION 3===
Publiceren naar ClawHub
Als je wilt dat andere OpenClaw-gebruikers je ScreenApp-vaardigheid vinden en installeren, publiceer deze dan naar ClawHub, OpenClaw’s officiële vaardighedenregister. ClawHub gebruikt vectorzoekopdrachten, dus natuurlijke taalvragen zoals “zoek vergadertranscripten” of “transcribeer audio-opnames” zullen je vaardigheid naar boven halen, zolang de beschrijving die termen dekt.
Voeg een claw.json manifest toe aan je vaardighedenmap:
{
"name": "screenapp",
"version": "1.0.0",
"description": "Zoek vergaderopnames, haal transcripten op, extraheer actiepunten en stel AI-vragen over opgenomen inhoud via de ScreenApp API.",
"author": "jouw-clawhub-gebruikersnaam",
"license": "MIT",
"permissions": ["network"],
"entry": "SKILL.md",
"tags": ["transcriptie", "vergaderingen", "opnames", "notities maken", "productiviteit", "spraak-naar-tekst"],
"models": ["claude-*", "gpt-*", "gemini-*"],
"minOpenClawVersion": "0.8.0"
}
Dan publiceren:
clawhub publish ~/.openclaw/skills/screenapp
Eenmaal gepubliceerd, kan iedereen het installeren met:
clawhub install screenapp
Je vaardigheid zal ook verschijnen op Moltbook, een cross-platform index die vaardigheden voor OpenClaw, Claude Code, Cursor en andere AI-coding tools vermeldt. Moltbook indexeert ClawHub automatisch, dus er is geen extra stap.
===SECTION 4===
Een MCP-server bouwen (geavanceerd)
Als je een volwaardige MCP-server wilt in plaats van een vaardigheidsgebaseerde aanpak, kun je de ScreenApp API wrappen in een Node.js MCP-server. Dit geeft je compatibiliteit met Claude Desktop, Cursor en elke andere MCP-client, niet alleen 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) }],
};
}
);
Registreer het vervolgens in de configuratie van OpenClaw of gebruik het zelfstandig met Claude Desktop.
===SECTION 5===
Gebruiksscenario’s
Vergaderfollow-ups: Vraag je agent “Wat zei Sarah over de tijdlijn in het gesprek van gisteren?” en deze haalt het transcript op, vindt de relevante sectie en geeft je het antwoord.
Wekelijkse samenvattingen: “Vat al mijn vergaderingen van deze week samen” activeert een zoekopdracht in je opnames en genereert een geconsolideerd rapport.
Actiepunten bijhouden: “Welke openstaande actiepunten heb ik van vergaderingen deze maand?” zoekt in je transcripten naar toezeggingen en deadlines.
Content hergebruiken: “Verander mijn laatste webinar-opname in een blogpost-outline” gebruikt het AI-analyse-eindpunt om gestructureerde inhoud uit je video te genereren.
Gerelateerde ScreenApp functies
- AI Vergadering Samenvatter: Genereer samenvattingen van elke opname
- Transcriptie Software: Automatische spraak-naar-tekst met sprekerlabels
- AI Notulist: Gestructureerde notities van uw gesprekken
Veelgestelde vragen
Wat is een MCP-server?
Een MCP (Model Context Protocol) server is een lokaal programma dat gegevens en tools beschikbaar stelt aan AI-modellen. Het stelt AI-assistenten zoals Claude of OpenClaw-agenten in staat om toegang te krijgen tot externe services zonder handmatig gegevens te kopiëren en plakken.
Heb ik een betaald ScreenApp-abonnement nodig voor API-toegang?
API-toegang is beschikbaar bij betaalde ScreenApp-abonnementen. Controleer uw accountinstellingen om te zien of de API-sectie beschikbaar is. Gratis accounts hebben beperkte API-toegang.
Kan ik dit gebruiken met Claude Desktop in plaats van OpenClaw?
Ja. De MCP-serveraanpak werkt met elke MCP-compatibele client. Claude Desktop, ChatGPT Desktop en Cursor ondersteunen allemaal MCP-servers. OpenClaw biedt het voordeel van toegang vanaf mobiele berichtenapps.
Worden mijn opnamegegevens naar de servers van OpenClaw verzonden?
Nee. OpenClaw is zelf gehost en draait volledig op uw machine. Uw ScreenApp API-token en opnamegegevens blijven lokaal. Het AI-model verwerkt de gegevens, maar OpenClaw zelf slaat uw inhoud niet op of stuurt deze niet door.
Hoe vindt de agent de juiste vaardigheid?
OpenClaw scant de name en description velden van elke geïnstalleerde vaardigheid aan het begin van elke sessie. Wanneer u iets vraagt zoals “vind mijn laatste vergadering”, matcht de agent dat met vaardigheidsbeschrijvingen en laadt de volledige SKILL.md van de vaardigheid die het beste past. Daarom moet de beschrijving concrete triggerzinnen bevatten zoals “transcriptie”, “vergadernotities” en “opnames” in plaats van vage taal zoals “helpt met opnames”.
Hoeveel opnames kan de MCP-server verwerken?
De ScreenApp API verwerkt paginering, zodat u kunt werken met bibliotheken van elke omvang. Voor de beste resultaten gebruikt u zoekopdrachten om resultaten te verfijnen in plaats van alles tegelijk weer te geven.
