SideButton은 MCP 서버를 중심으로 구축된 오픈 소스 AI 에이전트 플랫폼입니다. 이는 모든 코딩 에이전트에게 실제 브라우저, 워크플로 엔진(workflow engine), 그리고 재사용 가능한 도메인 지식(domain knowledge)을 제공합니다. 버전 1.5가 출시되었으며, 모든 기능은 사용자의 로컬 머신에서 실행됩니다.

주요 구성 요소

MCP 서버. 실제 브라우저 제어, 워크플로 실행(workflow execution), 실행 로그(run logs), 그리고 아티팩트(artifacts)를 위한 내장 도구들을 제공합니다. Claude Code, Cursor, Copilot, Windsurf는 MCP OAuth 2.1을 통해 stdio 또는 HTTP + SSE를 통해 연결됩니다.

워크플로 엔진 (Workflow engine). YAML로 정의되는 에이전트 워크플로(Agentic workflows)로, 브라우저 동작, 셸 명령(shell commands), LLM 호출, 제어 흐름(control flow)을 아우르는 단계 유형을 포함하며, 중첩된 워크플로와 재시도(retries) 기능을 지원합니다.

지식 팩 (Knowledge packs). 일반적인 코딩 에이전트를 특정 앱을 위한 소프트웨어 엔지니어, QA 엔지니어 또는 제품 관리자(product manager)로 변모시키는 도메인 지식입니다. 웹 앱별로 셀렉터(selectors), 데이터 모델, 워크플로 및 내장된 역할(roles)을 제공합니다.

REST API 및 대시보드. 모든 웹훅(webhook), 크론 잡(cron job) 또는 내부 도구가 워크플로를 트리거할 수 있도록 하는 REST API와, 실시간 실행 로그 및 팩 관리자(pack manager)를 갖춘 로컬 대시보드를 제공합니다.

트래커(Tracker) 및 채팅 단계는 Jira, Linear, GitHub, Slack에서 작동합니다. LLM 제공업체는 환경에서 자동으로 감지됩니다.

시작하기

서버 설치:

npx sidebutton@latest

SideButton Chrome 확장 프로그램을 설치한 다음, 에이전트를 서버로 연결하세요:

claude mcp add sidebutton --transport http http://localhost:9876/mcp

sidebutton registry add를 사용하여 작업 중인 웹 앱에 대한 지식 팩을 설치하거나, sidebutton init으로 직접 스캐폴딩(scaffold)할 수 있습니다. 팩은 ~/.sidebutton/skills/에 저장되며 시작 시 로드됩니다.

그 지점부터 에이전트는 워크플로 (workflows)를 실행하고, 추론 (reasoning)이 필요한 경우 LLM을 호출하며, 모든 단계를 기록하면서 스스로 작동합니다. 사용자의 브라우저, 세션, API 키는 모두 로컬 (local)에 유지됩니다.

지식 팩 (Knowledge packs)은 단순한 마크다운 (markdown)입니다

팩 (pack)은 마크다운 파일들로 구성된 폴더이므로, 코드와 마찬가지로 검토 및 차이점 비교 (diff)가 가능합니다. Claude에게 세션 동안 학습한 내용을 캡처하도록 요청하거나, sidebutton init으로 팩을 스캐폴딩 (scaffold)한 다음 로컬 폴더 또는 git 리포지토리 (repo) 형태의 레지스트리 (registry)를 통해 공유할 수 있습니다. 설치된 팩은 시작 시 워크플로, 역할 (roles), 도메인 타겟 (domain targets)을 사용자의 로컬 설정 (config)에 병합합니다.

플러그인 (Plugins)으로 자신만의 도구를 추가하세요

MCP 서버는 어떤 언어로든 확장 가능합니다. 플러그인은 ~/.sidebutton/plugins/ 아래에 매니페스트 (manifest)와 핸들러 스크립트 (handler script)가 포함된 폴더이며, 시작 시 내장 도구와 함께 로드됩니다. 두 가지가 기본으로 제공됩니다: 에이전트 세션을 MP4로 캡처하는 screen-record와 콘텐츠가 출력되기 전에 점수를 매기는 writing-quality입니다.

향후 계획

네이티브 iOS 및 Android 앱, 그리고 팀들이 지식 팩을 매번 다시 만드는 대신 발견하고 공유할 수 있는 공개 레지스트리 (public registry)를 준비 중입니다.

이 플랫폼은 현재 안정적이며 오픈 소스 (open source)입니다. 인기 있는 웹 앱을 위해 이미 게시된 AI 에이전트 스킬 (AI agent skills)을 살펴보거나, 여러분의 팀이 사용하는 앱을 위한 스킬을 직접 작성해 보세요.

원문은 sidebutton.com에 게시되었습니다.