/ Diretório / Playground / OpenAgent
● Comunidade the-open-agent ⚡ Instantâneo

OpenAgent

por 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.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/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"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "openagent-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@open-agent/mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: OpenAgent

Delegate a fiddly desktop task to OpenAgent

👤 Developers ⏱ ~15 min intermediate

Quando usar: You want Claude to drive a GUI app it can't directly control.

Fluxo
  1. Bridge
    Run OpenAgent locally; Claude lists its tools.✓ Copiado
    → Tools visible
  2. Delegate
    Ask Claude to call into OpenAgent for the GUI step.✓ Copiado
    → Step runs
  3. Verify
    Inspect the run trace before accepting results.✓ Copiado
    → Audit done

Resultado: Claude completes a GUI step by handing it off.

Combinações

Combine com outros MCPs para 10× de alavancagem

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✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
gui_act (see docs) Run a computer-use action 1 call
code_edit (see docs) Run a coding-agent edit 1 call

Custo e limites

O que custa rodar

Cota de API
Local + LLM
Tokens por chamada
Computer-use is screenshot-heavy → expensive
Monetário
Free OSS; LLM costs
Dica
Prefer code mode when the task is text-friendly

Segurança

Permissões, segredos, alcance

Escopos mínimos: screen-capture input-injection
Armazenamento de credenciais: Local config in user dir
Saída de dados: Configured LLM provider
Nunca conceda: Leave computer-use running on a machine with secrets visible

Solução de problemas

Erros comuns e correções

GUI action misses target

Increase screenshot resolution or use OCR mode

Alternativas

OpenAgent vs. outros

AlternativaQuando usarTroca
UI-TARS-desktopYou want a heavier multimodal stackMore resources

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills