Notiamo

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

  1. Beantragen Sie ein Konto für Ihren Besitzer: Senden Sie POST https://my.notiamo.com/api/agent/signup mit email, name, agent, locale und, falls vorhanden, company, projectUrl (die Adresse der Website) und referral. Die Antwort enthält requestId, pollSecret und pollAfterSeconds.
  2. Bitten Sie den Besitzer, die Bestätigungs-E-Mail von Notiamo zu öffnen und zu bestätigen. Bis dahin passiert nichts.
  3. Fragen Sie GET https://my.notiamo.com/api/agent/signup/{requestId} mit Authorization: Bearer <pollSecret> alle pollAfterSeconds Sekunden ab. Der Status ist pending, confirmed, expired oder reported.
  4. Ist der Status confirmed, enthält die Antwort einmalig Ihren Schlüssel (token, beginnt mit ntm_) und mcpUrl. 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.
  5. Verbinden Sie sich mit dem MCP-Server unter https://my.notiamo.com/api/mcp mit dem Header Authorization: Bearer ntm_…. Unterstützt Ihre App die MCP-Anmeldung, kann sie statt eines Schlüssels „Mit Notiamo anmelden“ nutzen (siehe unten).
  6. Rufen Sie list_projects (oder find_project) auf, um das für Sie angelegte Projekt zu finden: Es verwendet bereits Ihre projectUrl als Adresse. Fehlt die Adresse oder ist sie falsch, rufen Sie update_project_address auf. Danach get_install, das Snippet einbauen und check_install. Nutzen Sie create_workspace und create_project nur, wenn der Tarif noch Platz hat (bezahlte Tarife oder die Studio-Testphase); create_project braucht eine workspaceId aus list_workspaces. Ein Arbeitsbereich fasst Projekte zusammen, zum Beispiel einer pro Kunde. Ein Projekt kann ohne Webadresse sein (origin weglassen): Dann hat es Aufgaben, Referenzen und Neuigkeiten, aber kein Widget. Nach der Installation liefert get_badge das 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, oder language bei create_project).
  7. Bearbeiten Sie danach die Kommentare: list_comments, get_comment, reply und set_status. Um nach Neuem zu sehen, geben Sie list_comments den Parameter since: eine UTC-Zeit mit Z am Ende (etwa 2026-10-17T08:00:00Z) oder den cursor aus der letzten Antwort. Sie erhalten nur, was sich geändert hat, in einem Projekt oder, ohne projectId, in allen Ihren Projekten. Bewahren Sie den neuen cursor für die nächste Prüfung auf, folgen Sie more: true sofort und entfernen Sie Doppelte anhand der id: Ein Eintrag kann zweimal kommen.
  8. Für eine weitere Organisation rufen Sie create_organization mit einem name auf: Der Inhaber wird ihr Admin und erhält eine E-Mail, und die Antwort enthält ein neues token nur für diese Organisation. Sie ist kostenlos, wenn der Inhaber keine kostenlose Organisation hat, sonst braucht sie einen Tarif: Rufen Sie get_payment_link mit dem neuen Token auf, oder start_trial fü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.
  9. Um ein Projekt in einen anderen Arbeitsbereich (kind project, projectId, toWorkspaceId) oder einen Arbeitsbereich mit seinen Projekten in eine andere Organisation zu verschieben, in der der Besitzer ebenfalls Admin ist (kind workspace, workspaceId, toOrganizationId), rufen Sie request_move auf. Noch wird nichts verschoben: Der Besitzer erhält eine E-Mail und muss innerhalb von 24 Stunden auf der verlinkten Seite bestätigen. Rufen Sie get_move_request für den Status auf: pending, done, cancelled, expired oder failed.
  10. Um Arbeit ohne Seitenbezug hinzuzufügen, rufen Sie create_task mit einer projectId und einem title auf, optional mit text und pageUrl. Um den Wortlaut zu ändern, rufen Sie update_task mit der taskId und einem neuen title, text oder beidem auf. Beides zählt zu einem Tageslimit für neue Arbeitsbereiche, Projekte und Aufgaben; die Ablehnung sagt Ihnen, wann es erreicht ist. list_comments zeigt Aufgaben mit der Markierung [Task] und nimmt type an: task oder comment.
  11. 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 Sie list_job_reports auf (state ready listet die, die auf Sie warten), lesen Sie einen mit get_comment und antworten Sie mit role article in seiner Sprache. Nur ein Mensch gibt frei: Geben Sie ihm den Freigabelink oder rufen Sie request_approval auf. Nach der Freigabe antworten Sie mit role posts und files (die IDs der zu verwendenden Dateien). update_file setzt phase oder caption einer Datei; create_task und update_task nehmen jobReport an.
  12. Sprachnotizen und KI (Studio, Agency und die Testphase): get_comment listet 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:ss was 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_plans und get_billing nennen 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:

CodeHTTP-StatusBedeutung
signup_blocked403Das Netzwerk darf sich nicht registrieren. Der Besitzer registriert sich selbst.
country_blocked403Notiamo ist in dem Land, aus dem die Anfrage kommt, nicht verfügbar. Auch der Inhaber kann sich von dort nicht registrieren.
rate_limited429Zu viele Anfragen. Warten Sie retryAfter Sekunden.
agent_signup_paused503Die Registrierung durch Agenten ist vorerst pausiert. Der Besitzer registriert sich selbst.
agent_signup_closed503Die Registrierung durch Agenten ist geschlossen. Der Besitzer registriert sich selbst.
account_exists409Diese E-Mail hat bereits ein Konto. Der Besitzer meldet sich an und erstellt unter Einstellungen > KI-Agenten > Agent-Tokens einen Schlüssel.
email_not_accepted422Diese E-Mail-Adresse kann nicht verwendet werden. Der Besitzer registriert sich selbst.
invalid_input422Ein Feld ist ungültig. field nennt es.
plan_limit402Eine Tarifgrenze ist erreicht. Wird von den MCP-Tools zurückgegeben, mit dem nächsten Schritt (start_trial oder get_payment_link).
read_only403Dieser Schlüssel oder diese App kann nur lesen: ansehen ja, ändern nein. Wird von den MCP-Tools zurückgegeben.
permission_missing403Dieser 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

Mehr