Notiamo voor AI-agents
Alles wat een AI-agent nodig heeft om een gratis account voor zijn eigenaar te openen, de widget op een website te zetten en de reacties en het werk af te handelen, zonder browser.
De werkwijze
- Vraag een account aan voor je eigenaar: stuur
POST https://my.notiamo.com/api/agent/signupmetemail,name,agent,localeen, als je ze hebt,company,projectUrl(het adres van de website) enreferral. Het antwoord bevatrequestId,pollSecretenpollAfterSeconds. - Vraag de eigenaar de bevestigingsmail te openen die Notiamo stuurt en te bevestigen. Er gebeurt niets totdat hij dat doet.
- Vraag
GET https://my.notiamo.com/api/agent/signup/{requestId}op metAuthorization: Bearer <pollSecret>elkepollAfterSecondsseconden. De status ispending,confirmed,expiredofreported. - Als de status
confirmedis, bevat het antwoord eenmalig je sleutel (token, beginnend metntm_) enmcpUrl. Bewaar de sleutel meteen: latere verzoeken geven hem niet meer terug. Haal hem binnen 7 dagen na de bevestiging op. - Maak verbinding met de MCP-server op
https://my.notiamo.com/api/mcpmet de headerAuthorization: Bearer ntm_…. Ondersteunt je app MCP-inloggen, dan kan hij in plaats van een sleutel Inloggen met Notiamo gebruiken (zie hieronder). - Roep
list_projects(offind_project) aan om het project te vinden dat voor je is gemaakt: het gebruikt jeprojectUrlal als adres. Ontbreekt het adres of klopt het niet, roep danupdate_project_addressaan. Daarnaget_install, installeer het snippet encheck_install. Gebruikcreate_workspaceencreate_projectalleen als het abonnement ruimte heeft (betaalde abonnementen of de Studio-proefperiode);create_projectheeft eenworkspaceIduitlist_workspacesnodig. Een werkruimte groepeert projecten, bijvoorbeeld één per klant. Een project mag geen webadres hebben (laatoriginweg): dan heeft het taken, werk en nieuws, maar geen widget. Na de installatie geeftget_badgede footerbadge: een klein Notiamo-logo voor de footer van de site, dat voor reviewers de reviewtools opent en voor alle anderen een gewone link naar Notiamo is, in de taal van de site (update_project_language, oflanguagebijcreate_project). - Werk daarna aan de reacties:
list_comments,get_comment,replyenset_status. Om op nieuws te controleren geef jesincemee aanlist_comments: een UTC-tijd die opZeindigt (zoals2026-10-17T08:00:00Z), of decursoruit het laatste antwoord. Je krijgt alleen wat er veranderd is, voor één project of, zonderprojectId, voor al je projecten. Bewaar de nieuwecursorvoor de volgende controle, volgmore: truemeteen en ontdubbel opid: een item kan twee keer komen. - Voor een andere organisatie roep je
create_organizationaan met eenname: de eigenaar wordt de beheerder en krijgt een e-mail, en het antwoord bevat een nieuwtokenvoor alleen die organisatie. Ze is gratis als de eigenaar geen gratis organisatie heeft, anders is een abonnement nodig: roepget_payment_linkaan met het nieuwe token, ofstart_trialvoor de Studio-proefperiode van 14 dagen (één keer per persoon; de eigenaar opent de link en voert een kaart in). Er is een daglimiet; de weigering zegt wanneer je het opnieuw kunt proberen. - Om een project naar een andere werkruimte te verplaatsen (
kindproject,projectId,toWorkspaceId), of een werkruimte met haar projecten naar een andere organisatie waar de eigenaar ook beheerder is (kindworkspace,workspaceId,toOrganizationId), roep jerequest_moveaan. Er verplaatst nog niets: de eigenaar krijgt een e-mail en moet binnen 24 uur bevestigen op de pagina waarnaar die linkt. Roepget_move_requestaan voor de status:pending,done,cancelled,expiredoffailed. - Om werk toe te voegen dat niet aan een pagina is gebonden, roep je
create_taskaan met eenprojectIden eentitle, en eventueeltextenpageUrl. Om de tekst te wijzigen, roep jeupdate_taskaan met detaskIden een nieuwetitle,textof beide. Beide tellen mee voor een dagelijkse limiet op nieuwe werkruimtes, projecten en taken; de weigering vertelt je wanneer je die bereikt.list_commentstoont taken met de markering[Task]en neemttype:taskofcomment. - Jobrapporten (Studio, Agency en de proefperiode) zijn taken die een klant invult over een afgeronde klus: plaats, datum, eindklant en bestanden per fase (
before,during,after,other) met bijschriften. Roeplist_job_reportsaan (statereadytoont de rapporten die op je wachten), lees er een metget_commenten antwoord metrolearticlein zijn taal. Alleen een mens keurt goed: geef hem de goedkeuringslink of roeprequest_approvalaan. Antwoord na goedkeuring metrolepostsenfiles(de id's van de te gebruiken bestanden).update_filestelt dephaseofcaptionvan een bestand in;create_taskenupdate_tasknemenjobReport. - Spraaknotities en AI (Studio, Agency en de proefperiode):
get_commenttoont elke opname met een link naar de audio en de transcriptie door AI (en elke latere transcriptie, niet geplaatst), elke video van meer dan ongeveer 20 seconden met tijdnotities (m:ss–m:sswat er gebeurt), en AI-bijschriften gemarkeerd met(AI, not checked)totdat een mens ze controleert. Kon AI een bestand niet verwerken, dan zegt het dat in dezelfde duidelijke woorden die mensen zien, met een referentiecode (AI-…) voor support.list_plansenget_billinggeven de spraak- en AI-minuten per maand.
Vraag niet vaker op dan pollAfterSeconds. Krijg je rate_limited, wacht dan retryAfter seconden. Een onjuiste of onbekende id of geheim geeft 404 met {"code":"not_found"}.
Als je platform zijn verzoeken ondertekent met Web Bot Auth (HTTP-berichthandtekeningen, een Signature-Agent met een sleutelmap) en Notiamo het vertrouwt, tellen aanmelden en de MCP-server je per platform in plaats van per adres, met hogere limieten. Niet-ondertekende verzoeken werken zoals eerst.
Voorbeeld: een account aanvragen
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"}'Het gratis abonnement
Het gratis abonnement staat 1 werkruimte, 1 project, 3 mensen (teamleden, klantleden en openstaande uitnodigingen, elk e-mailadres één keer) en 1 openbaar adres per project toe. Na de eerste openbare reactie op het project kan het adres één keer worden gewijzigd. Het bevat 100 MB aan bestanden, 5 MB per bestand; boven 100 MB krijgen de beheerders van de organisatie twee e-mails, daarna worden de oudste bestanden verwijderd, en reacties, taken en antwoorden blijven staan. Uploads kunnen worden geweigerd om misbruik te voorkomen. Video zit er niet bij: daarvoor is Studio, Agency of de proefperiode nodig. Een werkruimte en een project bestaan al wanneer het account wordt geopend.
De widget toont in het gratis abonnement een Notiamo-badge.
Laat de commentaarregel boven de script-tag staan. De voorwaarden van het gratis abonnement eisen dat:
<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->Een weigering met plan_limit vertelt je welke limiet je hebt bereikt en wat je daarna moet doen.
Weigeringen
Aanmelden en de tools antwoorden met een code. De codes bij het aanmelden komen met een HTTP-status:
| Code | HTTP-status | Wat het betekent |
|---|---|---|
signup_blocked | 403 | Het netwerk mag zich niet aanmelden. De eigenaar meldt zich zelf aan. |
country_blocked | 403 | Notiamo is niet beschikbaar in het land waar het verzoek vandaan komt. De eigenaar kan zich daar ook niet aanmelden. |
rate_limited | 429 | Te veel verzoeken. Wacht retryAfter seconden. |
agent_signup_paused | 503 | Aanmelden door agents is voorlopig gepauzeerd. De eigenaar meldt zich zelf aan. |
agent_signup_closed | 503 | Aanmelden door agents is gesloten. De eigenaar meldt zich zelf aan. |
account_exists | 409 | Dit e-mailadres heeft al een account. De eigenaar logt in en maakt een sleutel aan bij Instellingen > AI-agents > Agenttokens. |
email_not_accepted | 422 | Dit e-mailadres kan niet worden gebruikt. De eigenaar meldt zich zelf aan. |
invalid_input | 422 | Een veld is niet geldig. field noemt het. |
plan_limit | 402 | Een abonnementslimiet is bereikt. Teruggegeven door de MCP-tools, met de volgende stap (start_trial of get_payment_link). |
read_only | 403 | Deze sleutel of app is alleen-lezen: hij kan kijken maar niet wijzigen. Teruggegeven door de MCP-tools. |
permission_missing | 403 | Deze sleutel of app mag dit niet doen. permission noemt de ontbrekende groep (of full). Teruggegeven door de MCP-tools. |
Toon weigeringen aan je eigenaar. Omzeil ze nooit.
Inloggen met Notiamo (OAuth)
In plaats van een sleutel kan een MCP-client die inloggen ondersteunt verbinden met OAuth. De metadata van de autorisatieserver staat op https://my.notiamo.com/.well-known/oauth-authorization-server, en de MCP-server antwoordt met 401 en een WWW-Authenticate-header die naar de metadata van zijn beschermde bron wijst (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), die deze server noemt, en stelt de scope notes replies status tasks voor. Clients registreren zichzelf en gebruiken PKCE (S256), zonder client secret.
Je eigenaar logt in, kiest de organisatie, wat je mag wijzigen (Aan feedback werken is aangevinkt) en de projecten, en klikt op Toestaan. De scopes zijn de rechtengroepen hieronder. Je eigenaar ziet de app bij Instellingen > AI-agents > Gekoppelde apps en kan hem op elk moment loskoppelen.
Rechten
Lezen vraagt geen recht. Om iets te wijzigen heeft een sleutel of gekoppelde app de bijbehorende groep nodig:
notes replies status tasks setup invites billing moves
Alleen-lezen heeft geen groep. Aan feedback werken heeft notes, replies, status en tasks. Volledig heeft ze allemaal; teamleden uitnodigen vraagt Volledig. Zonder de groep weigert de tool met permission_missing en noemt de groep in permission; een alleen-lezen sleutel krijgt read_only. Toon het aan je eigenaar: alleen hij kan meer toegang geven.
Betalen
list_plans toont de abonnementen (zie de prijzenpagina voor de prijzen). start_trial start de proefperiode, één keer per persoon. Prijzen
get_payment_link maakt een betaallink die de eigenaar opent en waarmee hij betaalt. Je krijgt nooit kaartgegevens te zien.
Verwijzing
Als een Notiamo-badge of -link je hier bracht, geef dan de code ervan mee in het veld referral van de JSON-body van de aanmelding. De vorm ?via=<code> is alleen voor de aanmeldlink die mensen openen.
De MCP-tools
Na het verbinden kun je aanroepen:
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