Como Conectar ScreenApp aos Agentes de IA OpenClaw via Servidor MCP
On this page
Seu agente de IA deve ser capaz de recuperar as notas da reunião da última terça-feira sem que você precise procurar em pastas. Com a API do ScreenApp e o Model Context Protocol (MCP), você pode dar aos agentes OpenClaw acesso direto às suas gravações, transcrições e resumos de IA.
Este guia detalha a construção de uma skill de servidor MCP do ScreenApp para que seu agente OpenClaw possa pesquisar gravações, buscar transcrições e executar análises de IA em seu conteúdo, tudo a partir de uma mensagem de chat no Telegram, WhatsApp ou Discord.
Se você é novo em servidores MCP para gravações de reuniões, confira nossa comparação dos melhores servidores MCP para reuniões para ver como o ScreenApp se destaca.
O que é OpenClaw?
OpenClaw é um gateway auto-hospedado que conecta aplicativos de mensagens (WhatsApp, Telegram, Discord, iMessage) a agentes de codificação de IA. Você executa um único processo em sua máquina e ele faz a ponte entre seus aplicativos de bate-papo e um assistente de IA sempre disponível.
A ideia principal: você envia uma mensagem ao seu agente do seu telefone, e ele pode usar ferramentas, ler arquivos, navegar na web e, agora, acessar suas gravações do ScreenApp.
OpenClaw usa skills para ensinar os agentes a usar ferramentas. Cada skill é uma pasta com um arquivo SKILL.md que descreve os comandos disponíveis. As skills também podem envolver servidores MCP, que é como conectaremos o ScreenApp.
OpenClaw descobre skills através de um sistema de três níveis. No início da sessão, o agente escaneia o name e a description do frontmatter de cada skill. Quando uma skill parece relevante, ele carrega o SKILL.md completo. Isso significa que seu campo de descrição é o fator mais importante para que o agente escolha sua skill. Escreva-o como se estivesse dizendo a um colega de trabalho o que a skill faz e quando usá-la.
O que é MCP?
Model Context Protocol é um padrão criado pela Anthropic que permite aos modelos de IA acessar fontes de dados externas. Pense nisso como USB-C para aplicativos de IA. Em vez de copiar e colar transcrições no ChatGPT, um servidor MCP permite que a IA puxe o que precisa diretamente.
Os servidores MCP são executados localmente e expõem ferramentas (ações que a IA pode realizar) e recursos (dados que a IA pode ler). Para o ScreenApp, as ferramentas incluiriam coisas como “pesquisar gravações”, “obter transcrição” e “fazer uma pergunta sobre um vídeo”.
O MCP funciona com Claude Desktop, ChatGPT Desktop, Cursor e, através do OpenClaw, qualquer aplicativo de mensagens.
Visão geral da API do ScreenApp
O ScreenApp oferece uma API REST que cobre tudo o que você precisa para uma integração MCP. Os principais endpoints:
- Listar gravações - Navegue pela sua biblioteca de gravações com filtros
- Obter gravação com transcrição - Busque uma gravação e sua transcrição completa, com timestamps e rótulos de orador
- Análise de IA - Faça perguntas sobre uma gravação usando o endpoint de análise multimodal (
/v2/files/{fileId}/ask/multimodal) - Pesquisar - Encontre gravações por palavra-chave em todo o seu conteúdo
- Upload - Envie novos arquivos de áudio/vídeo para processamento
A autenticação usa tokens Bearer. Você gera um token de API nas configurações da sua conta ScreenApp.
Para a referência completa, consulte a documentação da API do ScreenApp.
Passos de configuração
1. Obtenha seu token de API ScreenApp
Faça login no ScreenApp, vá para Configurações > API e gere um novo token. Copie-o em um local seguro. Você precisará dele na próxima etapa.
2. Crie a pasta da skill
As skills do OpenClaw residem em ~/.openclaw/skills/ (compartilhadas entre agentes) ou na pasta /skills/ do seu espaço de trabalho (por agente). O nome da pasta da skill deve corresponder ao campo name no seu frontmatter SKILL.md. Crie a estrutura completa:
mkdir -p ~/.openclaw/skills/screenapp/references
O layout final da pasta:
screenapp/
├── SKILL.md # Obrigatório: frontmatter + instruções do agente
├── claw.json # Para publicação no ClawHub (opcional)
└── references/
└── api-endpoints.md # Documentação detalhada dos endpoints carregada sob demanda
3. Escreva o SKILL.md
O campo description é o que determina se o agente escolhe esta skill. O OpenClaw verifica o name e a description de cada skill instalada no início de cada sessão. Inclua frases de gatilho e variantes de palavras-chave para que o agente as associe a solicitações sobre transcrições, reuniões, gravações e anotações.
Crie ~/.openclaw/skills/screenapp/SKILL.md:
---
name: screenapp
description: Pesquise gravações e transcrições de reuniões, obtenha anotações e itens de ação de reuniões, transcreva áudio e vídeo, faça perguntas de IA sobre conteúdo gravado. Use quando o usuário mencionar transcrição, anotações de reunião, gravações, áudio para texto, fala para texto, pesquisa de reunião ou desejar encontrar ou analisar reuniões e chamadas gravadas.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---
# Integração ScreenApp
Acesse as gravações, transcrições e análises de IA do ScreenApp do usuário.
## Autenticação
Todas as requisições exigem a variável de ambiente SCREENAPP_API_TOKEN.
Cabeçalhos: Authorization: Bearer $SCREENAPP_API_TOKEN
URL Base: https://api.screenapp.io
## Ações disponíveis
#
## Buscar gravações por palavra-chave
GET /v2/files?searchQuery={query}
Use isso quando o usuário quiser encontrar uma reunião, gravação ou tópico específico.
#
## Obter uma gravação com sua transcrição
GET /v2/files/{fileId}
Retorna o objeto de gravação completo, incluindo a transcrição com carimbo de data/hora e identificação de oradores. Use isso para recuperar notas de reunião, reler o que foi dito ou obter o texto completo de uma chamada.
#
## Perguntar à IA sobre uma gravação
POST /v2/files/{fileId}/ask/multimodal
Body: { "promptText": "sua pergunta aqui" }
Analisa tanto o conteúdo da transcrição quanto do vídeo. Use isso para resumir reuniões, extrair itens de ação ou responder a perguntas específicas sobre o que aconteceu em uma gravação.
#
## Listar gravações recentes
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
Use isso quando o usuário perguntar sobre suas últimas reuniões ou gravações recentes.
Opcionalmente, crie references/api-endpoints.md com documentação de parâmetros mais detalhada. O agente carrega arquivos de referência apenas quando precisa deles, mantendo a varredura inicial da skill leve.
4. Definir o token da API
Adicione seu token ScreenApp ao ambiente do OpenClaw. Edite ~/.openclaw/openclaw.json:
{
"env": {
"SCREENAPP_API_TOKEN": "your-token-here"
}
}
Ou exporte-o no seu perfil de shell, se preferir.
5. Reiniciar OpenClaw
openclaw gateway restart
O agente irá adquirir a nova habilidade na próxima sessão. Você pode verificar se foi carregada perguntando ao seu agente: “Que habilidades tens?“
6. Testar
Envie uma mensagem para o seu agente OpenClaw no Telegram ou WhatsApp:
- “Procurar nas minhas gravações do ScreenApp pela discussão do roteiro do produto”
- “Obter a transcrição da minha última reunião”
- “Que itens de ação surgiram na reunião diária de ontem?”
O agente usará a habilidade ScreenApp para buscar os dados e responder à sua pergunta.
Publicando para o ClawHub
Se você quer que outros usuários do OpenClaw encontrem e instalem sua habilidade ScreenApp, publique-a no ClawHub, o registro oficial de habilidades do OpenClaw. O ClawHub usa busca vetorial, então consultas em linguagem natural como “pesquisar transcrições de reuniões” ou “transcrever gravações de áudio” farão sua habilidade aparecer, desde que a descrição cubra esses termos.
Adicione um manifesto claw.json à sua pasta de habilidade:
{
"name": "screenapp",
"version": "1.0.0",
"description": "Pesquise gravações de reuniões, obtenha transcrições, extraia itens de ação e faça perguntas à IA sobre conteúdo gravado via API ScreenApp.",
"author": "seu-nome-de-usuário-clawhub",
"license": "MIT",
"permissions": ["network"],
"entry": "SKILL.md",
"tags": ["transcrição", "reuniões", "gravações", "anotações", "produtividade", "fala-para-texto"],
"models": ["claude-*", "gpt-*", "gemini-*"],
"minOpenClawVersion": "0.8.0"
}
Então publique:
clawhub publish ~/.openclaw/skills/screenapp
Uma vez publicada, qualquer um pode instalá-la com:
clawhub install screenapp
Sua habilidade também aparecerá no Moltbook, um índice multiplataforma que lista habilidades para OpenClaw, Claude Code, Cursor e outras ferramentas de codificação de IA. O Moltbook indexa o ClawHub automaticamente, então não há etapa extra.
Construindo um servidor MCP (avançado)
Se você deseja um servidor MCP adequado em vez de uma abordagem baseada em habilidade, pode envolver a API ScreenApp em um servidor MCP Node.js. Isso oferece compatibilidade com Claude Desktop, Cursor e qualquer outro cliente MCP, não apenas o 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) }],
};
}
);
Em seguida, registre-o na configuração do OpenClaw ou use-o de forma independente com o Claude Desktop.
Casos de uso
Acompanhamentos de reuniões: Pergunte ao seu agente “O que a Sarah disse sobre o cronograma na ligação de ontem?” e ele puxará a transcrição, encontrará a seção relevante e lhe dará a resposta.
Resumos semanais: “Resumir todas as minhas reuniões desta semana” aciona uma busca em suas gravações e gera um relatório consolidado.
Rastreamento de itens de ação: “Quais itens de ação abertos tenho das reuniões deste mês?” pesquisa suas transcrições por compromissos e prazos.
Reaproveitamento de conteúdo: “Transformar minha última gravação de webinar em um esboço de post de blog” usa o endpoint de análise de IA para gerar conteúdo estruturado a partir do seu vídeo.
Recursos relacionados do ScreenApp
- Resumidor de Reuniões com IA: Gere resumos de qualquer gravação
- Software de Transcrição: Fala para texto automática com identificação de oradores
- Tomador de Notas com IA: Notas estruturadas de suas conversas
Perguntas Frequentes
O que é um servidor MCP?
Um servidor MCP (Model Context Protocol) é um programa local que expõe dados e ferramentas a modelos de IA. Ele permite que assistentes de IA como Claude ou agentes OpenClaw acessem serviços externos sem copiar e colar dados manualmente.
Preciso de um plano pago do ScreenApp para acesso à API?
O acesso à API está disponível nos planos pagos do ScreenApp. Verifique as configurações da sua conta para ver se a seção da API está disponível. Contas gratuitas têm acesso limitado à API.
Posso usar isso com o Claude Desktop em vez do OpenClaw?
Sim. A abordagem do servidor MCP funciona com qualquer cliente compatível com MCP. Claude Desktop, ChatGPT Desktop e Cursor todos suportam servidores MCP. O OpenClaw adiciona o benefício de acessá-lo a partir de aplicativos de mensagens móveis.
Meus dados de gravação são enviados para os servidores do OpenClaw?
Não. O OpenClaw é auto-hospedado e roda inteiramente na sua máquina. Seu token de API do ScreenApp e os dados de gravação permanecem locais. O modelo de IA processa os dados, mas o próprio OpenClaw não armazena nem encaminha seu conteúdo.
Como o agente encontra a skill certa?
OpenClaw verifica os campos name e description de cada skill instalada no início de cada sessão. Quando você pergunta algo como “encontrar minha última reunião”, o agente compara isso com as descrições das skills e carrega o SKILL.md completo da skill que melhor se encaixa. É por isso que a descrição deve incluir frases de gatilho concretas como “transcrição”, “notas de reunião” e “gravações”, em vez de linguagem vaga como “ajuda com gravações”.
Quantas gravações o servidor MCP pode manipular?
A API ScreenApp lida com paginação, então você pode trabalhar com bibliotecas de qualquer tamanho. Para melhores resultados, use consultas de busca para refinar os resultados em vez de listar tudo de uma vez.
