面向 AI 代理的 Notiamo
AI 代理为其所有者开通免费账号、把小组件放到网站上、处理评论和工作所需的一切,无需浏览器。
流程
- 为你的所有者申请账号:发送
POST https://my.notiamo.com/api/agent/signup,包含email、name、agent、locale,以及(如果有)company、projectUrl(网站地址)和referral。响应包含requestId、pollSecret和pollAfterSeconds。 - 告诉所有者打开 Notiamo 发送的确认邮件并确认。在他们确认之前什么都不会发生。
- 每隔
pollAfterSeconds秒,用Authorization: Bearer <pollSecret>轮询GET https://my.notiamo.com/api/agent/signup/{requestId}。状态为pending、confirmed、expired或reported。 - 当状态为
confirmed时,响应会一次性包含你的密钥(token,以ntm_开头)和mcpUrl。请立即保存密钥:之后的轮询不会再返回它。请在确认后 7 天内领取。 - 使用请求头
Authorization: Bearer ntm_…连接到https://my.notiamo.com/api/mcp的 MCP 服务器。如果你的应用支持 MCP 登录,可以改用“使用 Notiamo 登录”而不是密钥(见下文)。 - 调用
list_projects(或find_project)找到为你创建的项目:它已经使用你的projectUrl作为地址。如果地址缺失或有误,调用update_project_address。然后调用get_install,安装代码片段,再调用check_install。只有在套餐还有空间时(付费套餐或 Studio 试用)才使用create_workspace和create_project;create_project需要来自list_workspaces的workspaceId。工作区用来把项目分组,例如每个客户一个。项目可以没有网址(省略origin):这时它有任务、工作和动态,但没有小组件。 安装完成后,get_badge会给出页脚徽标:放在网站页脚的小型 Notiamo 标志,审阅者点击可打开审阅工具,其他人则看到指向 Notiamo 的普通链接,使用网站的语言(update_project_language,或create_project的language)。 - 然后处理评论:
list_comments、get_comment、reply和set_status。要检查新动态,请向list_comments传入since:以Z结尾的 UTC 时间(例如2026-10-17T08:00:00Z),或上一次响应中的cursor。你只会得到有变化的内容,范围是某个项目,或者在不带projectId时是你所有的项目。保存新的cursor用于下次检查,遇到more: true时立即继续获取,并按id去重:同一项可能出现两次。 - 要创建另一个组织,请带上
name调用create_organization:所有者成为其管理员并收到一封邮件,响应中包含仅用于该组织的新token。如果所有者还没有免费组织,它就是免费的;否则需要套餐:用新令牌调用get_payment_link,或调用start_trial开始 14 天的 Studio 试用(每人一次;所有者打开链接并填写银行卡)。每天有次数上限;拒绝信息会说明何时可以重试。 - 要把项目移到另一个工作区(
kind为project,projectId,toWorkspaceId),或把工作区及其项目移到所有者同样担任管理员的另一个组织(kind为workspace,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(state为ready会列出等待你处理的),用get_comment读取其中一份,并以role为article的回复用其语言撰写文章。只有人才能批准:把批准链接交给他们,或调用request_approval。批准之后,用role为posts和files(要使用的文件的 id)进行回复。update_file设置文件的phase或caption;create_task和update_task接受jobReport。 - 语音备注和 AI(Studio、Agency 和试用):
get_comment会列出每段录音及其音频链接和 AI 转写文字(以及之后的任何转写,不会发布)、每个超过约 20 秒的视频及其时间备注(m:ss–m:ss发生了什么),以及标记为(AI, not checked)的 AI 说明文字,直到有人核对。当 AI 无法处理某个文件时,它会用人们看到的同样通俗的话说明,并附上供支持使用的参考代码(AI-…)。list_plans和get_billing会给出每月的语音和 AI 分钟数。
轮询的频率不要快于 pollAfterSeconds。如果收到 rate_limited,请等待 retryAfter 秒。错误或未知的 id 或密钥会返回 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 个人(团队成员、客户成员和待处理的邀请,每个邮箱只计一次)以及每个项目 1 个公开地址。在项目收到第一条公开评论之后,地址可以更改一次。它可存放 100 MB 文件,每个文件 5 MB;超过 100 MB 时组织管理员会收到两封邮件,然后最旧的文件会被删除,而评论、任务和回复会保留。为防止滥用,上传可能会被拒绝。不包含视频:它需要 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 | 这个邮箱已经有账号。所有者登录后,在“设置 > AI 代理 > 代理令牌”中创建密钥。 |
email_not_accepted | 422 | 这个邮箱地址无法使用。所有者自己注册。 |
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),其中写明了这台服务器,并建议使用范围 notes replies status tasks。客户端自行注册并使用 PKCE(S256),没有客户端密钥。
你的所有者登录,选择组织、你可以更改的内容(默认勾选“处理反馈”)和项目,然后点击“允许”。这些范围就是下面的权限分组。你的所有者可以在“设置 > AI 代理 > 已连接的应用”中看到这个应用,并可随时断开连接。
权限
读取不需要权限。要更改内容,密钥或已连接的应用需要对应的分组:
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 徽标或链接来到这里的,请把它的代码放在注册 JSON 正文的 referral 字段中。?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