Notiamo für KI-Agenten
Alles, was ein KI-Agent braucht, um für seinen Besitzer ein kostenloses Konto zu eröffnen, das Widget auf einer Website einzubauen und die Kommentare und die Arbeit zu bearbeiten, ganz ohne Browser.
Der Ablauf
- Beantragen Sie ein Konto für Ihren Besitzer: Senden Sie
POST https://my.notiamo.com/api/agent/signupmitemail,name,agent,localeund, falls vorhanden,company,projectUrl(die Adresse der Website) undreferral. Die Antwort enthältrequestId,pollSecretundpollAfterSeconds. - Bitten Sie den Besitzer, die Bestätigungs-E-Mail von Notiamo zu öffnen und zu bestätigen. Bis dahin passiert nichts.
- Fragen Sie
GET https://my.notiamo.com/api/agent/signup/{requestId}mitAuthorization: Bearer <pollSecret>allepollAfterSecondsSekunden ab. Der Status istpending,confirmed,expiredoderreported. - Ist der Status
confirmed, enthält die Antwort einmalig Ihren Schlüssel (token, beginnt mitntm_) undmcpUrl. Speichern Sie den Schlüssel sofort: Spätere Abfragen liefern ihn nicht mehr. Holen Sie ihn innerhalb von 7 Tagen nach der Bestätigung ab. - Verbinden Sie sich mit dem MCP-Server unter
https://my.notiamo.com/api/mcpmit dem HeaderAuthorization: Bearer ntm_…. Unterstützt Ihre App die MCP-Anmeldung, kann sie statt eines Schlüssels „Mit Notiamo anmelden“ nutzen (siehe unten). - Rufen Sie
list_projects(oderfind_project) auf, um das für Sie angelegte Projekt zu finden: Es verwendet bereits IhreprojectUrlals Adresse. Fehlt die Adresse oder ist sie falsch, rufen Sieupdate_project_addressauf. Danachget_install, das Snippet einbauen undcheck_install. Nutzen Siecreate_workspaceundcreate_projectnur, wenn der Tarif noch Platz hat (bezahlte Tarife oder die Studio-Testphase);create_projectbraucht eineworkspaceIdauslist_workspaces. Ein Arbeitsbereich fasst Projekte zusammen, zum Beispiel einer pro Kunde. Ein Projekt kann ohne Webadresse sein (originweglassen): Dann hat es Aufgaben, Referenzen und Neuigkeiten, aber kein Widget. Nach der Installation liefertget_badgedas Footer-Badge: ein kleines Notiamo-Logo für die Fußzeile der Website, das Reviewern die Review-Werkzeuge öffnet und für alle anderen ein einfacher Link zu Notiamo ist, in der Sprache der Website (update_project_language, oderlanguagebeicreate_project). - Bearbeiten Sie danach die Kommentare:
list_comments,get_comment,replyundset_status. Um nach Neuem zu sehen, geben Sielist_commentsden Parametersince: eine UTC-Zeit mitZam Ende (etwa2026-10-17T08:00:00Z) oder dencursoraus der letzten Antwort. Sie erhalten nur, was sich geändert hat, in einem Projekt oder, ohneprojectId, in allen Ihren Projekten. Bewahren Sie den neuencursorfür die nächste Prüfung auf, folgen Siemore: truesofort und entfernen Sie Doppelte anhand derid: Ein Eintrag kann zweimal kommen. - Für eine weitere Organisation rufen Sie
create_organizationmit einemnameauf: Der Inhaber wird ihr Admin und erhält eine E-Mail, und die Antwort enthält ein neuestokennur für diese Organisation. Sie ist kostenlos, wenn der Inhaber keine kostenlose Organisation hat, sonst braucht sie einen Tarif: Rufen Sieget_payment_linkmit dem neuen Token auf, oderstart_trialfür die 14-tägige Studio-Testphase (einmal pro Person; der Inhaber öffnet den Link und gibt eine Karte ein). Es gibt ein Tageslimit; die Ablehnung sagt, wann Sie es erneut versuchen können. - Um ein Projekt in einen anderen Arbeitsbereich (
kindproject,projectId,toWorkspaceId) oder einen Arbeitsbereich mit seinen Projekten in eine andere Organisation zu verschieben, in der der Besitzer ebenfalls Admin ist (kindworkspace,workspaceId,toOrganizationId), rufen Sierequest_moveauf. Noch wird nichts verschoben: Der Besitzer erhält eine E-Mail und muss innerhalb von 24 Stunden auf der verlinkten Seite bestätigen. Rufen Sieget_move_requestfür den Status auf:pending,done,cancelled,expiredoderfailed. - Um Arbeit ohne Seitenbezug hinzuzufügen, rufen Sie
create_taskmit einerprojectIdund einemtitleauf, optional mittextundpageUrl. Um den Wortlaut zu ändern, rufen Sieupdate_taskmit dertaskIdund einem neuentitle,textoder beidem auf. Beides zählt zu einem Tageslimit für neue Arbeitsbereiche, Projekte und Aufgaben; die Ablehnung sagt Ihnen, wann es erreicht ist.list_commentszeigt Aufgaben mit der Markierung[Task]und nimmttypean:taskodercomment. - Auftragsberichte (Studio, Agency und die Testphase) sind Aufgaben, die ein Kunde zu einem abgeschlossenen Auftrag ausfüllt: Ort, Datum, Endkunde und Dateien nach Phase (
before,during,after,other) mit Bildunterschriften. Rufen Sielist_job_reportsauf (statereadylistet die, die auf Sie warten), lesen Sie einen mitget_commentund antworten Sie mitrolearticlein seiner Sprache. Nur ein Mensch gibt frei: Geben Sie ihm den Freigabelink oder rufen Sierequest_approvalauf. Nach der Freigabe antworten Sie mitrolepostsundfiles(die IDs der zu verwendenden Dateien).update_filesetztphaseodercaptioneiner Datei;create_taskundupdate_tasknehmenjobReportan. - Sprachnotizen und KI (Studio, Agency und die Testphase):
get_commentlistet jede Aufnahme mit einem Link zum Audio und ihrem KI-Transkript (und jedes spätere, nicht veröffentlichte Transkript), jedes Video über etwa 20 Sekunden mit Zeitmarken (m:ss–m:sswas passiert) und KI-Bildunterschriften, markiert mit(AI, not checked), bis eine Person sie prüft. Konnte die KI eine Datei nicht verarbeiten, sagt es das mit denselben einfachen Worten, die Menschen sehen, mit einem Referenzcode (AI-…) für den Support.list_plansundget_billingnennen die Sprach- und KI-Minuten pro Monat.
Fragen Sie nicht öfter als alle pollAfterSeconds Sekunden ab. Bei rate_limited warten Sie retryAfter Sekunden. Eine falsche oder unbekannte ID oder ein falsches Geheimnis ergibt 404 mit {"code":"not_found"}.
Wenn deine Plattform ihre Anfragen mit Web Bot Auth signiert (HTTP-Nachrichtensignaturen, ein Signature-Agent mit Schlüsselverzeichnis) und Notiamo ihr vertraut, zählen Registrierung und MCP-Server dich nach Plattform statt nach Adresse, mit höheren Limits. Unsignierte Anfragen funktionieren wie bisher.
Beispiel: ein Konto beantragen
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"}'Der kostenlose Tarif
Der kostenlose Tarif erlaubt 1 Arbeitsbereich, 1 Projekt, 3 Personen (Teammitglieder, Kundenmitglieder und offene Einladungen, jede E-Mail einmal gezählt) und 1 öffentliche Adresse pro Projekt. Nach dem ersten öffentlichen Kommentar des Projekts kann die Adresse einmal geändert werden. Er fasst 100 MB Dateien, 5 MB pro Datei; über 100 MB erhalten die Admins der Organisation zwei E-Mails, danach werden die ältesten Dateien entfernt, und Kommentare, Aufgaben und Antworten bleiben erhalten. Uploads können zum Schutz vor Missbrauch abgelehnt werden. Video ist nicht enthalten: Dafür braucht es Studio, Agency oder die Testphase. Ein Arbeitsbereich und ein Projekt existieren bereits, wenn das Konto eröffnet wird.
Im kostenlosen Tarif zeigt das Widget ein Notiamo-Badge an.
Behalten Sie die Kommentarzeile über dem Script-Tag bei. Die Bedingungen des kostenlosen Tarifs verlangen das:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->Eine plan_limit-Ablehnung nennt die erreichte Grenze und den nächsten Schritt.
Ablehnungen
Registrierung und Tools antworten mit einem Code. Die Registrierungscodes kommen mit einem HTTP-Status:
| Code | HTTP-Status | Bedeutung |
|---|---|---|
signup_blocked | 403 | Das Netzwerk darf sich nicht registrieren. Der Besitzer registriert sich selbst. |
country_blocked | 403 | Notiamo ist in dem Land, aus dem die Anfrage kommt, nicht verfügbar. Auch der Inhaber kann sich von dort nicht registrieren. |
rate_limited | 429 | Zu viele Anfragen. Warten Sie retryAfter Sekunden. |
agent_signup_paused | 503 | Die Registrierung durch Agenten ist vorerst pausiert. Der Besitzer registriert sich selbst. |
agent_signup_closed | 503 | Die Registrierung durch Agenten ist geschlossen. Der Besitzer registriert sich selbst. |
account_exists | 409 | Diese E-Mail hat bereits ein Konto. Der Besitzer meldet sich an und erstellt unter Einstellungen > KI-Agenten > Agent-Tokens einen Schlüssel. |
email_not_accepted | 422 | Diese E-Mail-Adresse kann nicht verwendet werden. Der Besitzer registriert sich selbst. |
invalid_input | 422 | Ein Feld ist ungültig. field nennt es. |
plan_limit | 402 | Eine Tarifgrenze ist erreicht. Wird von den MCP-Tools zurückgegeben, mit dem nächsten Schritt (start_trial oder get_payment_link). |
read_only | 403 | Dieser Schlüssel oder diese App kann nur lesen: ansehen ja, ändern nein. Wird von den MCP-Tools zurückgegeben. |
permission_missing | 403 | Dieser Schlüssel oder diese App darf das nicht. permission nennt die fehlende Gruppe (oder full). Wird von den MCP-Tools zurückgegeben. |
Zeigen Sie Ablehnungen Ihrem Besitzer. Umgehen Sie sie niemals.
Mit Notiamo anmelden (OAuth)
Statt mit einem Schlüssel kann sich ein MCP-Client, der die Anmeldung unterstützt, per OAuth verbinden. Die Metadaten des Autorisierungsservers liegen unter https://my.notiamo.com/.well-known/oauth-authorization-server, und der MCP-Server antwortet mit 401 und einem WWW-Authenticate-Header, der auf die Metadaten seiner geschützten Ressource verweist (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728); diese nennen diesen Server. Der Header schlägt den Scope notes replies status tasks vor. Clients registrieren sich selbst und nutzen PKCE (S256), ohne Client-Secret.
Ihr Besitzer meldet sich an, wählt die Organisation, was Sie ändern dürfen (Mit Feedback arbeiten ist angehakt) und die Projekte und klickt auf Erlauben. Die Scopes sind die Berechtigungsgruppen unten. Ihr Besitzer sieht die App unter Einstellungen > KI-Agenten > Verbundene Apps und kann sie jederzeit trennen.
Berechtigungen
Lesen braucht keine Berechtigung. Um etwas zu ändern, braucht ein Schlüssel oder eine verbundene App die passende Gruppe:
notes replies status tasks setup invites billing moves
Nur lesen hat keine Gruppe. Mit Feedback arbeiten hat notes, replies, status und tasks. Voll hat alle; Teammitglieder einzuladen braucht Voll. Ohne die Gruppe lehnt das Tool mit permission_missing ab und nennt die Gruppe in permission; ein Schlüssel mit Nur lesen erhält read_only. Zeigen Sie es Ihrem Besitzer: Nur er kann mehr Zugriff geben.
Bezahlen
list_plans zeigt die Tarife (die Preise stehen auf der Preisseite). start_trial startet die Testphase, einmal pro Person. Preise
get_payment_link erzeugt einen Zahlungslink, den der Besitzer öffnet und bezahlt. Sie verarbeiten nie Kartendaten.
Empfehlung
Wenn ein Notiamo-Badge oder -Link Sie hierher geführt hat, geben Sie seinen Code im Feld referral des JSON-Bodys der Registrierung an. Die Form ?via=<code> gilt nur für den Registrierungslink im Web, den Menschen öffnen.
Die MCP-Tools
Nach der Verbindung können Sie aufrufen:
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