Public API

Підключити ШІ-асистента (MCP)

Створіть ключ API лише з тими скоупами, які асистентові потрібні, і дайте клієнту адресу https://api.mosaqo.app/v1/mcp з цим ключем як bearer-токеном. Асистент зможе рівно те, що дозволяє ключ, і нічого більше, а відключити його можна будь-коли в Bulk & API.

Перевірено 20 серпня 2026 р.

Кроки

1. Відкрийте Bulk & API → API keys і створіть ключ. Спершу дайте лише скоупи на читання — другий ключ із записом видасте, коли побачите, що асистент робить.
2. Скопіюйте адресу з панелі AI assistants (MCP) на тому ж екрані.
3. В асистенті додайте сервер із цією адресою і надсилайте ключ у заголовку Authorization: Bearer. Більшість клієнтів приймає блок JSON із url і headers.
4. Деякі конектори просять увійти в Mosaqo замість вставляння ключа. Той шлях показує, хто просить, якого простору це стосується і що саме він зможе, ще до того, як щось дано, — підтвердити може лише власник або адміністратор.
5. Спитайте асистента, що він уміє. Він перелічить інструменти, які дозволяє ваш ключ, — це найшвидше підтвердження, що підключення обмежене так, як ви хотіли.

Як перевірити результат

Спитайте те, що знає тільки цей простір: скільки у вас кодів або як іде опитування. Відповідь із вашими справжніми назвами й числами означає, що зв'язок працює; відмова з назвою скоупа означає, що ключ вужчий за питання.

Що зазвичай іде не так

• Дати запис уже першому ключу. Почніть із читання й розширюйте, коли знатимете, що асистент із цим робить.
• Чекати, що він прочитає написане людьми в опитуванні. Ці відповіді не віддаються ні ключу, ні асистентові — оцінки й кількості так, речення лишаються в інбоксі.
• Чекати, що він видалить код. Не зможе: знищення редиректу за надрукованим кодом незворотне, тож асистентові пропонується архівація, і вона зворотна.
• Забути про підключення. Асистент, підключений через вхід, має доступ, доки його не відключити в Bulk & API, — так само як ключ живе, доки його не відкликати.