Notiamo dla agentów AI
Wszystko, czego agent AI potrzebuje, by otworzyć darmowe konto dla właściciela, umieścić widżet na stronie i obsłużyć komentarze oraz pracę, bez przeglądarki.
Przebieg
- Poproś o konto dla właściciela: wyślij
POST https://my.notiamo.com/api/agent/signupzemail,name,agent,localei, jeśli je masz,company,projectUrl(adres strony) orazreferral. Odpowiedź zawierarequestId,pollSecretipollAfterSeconds. - Powiedz właścicielowi, aby otworzył e-mail z potwierdzeniem, który wysyła Notiamo, i potwierdził. Dopóki tego nie zrobi, nic się nie dzieje.
- Odpytuj
GET https://my.notiamo.com/api/agent/signup/{requestId}zAuthorization: Bearer <pollSecret>copollAfterSecondssekund. Status topending,confirmed,expiredlubreported. - Gdy status to
confirmed, odpowiedź zawiera Twój klucz (token, zaczynający się odntm_) imcpUrl, jednorazowo. Zapisz klucz od razu: późniejsze odpytania go nie zwracają. Odbierz go w ciągu 7 dni od potwierdzenia. - Połącz się z serwerem MCP pod
https://my.notiamo.com/api/mcpz nagłówkiemAuthorization: Bearer ntm_…. Jeśli Twoja aplikacja obsługuje logowanie MCP, może użyć Sign in with Notiamo zamiast klucza (patrz niżej). - Wywołaj
list_projects(lubfind_project), aby znaleźć projekt utworzony dla Ciebie: używa już TwojegoprojectUrljako adresu. Jeśli adresu brakuje lub jest błędny, wywołajupdate_project_address. Potemget_install, zainstaluj fragment kodu icheck_install. Używajcreate_workspaceicreate_projecttylko wtedy, gdy plan ma miejsce (plany płatne lub okres próbny Studio);create_projectwymagaworkspaceIdzlist_workspaces. Przestrzeń robocza grupuje projekty, na przykład po jednym na klienta. Projekt może nie mieć adresu internetowego (pomińorigin): wtedy ma zadania, prace i nowości, ale nie ma widżetu. Po instalacjiget_badgedaje odznakę w stopce: małe logo Notiamo do stopki strony, które recenzentom otwiera narzędzia recenzji, a dla pozostałych jest zwykłym linkiem do Notiamo, w języku strony (update_project_languagealbolanguagewcreate_project). - Potem pracuj nad komentarzami:
list_comments,get_comment,replyiset_status. Aby sprawdzić nowości, przekażsincedolist_comments: czas UTC kończący się naZ(taki jak2026-10-17T08:00:00Z) albocursorz ostatniej odpowiedzi. Dostajesz tylko to, co się zmieniło, w jednym projekcie albo, bezprojectId, we wszystkich Twoich projektach. Zachowaj nowycursorna następne sprawdzenie, od razu obsłużmore: truei usuwaj duplikaty wedługid: pozycja może przyjść dwa razy. - Dla kolejnej organizacji wywołaj
create_organizationzname: właściciel zostaje jej administratorem i dostaje e-mail, a odpowiedź zawiera nowytokentylko dla tej organizacji. Jest bezpłatna, jeśli właściciel nie ma darmowej organizacji; w przeciwnym razie wymaga planu: wywołajget_payment_linkz nowym tokenem albostart_trialdla 14-dniowego okresu próbnego Studio (raz na osobę; właściciel otwiera link i podaje kartę). Jest dzienny limit; odmowa mówi, kiedy można spróbować ponownie. - Aby przenieść projekt do innej przestrzeni roboczej (
kindproject,projectId,toWorkspaceId) albo przestrzeń roboczą z jej projektami do innej organizacji, w której właściciel też jest administratorem (kindworkspace,workspaceId,toOrganizationId), wywołajrequest_move. Nic jeszcze się nie przenosi: właściciel dostaje e-mail i musi potwierdzić na stronie z linku, w ciągu 24 godzin. Wywołajget_move_request, aby poznać status:pending,done,cancelled,expiredlubfailed. - Aby dodać pracę niezwiązaną ze stroną, wywołaj
create_taskzprojectIdititle, a opcjonalnietextipageUrl. Aby zmienić jej treść, wywołajupdate_taskztaskIdi nowymtitle,textlub oboma. Oba liczą się do dziennego limitu nowych przestrzeni roboczych, projektów i zadań; odmowa mówi, kiedy go osiągniesz.list_commentspokazuje zadania oznaczone[Task]i przyjmujetype:tasklubcomment. - Raporty z zadań (Studio, Agency i okres próbny) to zadania, które klient wypełnia o wykonanej pracy: miejsce, data, klient końcowy i pliki według etapu (
before,during,after,other) z podpisami. Wywołajlist_job_reports(statereadywymienia te, które czekają na Ciebie), przeczytaj jeden przezget_commenti odpowiedz zrolearticlew jego języku. Zatwierdza tylko człowiek: daj mu link do zatwierdzenia albo wywołajrequest_approval. Po zatwierdzeniu odpowiedz zrolepostsifiles(identyfikatory plików do użycia).update_fileustawiaphaselubcaptionpliku;create_taskiupdate_taskprzyjmująjobReport. - Notatki głosowe i AI (Studio, Agency i okres próbny):
get_commentwymienia każde nagranie z linkiem do dźwięku i jego transkrypcją przez AI (oraz każdą późniejszą transkrypcję, nieopublikowaną), każde wideo dłuższe niż około 20 sekund z notatkami czasowymi (m:ss–m:ssco się dzieje) oraz podpisy AI oznaczone(AI, not checked), dopóki człowiek ich nie sprawdzi. Gdy AI nie mogło przetworzyć pliku, mówi o tym tymi samymi prostymi słowami, które widzą ludzie, z kodem odniesienia (AI-…) dla wsparcia.list_plansiget_billingpodają minuty głosu i AI miesięcznie.
Nie odpytuj szybciej niż pollAfterSeconds. Jeśli dostaniesz rate_limited, poczekaj retryAfter sekund. Błędny lub nieznany identyfikator albo sekret zwraca 404 z {"code":"not_found"}.
Jeśli twoja platforma podpisuje żądania przez Web Bot Auth (podpisy wiadomości HTTP, Signature-Agent z katalogiem kluczy) i Notiamo jej ufa, rejestracja i serwer MCP liczą cię według platformy, a nie adresu, z wyższymi limitami. Niepodpisane żądania działają jak wcześniej.
Przykład: poproś o konto
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"}'Plan darmowy
Plan darmowy pozwala na 1 przestrzeń roboczą, 1 projekt, 3 osoby (członkowie zespołu, członkowie klienta i oczekujące zaproszenia, każdy e-mail raz) i 1 publiczny adres na projekt. Po pierwszym publicznym komentarzu projektu adres można zmienić raz. Mieści 100 MB plików, 5 MB na plik; po przekroczeniu 100 MB administratorzy organizacji dostają dwa e-maile, potem najstarsze pliki są usuwane, a komentarze, zadania i odpowiedzi zostają. Przesyłanie może być odrzucane, by powstrzymać nadużycia. Wideo nie jest wliczone: wymaga Studio, Agency lub okresu próbnego. Przestrzeń robocza i projekt już istnieją, gdy konto się otwiera.
W planie darmowym widżet pokazuje plakietkę Notiamo.
Zachowaj linię komentarza nad znacznikiem script. Wymaga tego regulamin planu darmowego:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->Odmowa plan_limit mówi, jakiego limitu dotyczy i co zrobić dalej.
Odmowy
Rejestracja i narzędzia odpowiadają kodem. Kody rejestracji przychodzą ze statusem HTTP:
| Kod | Status HTTP | Co oznacza |
|---|---|---|
signup_blocked | 403 | Ta sieć nie może się rejestrować. Właściciel rejestruje się sam. |
country_blocked | 403 | Notiamo nie jest dostępne w kraju, z którego pochodzi żądanie. Właściciel też nie może się stamtąd zarejestrować. |
rate_limited | 429 | Zbyt wiele żądań. Poczekaj retryAfter sekund. |
agent_signup_paused | 503 | Rejestracja przez agentów jest na razie wstrzymana. Właściciel rejestruje się sam. |
agent_signup_closed | 503 | Rejestracja przez agentów jest zamknięta. Właściciel rejestruje się sam. |
account_exists | 409 | Ten e-mail ma już konto. Właściciel loguje się i tworzy klucz w Ustawienia > Agenci AI > Tokeny agentów. |
email_not_accepted | 422 | Tego adresu e-mail nie można użyć. Właściciel rejestruje się sam. |
invalid_input | 422 | Pole jest nieprawidłowe. Nazywa je field. |
plan_limit | 402 | Osiągnięto limit planu. Zwracane przez narzędzia MCP, z następnym krokiem (start_trial lub get_payment_link). |
read_only | 403 | Ten klucz lub ta aplikacja jest tylko do odczytu: może patrzeć, ale nie zmieniać. Zwracane przez narzędzia MCP. |
permission_missing | 403 | Ten klucz lub ta aplikacja nie może tego zrobić. permission nazywa brakującą grupę (lub full). Zwracane przez narzędzia MCP. |
Pokazuj odmowy swojemu właścicielowi. Nigdy ich nie obchodź.
Sign in with Notiamo (OAuth)
Zamiast klucza klient MCP, który obsługuje logowanie, może połączyć się przez OAuth. Metadane serwera autoryzacji są pod https://my.notiamo.com/.well-known/oauth-authorization-server, a serwer MCP odpowiada 401 z nagłówkiem WWW-Authenticate, który wskazuje metadane chronionego zasobu (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), nazywające ten serwer, i sugeruje zakres notes replies status tasks. Klienci rejestrują się sami i używają PKCE (S256), bez sekretu klienta.
Twój właściciel loguje się, wybiera organizację, co możesz zmieniać (Praca z opiniami jest zaznaczona) i projekty, i klika Zezwól. Zakresy to grupy uprawnień poniżej. Twój właściciel widzi aplikację w Ustawienia > Agenci AI > Połączone aplikacje i może ją odłączyć w każdej chwili.
Uprawnienia
Czytanie nie wymaga uprawnień. Aby coś zmienić, klucz lub połączona aplikacja potrzebuje odpowiedniej grupy:
notes replies status tasks setup invites billing moves
Tylko odczyt nie ma grupy. Praca z opiniami ma notes, replies, status i tasks. Pełny ma wszystkie; zapraszanie członków zespołu wymaga Pełny. Bez grupy narzędzie odmawia z permission_missing i nazywa grupę w permission; klucz tylko do odczytu dostaje read_only. Pokaż to swojemu właścicielowi: tylko on może dać więcej dostępu.
Płatność
list_plans pokazuje plany (ceny na stronie z cennikiem). start_trial rozpoczyna okres próbny, raz na osobę. Cennik
get_payment_link tworzy link do płatności, który właściciel otwiera i płaci. Nigdy nie obsługujesz danych karty.
Polecenie
Jeśli trafiłeś tu przez plakietkę lub link Notiamo, przekaż jego kod w polu referral ciała JSON rejestracji. Forma ?via=<code> jest tylko dla linku do rejestracji, który otwierają ludzie.
Narzędzia MCP
Po połączeniu możesz wywołać:
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