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, — так же как ключ живёт, пока его не отозвать.