# Puppetflow

Управляет браузерными сценариями на собственном сервере Puppetflow прямо из чата с ассистентом. Помогает запускать сценарии, проверять логи и забирать скриншоты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: puppetflow
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/puppetflow/puppetflow
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/puppetflow

## Что делает

Puppetflow связывает ИИ-клиенты с вашей собственной платформой браузерной автоматизации. Все сценарии выполняются удалённо в браузере на сервере, поэтому локальная машина не нагружается. Ассистент получает доступ к списку заготовленных сценариев на JavaScript, может активировать их выполнение, следить за ходом шагов и запрашивать результаты.

Через MCP-сервер агент считывает историю прогонов, скачивает видеозаписи сессий и свежие скриншоты. Если автоматизация застряла на проверке, человек может перехватить управление окном браузера вручную. Без поднятого инстанса платформы и созданного токена интеграция работать не будет. Доступ настраивается через протокол HTTP с авторизацией Bearer-токеном или по OAuth.

## Требования
- Нужно: Docker
- Удалённый сервер: `https://{instance_host}/api/workspaces/{workspace}/mcp-server/http`

## Установка

### Claude Code (родная платформа)

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

### Codex

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add puppetflow --url https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

### Cursor

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "puppetflow": {
            "url": "https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"
        }
    }
}
```

### GitHub Copilot

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "puppetflow": {
            "type": "http",
            "url": "https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"
        }
    }
}
```

### Gemini CLI

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http puppetflow https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

## Когда брать
- запустить готовый браузерный сценарий из чата с ИИ
- получить скриншоты и видеозаписи завершённых прогонов
- проверить журналы выполнения автоматизации при ошибках
- передать входные параметры в рабочий процесс на JavaScript

## Примеры запросов агенту
- Запусти сценарий авторизации в сервисе и пришли итоговый скриншот
- Проверь статус последнего прогона и покажи ошибки из логов
- Найди в библиотеке сценарий сбора цен и запусти его с новыми параметрами

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32260
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13181
- [apify-mcp-server](https://affpapa.org/nevibecode/mcp/apify-mcp-server.md) — MCP-сервер · ★ 13345

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md