● 커뮤니티 the-open-agent ⚡ 바로 사용

OpenAgent

Name: OpenAgent MCP Server
Author: the-open-agent

제작: the-open-agent · the-open-agent/openagent

Open-source personal agent with both computer-use and coding-agent modes — exposes its capabilities to Claude via MCP.

OpenAgent runs as a local assistant with two modes: computer-use (screen + input) and coding (file edits + shell). Both are exposed via MCP so Claude Code can delegate desktop or repo work to it.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

Computer-use mode
Coding-agent mode
MCP-native exposure
Local-first
Replayable runs
Multi-LLM

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "openagent-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "openagent-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@open-agent/mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add openagent-mcp -- npx -y @open-agent/mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: OpenAgent

Delegate a fiddly desktop task to OpenAgent

👤 Developers ⏱ ~15 min intermediate

언제 쓸까: You want Claude to drive a GUI app it can't directly control.

흐름

Bridge

Run OpenAgent locally; Claude lists its tools.✓ 복사됨

→ Tools visible
Delegate

Ask Claude to call into OpenAgent for the GUI step.✓ 복사됨

→ Step runs
Verify

Inspect the run trace before accepting results.✓ 복사됨

→ Audit done

결과: Claude completes a GUI step by handing it off.

조합

다른 MCP와 조합해 10배 효율

openagent-mcp + holaos-mcp

OpenAgent for laptop control; HolaOS for sandboxed agent desktop

Combine openagent-mcp with holaos-mcp: OpenAgent for laptop control; HolaOS for sandboxed agent desktop✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
gui_act	(see docs)	Run a computer-use action	1 call
code_edit	(see docs)	Run a coding-agent edit	1 call

비용 및 제한

운영 비용

API 쿼터: Local + LLM
호출당 토큰: Computer-use is screenshot-heavy → expensive
금액: Free OSS; LLM costs
팁: Prefer code mode when the task is text-friendly

보안

권한, 시크릿, 파급범위

최소 스코프: screen-capture input-injection

자격 증명 저장: Local config in user dir

데이터 외부 송신: Configured LLM provider

절대 부여 금지: Leave computer-use running on a machine with secrets visible

문제 해결

자주 발생하는 오류와 해결

GUI action misses target

Increase screenshot resolution or use OCR mode

대안

OpenAgent 다른 것과 비교

대안	언제 쓰나	단점/장점
UI-TARS-desktop	You want a heavier multimodal stack	More resources