Конструктор для агентів: MCP

Усе, що конструктор робить у кабінеті, він робить і для вашого агента чи скрипта: додати знання, підключити канал, змінити характер, створити дію або розклад. Вхід — MCP-сервер.

Інструментів три, і лише один щось МІНЯЄ — constructor, тобто та сама розмова, що в кабінеті: окремому каталогу «методів» нема з чого відставати. Двоє інших — вікна на читання, щоб агент, який щойно підключився, не говорив про бота, якого не бачив.

https://api.youselfbot.com/v1/api/mcp

Ключ конструктора — не ключ бота

Для MCP потрібен ключ конструктора (ck_…). Він навмисно окремий від ключів бота:

Ключ	Що відкриває	Де живе
pk_… публікований	вікно чату на сайті	у HTML вашої сторінки
sk_… секретний ключ бота	інтеграції одного бота: чат, знання, оператори	у вашому бекенді
ck_… ключ конструктора	керування всіма агентами простору — MCP і керівний API	тільки у ваших агентних клієнтах

Ключ інтеграції, вшитий у чийсь бекенд, не повинен уміти перебудувати бота — тому sk_ до конструктора не пускається. Межі ck_: керує агентами як власник, але не платить, не видаляє агентів і не чіпає команду.

Спосіб 1 — через браузер (найпростіший)

Клієнти, що вміють пейринг, ключа не просять: вони самі приведуть вас у кабінет. Потік такий:

1. клієнт викликає POST /v1/mcp-pair/start і показує вам посилання;
2. ви відкриваєте його — це сторінка app.youselfbot.com/connect, де написано, хто саме проситься;
3. натискаєте Дозволити — і клієнт сам забирає свій ключ (GET /v1/mcp-pair/poll).

Ключ ніколи не показується на екрані й не проходить через буфер обміну. Схвалення другого клієнта не відключає перший.

Мінімальний приклад для скрипта:

START=$(curl -s -X POST https://api.youselfbot.com/v1/mcp-pair/start \
  -H "Content-Type: application/json" -d '{"device":"мій скрипт"}')
echo "Відкрийте: $(echo $START | jq -r .verify_url)"
# після «Дозволити» в браузері:
curl -s "https://api.youselfbot.com/v1/mcp-pair/poll?code=$(echo $START | jq -r .code)&secret=$(echo $START | jq -r .secret)"
# → {"status":"ok","constructor_key":"ck_…"}

Спосіб 2 — ключ із кабінету

Акаунт → MCP для агентів → Новий ключ конструктора. Ключ показується один раз, поруч — готова команда для Claude Code:

claude mcp add --transport http youselfbot \
  https://api.youselfbot.com/v1/api/mcp \
  --header "Authorization: Bearer ck_ВАШ_КЛЮЧ"

Кнопка має семантику перевипуску: попередні ключі конструктора перестають діяти тієї ж миті. Конфігурація для будь-якого клієнта, що читає mcpServers:

{
  "mcpServers": {
    "youselfbot": {
      "type": "http",
      "url": "https://api.youselfbot.com/v1/api/mcp",
      "headers": { "Authorization": "Bearer ck_ВАШ_КЛЮЧ" }
    }
  }
}

Інструменти

Інструмент	Що робить	Аргументи
agents	Які агенти є в кабінеті: id, імʼя, скільки джерел знань і каналів. Ключ, виданий під один бот, позначений окремо.	—
incidents	Що в агента зламано — тими самими словами, які читає власник, разом із тим, що полагодити.	agent_id
constructor	Розмова з конструктором: єдине, що щось міняє.	message, thread

Порядок не випадковий: спершу подивіться, з ким працюєте, далі — що болить, і лише тоді міняйте. Зміни застосовуються одразу, тож про незворотне (видалити агента, відключити канал) питайте людину.

Інструмент constructor

Аргумент	Обовʼязковий	Що означає
message	так	Що зробити або спитати — звичайною мовою, як у кабінеті.
thread	ні	Ідентифікатор нитки. Та сама нитка — конструктор памʼятає попередні репліки.

Відповідь — текст конструктора; варіанти-кнопки додаються в кінець тексту. Розмови через MCP живуть окремо від розмови в кабінеті.

Той самий конструктор без MCP-клієнта — один HTTP-виклик:

curl -sS https://api.youselfbot.com/v1/dashboard/builder \
  -H "X-Bot-Key: ck_ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"message":"додай знання: самовивіз із 10 до 19"}'

Агент, який керує собою

Бот платформи вміє підключати зовнішні MCP-сервери — і ніщо не заважає підключити йому цей. Скажіть конструктору:

Підключи MCP-сервер youselfbot за адресою https://api.youselfbot.com/v1/api/mcp з токеном ck_…

— і агент зможе сам просити конструктора міняти себе: дописати знання, яких забракло, поставити нагадування, вимкнути дію, що зламалась.

Ключ — це керування простором

Той, хто має ck_…, керує вашими агентами. Не кладіть його в код сторінок і в репозиторії; якщо витік — Акаунт → Новий ключ конструктора: старі перестануть діяти тієї ж секунди.