Notiamo для ИИ-агентов
Всё, что нужно ИИ-агенту, чтобы открыть бесплатный аккаунт для владельца, поставить виджет на сайт и работать с комментариями и заданиями без браузера.
Порядок действий
- Запросите аккаунт для вашего владельца: отправьте
POST https://my.notiamo.com/api/agent/signupс полямиemail,name,agent,localeи, если они у вас есть,company,projectUrl(адрес сайта) иreferral. В ответе будутrequestId,pollSecretиpollAfterSeconds. - Скажите владельцу открыть письмо с подтверждением, которое присылает Notiamo, и подтвердить. Пока он этого не сделает, ничего не происходит.
- Опрашивайте
GET https://my.notiamo.com/api/agent/signup/{requestId}сAuthorization: Bearer <pollSecret>каждыеpollAfterSecondsсекунд. Статус —pending,confirmed,expiredилиreported. - Когда статус
confirmed, в ответе один раз приходят ваш ключ (token, начинается сntm_) иmcpUrl. Сохраните ключ сразу: следующие опросы его не возвращают. Заберите его в течение 7 дней после подтверждения. - Подключитесь к MCP-серверу по адресу
https://my.notiamo.com/api/mcpс заголовкомAuthorization: Bearer ntm_…. Если ваше приложение поддерживает вход по MCP, оно может использовать «Вход через Notiamo» (Sign in with Notiamo) вместо ключа (см. ниже). - Вызовите
list_projects(илиfind_project), чтобы найти проект, созданный для вас: его адрес уже взят из вашегоprojectUrl. Если адрес отсутствует или неверен, вызовитеupdate_project_address. Затемget_install, установите фрагмент и вызовитеcheck_install. Используйтеcreate_workspaceиcreate_projectтолько когда в тарифе есть место (платные тарифы или пробный период Studio); дляcreate_projectнуженworkspaceIdизlist_workspaces. Рабочее пространство объединяет проекты, например по одному на клиента. У проекта может не быть веб-адреса (опуститеorigin): тогда у него есть задачи, работа и новости, но нет виджета. После установкиget_badgeдаёт значок для подвала: небольшой логотип Notiamo для подвала сайта, который открывает инструменты проверки рецензентам и остаётся обычной ссылкой на Notiamo для остальных, на языке сайта (update_project_languageилиlanguageвcreate_project). - Затем работайте с комментариями:
list_comments,get_comment,replyиset_status. Чтобы узнать о новом, передайте вlist_commentsзначениеsince: время в UTC, оканчивающееся наZ(например,2026-10-17T08:00:00Z), илиcursorиз его последнего ответа. Вы получите только то, что изменилось, по одному проекту или, безprojectId, по всем вашим проектам. Сохраните новыйcursorдля следующей проверки, приmore: trueсразу запросите дальше и убирайте дубликаты поid: элемент может прийти дважды. - Для ещё одной организации вызовите
create_organizationсname: владелец становится её администратором и получает письмо, а ответ содержит новыйtokenтолько для этой организации. Она бесплатна, если у владельца нет бесплатной организации; иначе ей нужен тариф: вызовитеget_payment_linkс новым токеном илиstart_trialдля 14-дневного пробного периода Studio (один раз на человека; владелец открывает ссылку и вводит карту). Есть дневной лимит; в отказе сказано, когда можно попробовать снова. - Чтобы перенести проект в другое рабочее пространство (
kindproject,projectId,toWorkspaceId) или рабочее пространство с его проектами в другую организацию, где владелец тоже администратор (kindworkspace,workspaceId,toOrganizationId), вызовитеrequest_move. Пока ничего не переносится: владелец получает письмо и должен подтвердить на странице по ссылке в течение 24 часов. Вызовитеget_move_request, чтобы узнать статус:pending,done,cancelled,expiredилиfailed. - Чтобы добавить работу, не привязанную к странице, вызовите
create_taskсprojectIdиtitle, а при желанииtextиpageUrl. Чтобы изменить формулировку, вызовитеupdate_taskсtaskIdи новымtitle,textили обоими. Оба вызова учитываются в суточном лимите на новые рабочие пространства, проекты и задачи; когда вы его достигнете, в отказе будет сказано, когда можно повторить.list_commentsпоказывает задачи с пометкой[Task]и принимаетtype:taskилиcomment. - Отчёты о задании (Studio, Agency и пробный период) — это задачи, которые клиент заполняет о выполненной работе: место, дата, конечный заказчик и файлы по фазам (
before,during,after,other) с подписями. Вызовитеlist_job_reports(statereadyперечисляет те, что ждут вас), прочитайте один черезget_commentи ответьте сrolearticleна его языке. Утверждает только человек: дайте ему ссылку на утверждение или вызовитеrequest_approval. После утверждения ответьте сrolepostsиfiles(идентификаторы файлов, которые нужно использовать).update_fileзадаётphaseилиcaptionфайла;create_taskиupdate_taskпринимаютjobReport. - Голосовые заметки и ИИ (Studio, Agency и пробный период):
get_commentперечисляет каждую запись со ссылкой на аудио и её расшифровкой от ИИ (и любой более поздней расшифровкой, не опубликованной), каждое видео длиннее примерно 20 секунд с заметками о времени (m:ss–m:ssчто происходит) и подписи от ИИ с пометкой(AI, not checked), пока человек их не проверит. Если ИИ не смог обработать файл, об этом сказано теми же простыми словами, что видят люди, с кодом обращения (AI-…) для поддержки.list_plansиget_billingпоказывают минуты голоса и ИИ в месяц.
Опрашивайте не чаще, чем pollAfterSeconds. Если получите rate_limited, подождите retryAfter секунд. Неверный или неизвестный идентификатор или секрет возвращает 404 с {"code":"not_found"}.
Если ваша платформа подписывает запросы через Web Bot Auth (подписи HTTP-сообщений, Signature-Agent с каталогом ключей) и Notiamo ей доверяет, регистрация и сервер MCP считают вас по платформе, а не по адресу, с более высокими лимитами. Неподписанные запросы работают как раньше.
Пример: запрос аккаунта
curl -X POST https://my.notiamo.com/api/agent/signup \
-H "Content-Type: application/json" \
-d '{"email":"owner@example.com","name":"Ada Owner","agent":"my-agent","locale":"en","projectUrl":"https://example.com"}'Бесплатный тариф
Бесплатный тариф допускает 1 рабочее пространство, 1 проект, 3 человека (члены команды, участники клиента и ожидающие приглашения, каждый e-mail один раз) и 1 публичный адрес на проект. После первого публичного комментария проекта адрес можно изменить один раз. Помещается 100 МБ файлов, по 5 МБ на файл; при превышении 100 МБ администраторы организации получают два письма, затем самые старые файлы удаляются, а комментарии, задачи и ответы остаются. Загрузки могут быть отклонены, чтобы пресечь злоупотребление. Видео не входит: оно требует Studio, Agency или пробного периода. Рабочее пространство и проект уже существуют, когда открывается аккаунт.
В бесплатном тарифе виджет показывает значок Notiamo.
Оставьте строку комментария над тегом script. Условия бесплатного тарифа этого требуют:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->Отказ plan_limit сообщает, какого лимита вы достигли и что делать дальше.
Отказы
Регистрация и инструменты отвечают кодом. Коды регистрации приходят с HTTP-статусом:
| Код | HTTP-статус | Что это значит |
|---|---|---|
signup_blocked | 403 | Этой сети не разрешена регистрация. Владелец регистрируется сам. |
country_blocked | 403 | Notiamo недоступен в стране, из которой пришёл запрос. Владелец тоже не может зарегистрироваться оттуда. |
rate_limited | 429 | Слишком много запросов. Подождите retryAfter секунд. |
agent_signup_paused | 503 | Регистрация через агентов сейчас приостановлена. Владелец регистрируется сам. |
agent_signup_closed | 503 | Регистрация через агентов закрыта. Владелец регистрируется сам. |
account_exists | 409 | У этого e-mail уже есть аккаунт. Владелец входит и создаёт ключ в Настройки > ИИ-агенты > Токены агентов. |
email_not_accepted | 422 | Этот адрес e-mail использовать нельзя. Владелец регистрируется сам. |
invalid_input | 422 | Поле недопустимо. Его называет field. |
plan_limit | 402 | Достигнут лимит тарифа. Возвращается инструментами MCP вместе со следующим шагом (start_trial или get_payment_link). |
read_only | 403 | Этот ключ или приложение только для чтения: можно смотреть, но не менять. Возвращается инструментами MCP. |
permission_missing | 403 | Этому ключу или приложению это не разрешено. permission называет недостающую группу (или full). Возвращается инструментами MCP. |
Показывайте отказы владельцу. Никогда не обходите их.
Вход через Notiamo (OAuth)
Вместо ключа MCP-клиент, поддерживающий вход, может подключиться через OAuth. Метаданные сервера авторизации находятся по адресу https://my.notiamo.com/.well-known/oauth-authorization-server, а MCP-сервер отвечает 401 с заголовком WWW-Authenticate, который указывает на метаданные защищённого ресурса (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), называющие этот сервер, и предлагает scope notes replies status tasks. Клиенты регистрируются сами и используют PKCE (S256), без секрета клиента.
Ваш владелец входит, выбирает организацию, что вам разрешено менять (отмечено «Работа с отзывами») и проекты, и нажимает «Разрешить». Scope — это группы прав ниже. Владелец видит приложение в Настройки > ИИ-агенты > Подключённые приложения и может отключить его в любой момент.
Права
Для чтения права не нужны. Чтобы что-то менять, ключу или подключённому приложению нужна соответствующая группа:
notes replies status tasks setup invites billing moves
У «Только чтение» групп нет. У «Работа с отзывами» есть notes, replies, status и tasks. У «Полный» есть все; для приглашения членов команды нужен «Полный». Без группы инструмент отказывает с permission_missing и называет группу в permission; ключ только для чтения получает read_only. Покажите это владельцу: только он может дать больше доступа.
Оплата
list_plans показывает тарифы (цены смотрите на странице цен). start_trial запускает пробный период, один раз на человека. Цены
get_payment_link создаёт ссылку на оплату, которую владелец открывает и оплачивает. Вы никогда не работаете с данными карты.
Реферальный код
Если вас сюда привёл значок или ссылка Notiamo, передайте её код в поле referral в JSON-теле запроса регистрации. Вид ?via=<code> предназначен только для веб-ссылки регистрации, которую открывают люди.
Инструменты MCP
После подключения вы можете вызывать:
whoami list_projects find_project list_comments list_activity get_comment reply set_status assign list_team list_people get_account list_plans get_billing start_trial list_workspaces create_workspace create_project update_project_address update_project_language get_install get_badge check_install invite get_payment_link create_organization request_move get_move_request create_task update_task list_job_reports update_file request_approval