ScreenApp을 OpenClaw AI 에이전트에 MCP 서버를 통해 연결하는 방법
On this page
귀하의 AI 에이전트는 폴더를 뒤지지 않고도 지난 화요일 회의록을 불러올 수 있어야 합니다. ScreenApp의 API와 모델 컨텍스트 프로토콜(MCP)을 사용하면 OpenClaw 에이전트에게 귀하의 녹음, 녹취록, AI 요약에 대한 직접적인 액세스를 제공할 수 있습니다.
이 가이드는 ScreenApp MCP 서버 스킬을 구축하여 OpenClaw 에이전트가 Telegram, WhatsApp 또는 Discord의 채팅 메시지에서 녹음을 검색하고, 녹취록을 가져오고, 콘텐츠에 대한 AI 분석을 실행할 수 있도록 하는 과정을 설명합니다.
회의 녹음용 MCP 서버에 대해 처음 접하신다면, ScreenApp이 어떻게 경쟁 우위를 가지는지 확인하기 위해 최고의 회의용 MCP 서버 비교를 확인해 보세요.
OpenClaw란 무엇인가요?
OpenClaw는 메시징 앱(WhatsApp, Telegram, Discord, iMessage)을 AI 코딩 에이전트에 연결하는 자체 호스팅 게이트웨이입니다. 컴퓨터에서 단일 프로세스를 실행하면 채팅 앱이 항상 사용 가능한 AI 비서에 연결됩니다.
핵심 아이디어: 휴대폰에서 에이전트에게 메시지를 보내면, 에이전트가 도구를 사용하고, 파일을 읽고, 웹을 탐색하며, 이제 ScreenApp 녹음에도 액세스할 수 있습니다.
OpenClaw는 에이전트에게 도구 사용법을 가르치기 위해 스킬을 사용합니다. 각 스킬은 사용 가능한 명령을 설명하는 SKILL.md 파일이 있는 폴더입니다. 스킬은 MCP 서버를 래핑할 수도 있으며, 이것이 ScreenApp을 연결하는 방법입니다.
OpenClaw는 3단계 시스템을 통해 스킬을 발견합니다. 세션 시작 시 에이전트는 모든 스킬의 프런트매터에서 name 및 description을 스캔합니다. 스킬이 관련성이 있다고 판단되면 전체 SKILL.md를 로드합니다. 이는 설명 필드가 에이전트가 스킬을 선택하는지 여부에 대한 가장 중요한 단일 요소임을 의미합니다. 동료에게 스킬이 무엇을 하고 언제 사용해야 하는지 알려주듯이 작성하십시오.
MCP란 무엇인가요?
모델 컨텍스트 프로토콜은 Anthropic이 생성한 표준으로, AI 모델이 외부 데이터 소스에 액세스할 수 있도록 합니다. AI 앱을 위한 USB-C와 같다고 생각하면 됩니다. ChatGPT에 녹취록을 복사하여 붙여넣는 대신, MCP 서버를 통해 AI가 필요한 것을 직접 가져올 수 있습니다.
MCP 서버는 로컬에서 실행되며 도구(AI가 취할 수 있는 조치)와 리소스(AI가 읽을 수 있는 데이터)를 노출합니다. ScreenApp의 경우, 도구에는 “녹음 검색”, “녹취록 가져오기”, “비디오에 대한 질문하기” 등이 포함될 것입니다.
MCP는 Claude Desktop, ChatGPT Desktop, Cursor, 그리고 OpenClaw를 통해 모든 메시징 앱과 함께 작동합니다.
ScreenApp API 개요
ScreenApp은 MCP 통합에 필요한 모든 것을 다루는 REST API를 제공합니다. 주요 엔드포인트는 다음과 같습니다.
- 녹음 목록 - 필터를 사용하여 녹음 라이브러리 탐색
- 녹취록과 함께 녹음 가져오기 - 타임스탬프와 화자 레이블이 포함된 녹음 및 전체 녹취록 가져오기
- AI 분석 - 다중 모드 분석 엔드포인트(
_v2/files/{fileId}/ask/multimodal_)를 사용하여 녹음에 대한 질문하기 - 검색 - 모든 콘텐츠에서 키워드로 녹음 찾기
- 업로드 - 처리를 위해 새 오디오/비디오 파일 보내기
인증은 베어러 토큰을 사용합니다. ScreenApp 계정 설정에서 API 토큰을 생성합니다.
전체 참조는 ScreenApp API 문서를 참조하십시오.
설정 단계
1. ScreenApp API 토큰 받기
ScreenApp에 로그인한 다음, 설정 > API로 이동하여 새 토큰을 생성하세요. 안전한 곳에 복사해 두세요. 다음 단계에서 필요합니다.
2. 스킬 폴더 생성
OpenClaw 스킬은 ~/.openclaw/skills/ (모든 에이전트에서 공유) 또는 작업 공간의 /skills/ 폴더 (에이전트별)에 있습니다. 스킬 폴더 이름은 SKILL.md 프런트매터의 name 필드와 일치해야 합니다. 전체 구조를 생성하세요:
mkdir -p ~/.openclaw/skills/screenapp/references
최종 폴더 레이아웃:
screenapp/
├── SKILL.md # 필수: 프런트매터 + 에이전트 지침
├── claw.json # ClawHub 게시용 (선택 사항)
└── references/
└── api-endpoints.md # 필요에 따라 로드되는 상세 엔드포인트 문서
3. SKILL.md 작성
description 필드는 에이전트가 이 스킬을 선택할지 여부를 결정합니다. OpenClaw는 각 세션 시작 시 설치된 모든 스킬의 name 및 description을 스캔합니다. 에이전트가 회의록, 회의, 녹음 및 필기에 대한 요청에 일치하도록 트리거 문구와 키워드 변형을 포함하세요.
~/.openclaw/skills/screenapp/SKILL.md 생성:
---
name: screenapp
description: 회의 녹음 및 회의록 검색, 회의록 및 실행 항목 가져오기, 오디오 및 비디오 전사, 녹음된 콘텐츠에 대한 AI 질문. 사용자가 전사, 회의록, 녹음, 오디오-텍스트 변환, 음성-텍스트 변환, 회의 검색을 언급하거나 녹음된 회의 및 통화를 찾거나 분석하려 할 때 사용합니다.
metadata: {"clawdbot":{"emoji":"","requires":{"env":["SCREENAPP_API_TOKEN"]},"primaryEnv":"SCREENAPP_API_TOKEN","homepage":"https://screenapp.io"}}
---
# ScreenApp 통합
사용자의 ScreenApp 녹음, 회의록 및 AI 분석에 접근합니다.
인증
모든 요청에는 SCREENAPP_API_TOKEN 환경 변수가 필요합니다.
헤더: Authorization: Bearer $SCREENAPP_API_TOKEN 기본 URL: https://api.screenapp.io
사용 가능한 작업
키워드로 녹음 검색
GET /v2/files?searchQuery={query}
사용자가 특정 회의, 녹음 또는 주제를 찾고 싶을 때 사용하세요.
스크립트와 함께 녹음 가져오기
GET /v2/files/{fileId}
타임스탬프가 찍힌 스피커 레이블이 포함된 전체 녹음 개체를 반환합니다. 회의록을 검색하거나, 말한 내용을 다시 읽거나, 통화의 전체 텍스트를 가져올 때 사용하세요.
녹음에 대해 AI에게 질문하기
POST /v2/files/{fileId}/ask/multimodal Body: { “promptText”: “여기에 질문 입력” }
스크립트와 비디오 콘텐츠를 모두 분석합니다. 회의 요약, 실행 항목 추출, 녹음에서 발생한 특정 질문에 답할 때 사용하세요.
최근 녹음 목록
GET /v2/files?sortBy=createdAt&sortOrder=desc&limit=10
사용자가 최신 회의 또는 최근 녹음에 대해 물을 때 사용하세요.
선택적으로 `references/api-endpoints.md` 파일을 생성하여 더 자세한 매개변수 문서를 포함할 수 있습니다. 에이전트는 필요할 때만 참조 파일을 로드하여 초기 스킬 스캔을 가볍게 유지합니다.
#
## 4. API 토큰 설정
OpenClaw 환경에 ScreenApp 토큰을 추가하세요. ``~/.openclaw/openclaw.json` 파일을 편집하세요:
```json
{
"env": {
"SCREENAPP_API_TOKEN": "여기에 토큰"
}
}
또는 원한다면 쉘 프로필에 내보낼 수도 있습니다.
5. OpenClaw 재시작
openclaw gateway restart
에이전트는 다음 세션에서 새 스킬을 습득할 것입니다. 에이전트에게 “어떤 스킬을 가지고 있니?”라고 물어봄으로써 로드되었는지 확인할 수 있습니다.
6. 테스트하기
Telegram 또는 WhatsApp에서 OpenClaw 에이전트에게 메시지를 보내세요:
- “ScreenApp 녹화에서 제품 로드맵 토론을 찾아줘”
- “마지막 회의록을 가져와줘”
- “어제 스탠드업에서 나온 조치 항목은 무엇인가요?”
에이전트는 ScreenApp 스킬을 사용하여 데이터를 가져오고 질문에 답할 것입니다.
ClawHub에 게시하기
다른 OpenClaw 사용자가 ScreenApp 스킬을 찾아 설치할 수 있도록 하려면, OpenClaw의 공식 스킬 레지스트리인 ClawHub에 게시하세요. ClawHub는 벡터 검색을 사용하므로, 설명에 해당 용어가 포함되어 있다면 “회의록 검색” 또는 “오디오 녹음 기록”과 같은 자연어 쿼리로도 스킬이 노출될 것입니다.
스킬 폴더에 claw.json 매니페스트를 추가하세요:
{
"name": "screenapp",
"version": "1.0.0",
"description": "ScreenApp API를 통해 회의 녹화를 검색하고, 회의록을 가져오고, 조치 항목을 추출하며, 녹화된 콘텐츠에 대해 AI에 질문하세요.",
"author": "your-clawhub-username",
"license": "MIT",
"permissions": ["network"],
"entry": "SKILL.md",
"tags": ["필사", "회의", "녹음", "메모 작성", "생산성", "음성-텍스트 변환"],
"models": ["claude-*", "gpt-*", "gemini-*"],
"minOpenClawVersion": "0.8.0"
}
그런 다음 게시하세요:
clawhub publish ~/.openclaw/skills/screenapp
게시되면 누구나 다음 명령으로 설치할 수 있습니다:
clawhub install screenapp
귀하의 스킬은 OpenClaw, Claude Code, Cursor 및 기타 AI 코딩 도구의 스킬을 나열하는 크로스 플랫폼 인덱스인 Moltbook에도 표시될 것입니다. Moltbook은 ClawHub를 자동으로 색인하므로 추가 단계가 필요하지 않습니다.
MCP 서버 구축 (고급)
스킬 기반 접근 방식 대신 적절한 MCP 서버를 원한다면, ScreenApp API를 Node.js MCP 서버로 래핑할 수 있습니다. 이렇게 하면 OpenClaw뿐만 아니라 Claude Desktop, Cursor 및 기타 모든 MCP 클라이언트와 호환됩니다.
// 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) }],
};
}
);
그런 다음 OpenClaw의 구성에 등록하거나 Claude Desktop과 함께 독립적으로 사용하세요.
사용 사례
회의 후속 조치: 에이전트에게 “어제 통화에서 Sarah가 타임라인에 대해 뭐라고 말했어?”라고 물으면, 스크립트를 가져와 관련 섹션을 찾아 답을 제공합니다.
주간 요약: “이번 주 회의를 모두 요약해 줘”라고 말하면, 녹화된 내용을 검색하고 통합 보고서를 생성합니다.
조치 항목 추적: “이번 달 회의에서 남아있는 조치 항목은 무엇인가요?”라고 물으면, 회의록에서 약속과 마감일을 검색합니다.
콘텐츠 재활용: “지난 웹 세미나 녹화본을 블로그 게시물 개요로 만들어 줘”라고 말하면, AI 분석 엔드포인트를 사용하여 비디오에서 구조화된 콘텐츠를 생성합니다.
관련 ScreenApp 기능
FAQ
MCP 서버란 무엇인가요?
MCP(모델 컨텍스트 프로토콜) 서버는 AI 모델에 데이터와 도구를 노출하는 로컬 프로그램입니다. 이를 통해 Claude 또는 OpenClaw 에이전트와 같은 AI 비서가 데이터를 수동으로 복사-붙여넣기 할 필요 없이 외부 서비스에 액세스할 수 있습니다.
API 액세스를 위해 유료 ScreenApp 요금제가 필요한가요?
API 액세스는 ScreenApp 유료 요금제에서 제공됩니다. 계정 설정을 확인하여 API 섹션이 사용 가능한지 확인하세요. 무료 계정은 API 액세스가 제한됩니다.
OpenClaw 대신 Claude Desktop과 함께 사용할 수 있나요?
네. MCP 서버 접근 방식은 모든 MCP 호환 클라이언트와 작동합니다. Claude Desktop, ChatGPT Desktop, Cursor는 모두 MCP 서버를 지원합니다. OpenClaw는 모바일 메시징 앱에서 액세스할 수 있는 추가적인 이점을 제공합니다.
내 녹음 데이터가 OpenClaw 서버로 전송되나요?
아니요. OpenClaw는 자체 호스팅되며 전적으로 사용자 기기에서 실행됩니다. ScreenApp API 토큰과 녹음 데이터는 로컬에 유지됩니다. AI 모델이 데이터를 처리하지만 OpenClaw 자체는 콘텐츠를 저장하거나 전달하지 않습니다.
에이전트는 어떻게 올바른 스킬을 찾나요?
OpenClaw는 각 세션 시작 시 설치된 모든 스킬의 name 및 description 필드를 스캔합니다. “마지막 회의 찾기”와 같은 것을 요청하면, 에이전트는 해당 내용을 스킬 설명과 일치시키고 가장 적합한 스킬의 전체 SKILL.md를 로드합니다. 이것이 설명에 “녹취록”, “회의록”, “녹음”과 같은 구체적인 트리거 문구를 포함해야 하는 이유이며, “녹음을 돕습니다”와 같은 모호한 언어는 피해야 합니다.
MCP 서버는 몇 개의 녹음을 처리할 수 있나요?
ScreenApp API는 페이지 매김을 처리하므로 어떤 크기의 라이브러리든 작업할 수 있습니다. 최상의 결과를 얻으려면 모든 것을 한 번에 나열하기보다 검색 쿼리를 사용하여 결과를 좁히십시오.
