Що вміє MCP
- Бачити акаунт: онлайн-чати, особистості, ШІ-співробітників, завдання з їхніми сайтами, критеріями, розкладом і статусом.
- Пояснювати, що завдання зробило з посиланням: чи знайшло елемент, коли, яку оцінку поставив ШІ й чому, чи пішов лист; останні запуски завдання.
- Змінювати налаштування, як майстер: створити завдання, онлайн-чат або збір контактів; змінити критерії, сайти, розклад завдання, куди надсилати результати; запустити, поставити на паузу чи увімкнути завдання; запустити або зупинити збір контактів; поправити привітання, швидкі питання, FAQ, вигляд і джерела знань чату; інструкції особистості та ШІ-співробітника; зберегти ключ API завдання.
- Вивантажувати налаштування у файл і завантажувати файл (спочатку перевірка, потім створення).
- Кожна зміна спершу лише пропонується й застосовується окремою командою після вашої згоди.
Що всередині скіла
- Інструкції, як правильно працювати із завданнями: створювати, редагувати, дивитися логи.
- Формат файлу налаштувань з усіма полями та його JSON Schema.
- Інструкції та перелік усіх доступних API.
- Список дій майстра для MCP і готові приклади файлів.
Підключення Codex і Claude
Крок 1. Отримайте API-ключ
- Відкрийте в панелі «Налаштування → Інтеграції» і натисніть «Випустити ключ».
- Ключ показується один раз. Натисніть «Завантажити файлом» — у папці «Завантаження» з’явиться файл
aiworker-key.txt.
Крок 2. Попросіть ваш ШІ все встановити
Скопіюйте й надішліть вашому Codex або Claude Code:
Встанови MCP-сервер AI Worker і скіл aiworker з репозиторію https://github.com/needtome/aiworker-skills. API-ключ лежить у файлі ~/Downloads/aiworker-key.txt: перенеси його у змінну оточення AIWORKER_API_KEY, не показуючи ключ на екрані, а потім видали цей файл.
ШІ сам збереже ключ, підключить MCP і скіл. Перезапустіть Codex або Claude Code, коли він попросить.
Якщо хочете зберегти ключ самі
Ключ кладуть у змінну оточення AIWORKER_API_KEY. Замініть ваш-ключ на ключ із панелі й виконайте одну команду.
Mac — відкрийте програму «Термінал» (Spotlight: ⌘ + пробіл, «Термінал»):
echo 'export AIWORKER_API_KEY="ваш-ключ"' >> ~/.zshrc
Windows — відкрийте PowerShell (Пуск → «PowerShell»):
setx AIWORKER_API_KEY "ваш-ключ"
Linux — у терміналі:
echo 'export AIWORKER_API_KEY="ваш-ключ"' >> ~/.bashrc
Закрийте й знову відкрийте термінал, Codex або Claude Code. Потім попросіть ШІ:
Встанови MCP-сервер AI Worker і скіл aiworker з репозиторію https://github.com/needtome/aiworker-skills. API-ключ — у змінній оточення AIWORKER_API_KEY.
Не вставляйте ключ просто в чат із ШІ й не зберігайте його в нотатках чи спільних документах: там його можуть прочитати сторонні.
Вручну
Claude Code — плагін (скіл + MCP)
/plugin marketplace add needtome/aiworker-skills
/plugin install aiworker@aiworker-skills
/reload-plugins
Claude Code — лише MCP
claude mcp add --transport http aiworker https://kra.name/app/api/mcp \
--header "Authorization: Bearer $AIWORKER_API_KEY"
Codex — у ~/.codex/config.toml
[mcp_servers.aiworker]
url = "https://kra.name/app/api/mcp"
bearer_token_env_var = "AIWORKER_API_KEY"
Claude у браузері чи застосунку
- Customize → Connectors → додайте свій конектор.
- Адреса:
https://kra.name/app/api/mcp. - Заголовок запиту:
Authorization: Bearer <API-ключ>. - Використовуйте або конектор, або плагін Claude Code — не обидва на одному комп’ютері.
Лише скіл
Найпростіше: попросіть ваш ШІ
Напишіть вашому Codex або Claude Code:
Встанови скіл aiworker з репозиторію https://github.com/needtome/aiworker-skills — папка plugins/aiworker/skills/aiworker.
Вручну
- Завантажте архів aiworker-skill.zip.
- Розпакуйте його — вийде папка
aiworker. - Покладіть папку:
- Claude Code — у
~/.claude/skills/ - Codex — у
~/.agents/skills/
- Claude у браузері чи застосунку: Customize → Skills → «+» → завантажте zip повністю.
Те саме в терміналі:
curl -L https://kra.name/skills/aiworker-skill.zip -o /tmp/aiworker-skill.zip
unzip -o /tmp/aiworker-skill.zip -d ~/.claude/skills # Claude Code
unzip -o /tmp/aiworker-skill.zip -d ~/.agents/skills # Codex
Підключити до ChatGPT
Ваш акаунт AI Worker підключається до ChatGPT як плагін (MCP-сервер): ChatGPT бачить ваші чати, особистості, завдання та знайдене з оцінками ШІ й може пропонувати зміни — вони застосовуються лише після вашої згоди в розмові. Ключ копіювати не треба: вхід через ваш акаунт AI Worker.
Так ваш акаунт підключається просто до вашого ChatGPT: він працює з ним у браузері чи застосунку ChatGPT — без Codex, Claude Code і встановлення будь-чого на комп’ютер.
- Відкрийте chatgpt.com/plugins → «Додати» → власний сервер MCP.
- Назва —
AI Worker, URL-адреса сервера — https://kra.name/app/api/mcp, автентифікація — OAuth. «Розширені налаштування OAuth» не чіпайте: ChatGPT знайде їх сам. - Позначте «Я розумію й хочу продовжити» і створіть плагін.
- Відкриється сторінка AI Worker: увійдіть у панель (паролем або через Google) і натисніть «Дозволити доступ».
- Готово: оберіть плагін AI Worker у чаті й попросіть, наприклад: «покажи, що знайшло завдання за тиждень і з якими оцінками».
Працює на будь-якому оплаченому тарифі. Відключити можна в панелі: «Налаштування → Інтеграції». Так само підключається claude.ai: «Налаштування → Конектори → Додати власний конектор», та сама адреса.
Події одразу у ваш Claude або Codex
- Створіть маршрут у панелі: Завдання ШІ-співробітникам → ШІ-агенти — який агент (Claude Code або Codex), як його будити і що робити з кожною подією.
- Події надходять на власну адресу маршруту (на неї надсилає JSON ваша CRM, магазин або форма), з кроку завдання «Передати ШІ-агенту» або через API.
- Відповіді на заявки: якщо ваш ШІ надіслав заявку на те, чого в AI Worker поки немає, відповідь розробників він отримає сам під час наступного звернення до AI Worker і одразу скаже вам — налаштовувати нічого не потрібно.
- Відкрита сесія: скажіть вашому Claude Code «слухай події AI Worker маршруту orders». Він запустить слухач інструментом Monitor; кожна подія розбудить цю сесію, а агент сам позначить, що подію оброблено.
- У фоні: скажіть Claude Code або Codex «встанови фоновий слухач AI Worker для маршруту orders» — він запускається разом із комп’ютером (launchd, systemd або Планувальник завдань) і на кожну подію запускає агента без вікна. Не продовжуйте у фоні сесію, яка в цей самий час відкрита в застосунку.
- Через наш сервер іде лише сигнал «є подія» без вмісту; саму подію слухач забирає за вашим API-ключем. Події зберігаються 30 днів.
Скопіюйте й надішліть вашому ШІ (замість orders — ім’я вашого маршруту):
Codex — фонова служба, яка будить Codex на кожну подію:
Підключи отримання подій AI Worker до Codex для маршруту orders: встанови слухач aiworker-listen зі скіла aiworker у режимі run як фонову службу, що запускається під час входу в систему. API-ключ — у змінній оточення AIWORKER_API_KEY. Перевір, що служба працює, і покажи, як її зупинити.
Claude Code — у цій відкритій сесії:
Слухай події AI Worker маршруту orders і обробляй кожну за інструкцією маршруту.
Що можна попросити
- «Зроби завдання: кожні 30 хвилин перевіряти нові замовлення з Laravel на freelancehunt і upwork, надсилати підходящі від $300»
- «Створи онлайн-чат для стоматології з консультантом Анною і ось цими питаннями та відповідями…»
- «Чому завдання „Замовлення“ не надіслало ось цей проєкт?» — коли підключено MCP
Усі зміни — у два кроки: ШІ спочатку показує, що змінить, і застосовує лише після вашого «так».