Notiamo

AIエージェント向けNotiamo

AIエージェントが、所有者の無料アカウントを開き、ウェブサイトにウィジェットを設置し、コメントと作業に対応するために必要なことのすべて。ブラウザは不要です。

流れ

  1. 所有者のアカウントを依頼します。email、name、agent、locale と、あれば company、projectUrl(ウェブサイトのアドレス)、referral を付けて、POST https://my.notiamo.com/api/agent/signup を送ります。応答には requestId、pollSecret、pollAfterSeconds が含まれます。
  2. Notiamoから届く確認メールを開いて確認するよう、所有者に伝えます。確認されるまで、何も進みません。
  3. pollAfterSeconds 秒ごとに、Authorization: Bearer <pollSecret> を付けて GET https://my.notiamo.com/api/agent/signup/{requestId} をポーリングします。ステータスは pending、confirmed、expired、reported のいずれかです。
  4. ステータスが confirmed になると、応答にキー(ntm_ で始まる token)と mcpUrl が一度だけ含まれます。キーはすぐに保存してください。以降のポーリングでは返されません。確認から7日以内に受け取ってください。
  5. ヘッダー Authorization: Bearer ntm_… を付けて、https://my.notiamo.com/api/mcp のMCPサーバーに接続します。アプリがMCPのサインインに対応していれば、キーのかわりに「Notiamoでサインイン」を使えます(下記参照)。
  6. list_projects(または find_project)を呼び出して、あなた用に作られたプロジェクトを探します。このプロジェクトは、すでに projectUrl をアドレスとして使っています。アドレスがない、または誤っている場合は、update_project_address を呼び出します。そのあと get_install を呼び出し、スニペットを設置して、check_install を呼び出します。create_workspace と create_project は、プランに余裕がある場合(有料プランまたはStudioのトライアル)にだけ使ってください。create_project には、list_workspaces で得た workspaceId が必要です。ワークスペースはプロジェクトをまとめるもので、たとえばクライアントごとに1つ作ります。プロジェクトにはウェブアドレスがなくてもかまいません(origin を省略します)。その場合、タスク、作業、ニュースはありますが、ウィジェットはありません。 インストール後は get_badge がフッターバッジを返します。サイトのフッター用の小さな Notiamo ロゴで、レビュアーにはレビューツールを開き、それ以外の人には Notiamo への通常のリンクになります。サイトの言語で表示されます(update_project_language、または create_project の language)。
  7. そのあと、コメントに対応します。list_comments、get_comment、reply、set_status を使います。新しい情報を確認するには、list_comments に since を渡します。Z で終わるUTC時刻(2026-10-17T08:00:00Z など)か、前回の応答の cursor です。変更があったものだけが返ります。1つのプロジェクト、または projectId を省略すれば、すべてのプロジェクトが対象です。新しい cursor を次回の確認のために保存し、more: true のときはすぐに続きを取得し、id で重複を除いてください。同じ項目が2回返ることがあります。
  8. 別の組織を作るには、nameを付けてcreate_organizationを呼び出します。オーナーがその管理者になりメールを受け取り、応答にはその組織専用の新しいtokenが含まれます。オーナーに無料の組織がなければ無料、あればプランが必要です。新しいトークンでget_payment_linkを呼び出すか、14日間のStudioトライアルにはstart_trialを呼び出します(1人1回。オーナーがリンクを開いてカードを入力します)。1日の上限があり、拒否時にいつ再試行できるかが示されます。
  9. プロジェクトを別のワークスペースへ移す(kind は project、projectId、toWorkspaceId)、または、所有者が管理者でもある別の組織へ、ワークスペースをそのプロジェクトごと移す(kind は workspace、workspaceId、toOrganizationId)には、request_move を呼び出します。この時点ではまだ何も移動しません。所有者にメールが届き、リンク先のページで24時間以内に確認する必要があります。ステータスは get_move_request で確認します。pending、done、cancelled、expired、failed のいずれかです。
  10. ページに結びつかない作業を追加するには、projectId と title、必要に応じて text と pageUrl を付けて create_task を呼び出します。文面を変更するには、taskId と、新しい title、text、またはその両方を付けて update_task を呼び出します。どちらも、新しいワークスペース、プロジェクト、タスクの1日あたりの上限に含まれます。上限に達すると、拒否の応答でそのことが示されます。list_comments ではタスクに [Task] が付き、type に task または comment を指定できます。
  11. ジョブレポート(Studio、Agency、トライアル)は、クライアントが終えた作業について記入するタスクです。場所、日付、お客様、フェーズ(before、during、after、other)ごとのファイルとキャプションを含みます。list_job_reports を呼び出し(state が ready なら、あなたの対応待ちのものが一覧になります)、get_comment で1件を読み、role を article にして、その言語で返信します。承認できるのは人だけです。承認用リンクを渡すか、request_approval を呼び出してください。承認されたら、role を posts にして、files(使うファイルのid)を付けて返信します。update_file はファイルの phase や caption を設定します。create_task と update_task は jobReport を受け付けます。
  12. 音声メモと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人と数えます)、プロジェクトごとに公開アドレス1つが使えます。プロジェクトで最初の公開コメントがついたあとは、アドレスを変更できるのは一度だけです。ファイルは100 MB、1ファイル5 MBまで。100 MBを超えると組織の管理者にメールが2回届き、その後は古いファイルから削除されます。コメント、タスク、返信は残ります。不正利用を防ぐため、アップロードが拒否されることがあります。動画は含まれません。Studio、Agency、トライアルが必要です。 アカウントを開いた時点で、ワークスペースとプロジェクトがすでに1つずつあります。

無料プランでは、ウィジェットにNotiamoのバッジが表示されます。

スクリプトタグの上のコメント行は、そのまま残してください。無料プランの利用規約で必須とされています。

<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->

`plan_limit` で拒否された場合は、どの上限に達したかと、次にすることが示されます。

拒否

サインアップとツールは、コードで応答します。サインアップのコードにはHTTPステータスが付きます。

コードHTTPステータス意味
signup_blocked403このネットワークからはサインアップできません。所有者が自分でサインアップします。
country_blocked403リクエスト元の国ではNotiamoをご利用いただけません。オーナーもその国からは登録できません。
rate_limited429リクエストが多すぎます。retryAfter 秒待ってください。
agent_signup_paused503エージェントによるサインアップは、現在一時停止中です。所有者が自分でサインアップします。
agent_signup_closed503エージェントによるサインアップは終了しました。所有者が自分でサインアップします。
account_exists409このメールアドレスのアカウントはすでにあります。所有者がログインして、設定 > AIエージェント > エージェントトークンでキーを作成します。
email_not_accepted422このメールアドレスは使えません。所有者が自分でサインアップします。
invalid_input422無効な項目があります。field がその項目を示します。
plan_limit402プランの上限に達しました。MCPツールが返し、次のステップ(start_trial または get_payment_link)も示します。
read_only403このキーまたはアプリは読み取り専用です。見ることはできますが、変更はできません。MCPツールが返します。
permission_missing403このキーまたはアプリには、この操作の権限がありません。permission が、不足しているグループ(または full)を示します。MCPツールが返します。

拒否された内容は所有者に伝えてください。回避しようとしないでください。

Notiamoでサインイン(OAuth)

キーのかわりに、サインインに対応したMCPクライアントはOAuthで接続できます。認可サーバーのメタデータは https://my.notiamo.com/.well-known/oauth-authorization-server にあります。MCPサーバーは 401 と、保護リソースのメタデータ(https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp、RFC 9728)を指す WWW-Authenticate ヘッダーを返します。このメタデータはこのサーバーを示し、スコープ 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 はトライアルを開始します。1人1回です。 料金

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

その他