AIエージェント向けNotiamo
AIエージェントが、所有者の無料アカウントを開き、ウェブサイトにウィジェットを設置し、コメントと作業に対応するために必要なことのすべて。ブラウザは不要です。
流れ
- 所有者のアカウントを依頼します。
email、name、agent、localeと、あればcompany、projectUrl(ウェブサイトのアドレス)、referralを付けて、POST https://my.notiamo.com/api/agent/signupを送ります。応答にはrequestId、pollSecret、pollAfterSecondsが含まれます。 - Notiamoから届く確認メールを開いて確認するよう、所有者に伝えます。確認されるまで、何も進みません。
pollAfterSeconds秒ごとに、Authorization: Bearer <pollSecret>を付けてGET https://my.notiamo.com/api/agent/signup/{requestId}をポーリングします。ステータスはpending、confirmed、expired、reportedのいずれかです。- ステータスが
confirmedになると、応答にキー(ntm_で始まるtoken)と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を呼び出します。create_workspaceとcreate_projectは、プランに余裕がある場合(有料プランまたはStudioのトライアル)にだけ使ってください。create_projectには、list_workspacesで得たworkspaceIdが必要です。ワークスペースはプロジェクトをまとめるもので、たとえばクライアントごとに1つ作ります。プロジェクトにはウェブアドレスがなくてもかまいません(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です。変更があったものだけが返ります。1つのプロジェクト、またはprojectIdを省略すれば、すべてのプロジェクトが対象です。新しいcursorを次回の確認のために保存し、more: trueのときはすぐに続きを取得し、idで重複を除いてください。同じ項目が2回返ることがあります。 - 別の組織を作るには、
nameを付けてcreate_organizationを呼び出します。オーナーがその管理者になりメールを受け取り、応答にはその組織専用の新しいtokenが含まれます。オーナーに無料の組織がなければ無料、あればプランが必要です。新しいトークンでget_payment_linkを呼び出すか、14日間のStudioトライアルにはstart_trialを呼び出します(1人1回。オーナーがリンクを開いてカードを入力します)。1日の上限があり、拒否時にいつ再試行できるかが示されます。 - プロジェクトを別のワークスペースへ移す(
kindはproject、projectId、toWorkspaceId)、または、所有者が管理者でもある別の組織へ、ワークスペースをそのプロジェクトごと移す(kindはworkspace、workspaceId、toOrganizationId)には、request_moveを呼び出します。この時点ではまだ何も移動しません。所有者にメールが届き、リンク先のページで24時間以内に確認する必要があります。ステータスはget_move_requestで確認します。pending、done、cancelled、expired、failedのいずれかです。 - ページに結びつかない作業を追加するには、
projectIdとtitle、必要に応じてtextとpageUrlを付けてcreate_taskを呼び出します。文面を変更するには、taskIdと、新しいtitle、text、またはその両方を付けてupdate_taskを呼び出します。どちらも、新しいワークスペース、プロジェクト、タスクの1日あたりの上限に含まれます。上限に達すると、拒否の応答でそのことが示されます。list_commentsではタスクに[Task]が付き、typeにtaskまたはcommentを指定できます。 - ジョブレポート(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を受け付けます。 - 音声メモと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_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 と、保護リソースのメタデータ(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