Hoe ScreenApp te verbinden met OpenClaw AI-agents via MCP-server
On this page
Uw AI-agent zou de notulen van afgelopen dinsdag moeten kunnen oproepen 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 leidt u door het bouwen van een ScreenApp MCP-servervaardigheid, zodat uw OpenClaw-agent opnames kan doorzoeken, transcripten kan ophalen en AI-analyse kan uitvoeren op uw inhoud, alles vanuit een chatbericht op Telegram, WhatsApp of Discord.
Als u nieuw bent met MCP-servers voor vergaderopnames, bekijk dan onze vergelijking van de beste MCP-servers voor vergaderingen om te zien hoe ScreenApp presteert.
Wat is OpenClaw?
OpenClaw is een zelfgehoste gateway die berichtenapps (WhatsApp, Telegram, Discord, iMessage) verbindt met AI-codeeragenten. U draait één proces op uw machine en dit verbindt uw chat-apps met een altijd beschikbare AI-assistent.
Het kernidee: u stuurt uw agent een bericht vanaf uw telefoon, en deze kan tools gebruiken, bestanden lezen, op het web browsen, en nu ook, 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 de beschikbare commando’s beschrijft. Vaardigheden kunnen ook MCP-servers wrappen, en zo zullen we ScreenApp verbinden.
OpenClaw ontdekt vaardigheden via een drietraps systeem. Bij het starten van een sessie scant de agent de name en description uit de frontmatter van elke vaardigheid. Wanneer een vaardigheid relevant lijkt, laadt deze de volledige SKILL.md. Dit betekent dat uw beschrijvingsveld de belangrijkste factor is voor de vraag of de agent uw vaardigheid kiest. Schrijf het alsof u een collega vertelt wat de vaardigheid doet en wanneer u deze moet 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 zaken 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.
Overzicht van de ScreenApp API
ScreenApp biedt een REST API die alles omvat wat u nodig heeft voor een MCP-integratie. De belangrijkste eindpunten:
- Opnames weergeven - Blader door uw opnamebibliotheek met filters
- Opname met transcript ophalen - 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-eindpunt (
/v2/files/{fileId}/ask/multimodal) - Zoeken - Vind opnames op trefwoord in al uw inhoud
- Uploaden - Stuur nieuwe audio-/videobestanden ter verwerking
Authenticatie maakt gebruik van 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 het ergens veilig. Je hebt het nodig in de volgende stap.
2. Maak de vaardigheidsmap aan
OpenClaw-vaardigheden bevinden zich in ~/.openclaw/skills/ (gedeeld over agents) of in de /skills/ map van je werkruimte (per-agent). De naam van de vaardigheidsmap moet overeenkomen met het name-veld in de frontmatter van je SKILL.md. Maak de volledige structuur aan:
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 op aanvraag geladen
3. Schrijf de SKILL.md
Het description-veld bepaalt of de agent deze vaardigheid kiest. OpenClaw scant de name en description van elke geïnstalleerde vaardigheid aan het begin van elke sessie. Voeg triggerzinnen en trefwoordvarianten toe zodat de agent deze koppelt aan verzoeken over transcripten, vergaderingen, opnames en notities.
Maak ~/.openclaw/skills/screenapp/SKILL.md aan:
---
name: screenapp
description: Zoek in vergaderopnames en transcripten, verkrijg vergadernotities en actiepunten, transcribeer audio en video, stel AI-vragen over opgenomen inhoud. Gebruik wanneer de gebruiker transcriptie, vergadernotities, opnames, audio-naar-tekst, spraak-naar-tekst, vergaderingszoekopdrachten vermeldt, of opgenomen vergaderingen en oproepen wil vinden of analyseren.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---
# ScreenApp-integratie
Toegang tot de ScreenApp-opnames, transcripten en AI-analyse van de gebruiker.
## Authenticatie
Alle verzoeken vereisen de omgevingsvariabele SCREENAPP_API_TOKEN.
Headers: Authorization: Bearer $SCREENAPP_API_TOKEN
Basis-URL: https://api.screenapp.io
## Beschikbare acties
#
## Zoek opnames op trefwoord
GET /v2/files?searchQuery={query}
Gebruik dit wanneer de gebruiker een specifieke vergadering, opname of onderwerp wil vinden.
#
## Haal een opname op met het transcript
GET /v2/files/{fileId}
Retourneert het volledige opnameobject inclusief het getimede transcript met sprekerlabels. Gebruik dit om notulen 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.
#
## Lijst recente opnames
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
Gebruik dit wanneer de gebruiker vraagt naar hun laatste vergaderingen of recente opnames.
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 skill-scan 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": "uw-token-hier"
}
}
Of exporteer het in uw shell-profiel als u dat verkiest.
5. Herstart OpenClaw
openclaw gateway restart
De agent zal de nieuwe vaardigheid oppikken tijdens de volgende sessie. Je kunt controleren of deze is geladen door je agent te vragen: “Welke vaardigheden heb je?“
6. Test het
Stuur een bericht naar je OpenClaw agent op Telegram of WhatsApp:
- “Zoek in mijn ScreenApp-opnames naar de productroadmapdiscussie”
- “Haal het transcript van mijn laatste vergadering op”
- “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.
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 maakt gebruik van vectorzoekopdrachten, dus natuurlijke taalvragen zoals “zoek vergadertranscripten” of “transcribeer audio-opnamen” zullen je vaardigheid naar boven brengen, zolang de beschrijving die termen maar bevat.
Voeg een claw.json-manifest toe aan je vaardighedenmap:
{
"name": "screenapp",
"version": "1.0.0",
"description": "Search meeting recordings, get transcripts, extract action items, and ask AI questions about recorded content via the ScreenApp API.",
"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"
}
Publiceer vervolgens:
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 vermeldt voor OpenClaw, Claude Code, Cursor en andere AI-coderingstools. Moltbook indexeert ClawHub automatisch, dus er is geen extra stap nodig.
Een MCP-server bouwen (geavanceerd)
Als je een volwaardige MCP-server wilt in plaats van een op vaardigheden gebaseerde 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.
Gebruiksscenario’s
Vergaderingsfollow-ups: Vraag je agent “Wat zei Sarah over de tijdlijn in het gesprek van gisteren?” en het 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 door al je opnames en genereert een geconsolideerd rapport.
Actiepuntentracking: “Welke openstaande actiepunten heb ik van vergaderingen deze maand?” doorzoekt je transcripten op toezeggingen en deadlines.
Content hergebruik: “Verander mijn laatste webinar-opname in een blogpost-outline” gebruikt het AI-analyse-eindpunt om gestructureerde content uit je video te genereren.
Gerelateerde ScreenApp functies
- AI Meeting Summarizer: Genereer samenvattingen van elke opname
- Transcription Software: Automatische spraak-naar-tekst met sprekerslabels
- AI Note Taker: 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 te plakken.
Heb ik een betaald ScreenApp-abonnement nodig voor API-toegang?
API-toegang is beschikbaar op 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 via mobiele berichtenapps.
Worden mijn opnamegegevens naar de servers van OpenClaw gestuurd?
Nee. OpenClaw is zelfgehost 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 als “vind mijn laatste vergadering”, matcht de agent dat met vaardigheidsbeschrijvingen en laadt het volledige SKILL.md voor de vaardigheid die het beste past. Dit is waarom de beschrijving concrete triggerzinnen moet bevatten zoals “transcriptie,” “vergaderingsnotities,” en “opnames” in plaats van vage taal zoals “helpt met opnames.”
Hoeveel opnames kan de MCP-server verwerken?
De ScreenApp API ondersteunt paginering, zodat u kunt werken met bibliotheken van elke omvang. Gebruik voor de beste resultaten zoekvragen om resultaten te verfijnen in plaats van alles tegelijk weer te geven.
