Seu agente de IA deve ser capaz de recuperar as notas da reunião da última terça-feira sem que você precise vasculhar 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 mostra como construir 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 compara.

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 de seus aplicativos de chat para 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. Skills também podem encapsular 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, ela 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 um 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.

Servidores MCP rodam localmente e expõem ferramentas (ações que a IA pode tomar) 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”.

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 fornece 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 - Recupere uma gravação e sua transcrição completa, com carimbos de data/hora 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.

Etapas de configuração

1. Obtenha seu token da API do ScreenApp

Faça login no ScreenApp, vá para Configurações > API, e gere um novo token. Copie-o para um local seguro. Você precisará dele na próxima etapa.

2. Crie a pasta da skill

As skills do OpenClaw ficam 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 seleciona 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 notas de reuniões e itens de ação, transcreva áudio e vídeo, faça perguntas à IA sobre conteúdo gravado. Use quando o usuário mencionar transcrição, notas de reunião, gravações, áudio para texto, fala para texto, pesquisa de reuniões, ou quiser 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 solicitações exigem a variável de ambiente SCREENAPP_API_TOKEN.

Headers: Authorization: Bearer $SCREENAPP_API_TOKEN Base URL: https://api.screenapp.io

Ações disponíveis

Buscar gravações por palavra-chave

GET /v2/files?searchQuery={query}

Use isto 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 marcação de tempo e identificação de locutores. Use isto para recuperar notas de reuniões, 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 Corpo: { “promptText”: “sua pergunta aqui” }

Analisa tanto a transcrição quanto o conteúdo do vídeo. Use isto 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 isto 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 de habilidades leve.

#

## 4. Definir o token da API

Adicione seu token do ScreenApp ao ambiente do OpenClaw. Edite `~/.openclaw/openclaw.json`:

```json
{
  "env": {
    "SCREENAPP_API_TOKEN": "seu-token-aqui"
  }
}

Ou exporte-o em 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 ela foi carregada perguntando ao seu agente: “Que habilidades você tem?“

6. Teste-o

Envie uma mensagem para o seu agente OpenClaw no Telegram ou WhatsApp:

• “Pesquise nas minhas gravações do ScreenApp pela discussão do roadmap do produto”
• “Obtenha 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 no ClawHub

Se você deseja 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 pesquisa 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 habilidades:

{
  "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 de IA sobre conteúdo gravado via API ScreenApp.",
  "author": "seu-nome-de-usuário-clawhub",
  "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"
}

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 habilidades, pode encapsular a API ScreenApp em um servidor MCP Node.js. Isso lhe dá 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 chamada 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 pesquisa 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: “Transforme a gravação do meu último 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: Transcrição automática de fala para texto com etiquetas de locutor
• Anexador 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 em 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 habilidade certa?

OpenClaw escaneia os campos name e description de cada habilidade 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 habilidades e carrega o SKILL.md completo da habilidade 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 uma linguagem vaga como “ajuda com gravações”.

Quantas gravações o servidor MCP pode lidar?

A API ScreenApp lida com a paginação, então você pode trabalhar com bibliotecas de qualquer tamanho. Para melhores resultados, use consultas de pesquisa para refinar os resultados em vez de listar tudo de uma vez.