MCP ツールリファレンス

Nolto の MCP サーバーは /mcp に HTTP transport（Streamable HTTP / JSON-RPC）で公開されています。

認証

対話クライアントには OAuth 2.1（Authorization: Bearer mcp_at_*）が標準です。ヘッドレス / CI 環境では Personal API Token（nolto_user_*）をベアラーとして渡すこともできます。セットアップ方法は MCP セットアップ を参照してください。

レート制限

ユーザーあたり 60 リクエスト/分。超過時は 429 Too Many Requests + Retry-After ヘッダー。

デフォルトプロジェクト

多くのツールは projectId パラメータを受け取りますが、省略すると set_default_project で設定したデフォルトプロジェクトが使われます。デフォルトが未設定で projectId も省略した場合はエラーになります。

list_projects

参加しているプロジェクトの一覧を返します。

レスポンス:

{
  "projects": [
    {
      "id": "uuid",
      "name": "my-app",
      "description": "...",
      "role": "owner"
    }
  ]
}

register_project

新しいプロジェクトを作成します。作成者が owner になります。

set_default_project

ユーザーごとのデフォルトプロジェクトを設定します。設定後、他のツールで projectId を省略できます。

list_plans

プロジェクトのプラン一覧を返します。

get_plan

プランの詳細（フェーズ、イベント含む）を返します。

register_plan

プランを登録し、LLM 変換ジョブをキューに入れます。

レスポンス:

{
  "planId": "uuid",
  "transformStatus": "queued",
  "detailUrl": "https://nolto.app/projects/.../plans/..."
}

register_structured_plan

AI ツール側で既に正規の 2 階層 StructuredPlan（グループ → タスク）を構築済みの場合に、それを直接登録します。register_plan との違いは 構造抽出（haiku）ステップをスキップ する点だけで、日本語サマリ生成（sonnet）と課金（変換 1 回分）は同じです。

structuredPlan の形

@nolto/llm の正規 structuredPlan と同じ形で、.strict()（不明なキーは拒否）です。

レスポンスは register_plan と同じ（planId / transformStatus / detailUrl）です。

upload_plan_document

プラン（または特定のフェーズ）に成果物ドキュメントを添付します。同一内容はコンテンツハッシュで重複排除されます。

デコード後のサイズは 2 MiB までです。

レスポンス:

{
  "documentId": "uuid",
  "deduped": false,
  "sizeBytes": 1024,
  "mimeType": "text/markdown"
}

deduped が true の場合、同一内容の既存ドキュメントが再利用されています。

update_plan_status

プランのステータスを更新します。

許可される遷移は データモデル を参照してください。

update_phase_status

フェーズのステータスを更新します。親プランのステータスが自動的に再計算されます。

レスポンス:

{
  "ok": true,
  "planStatus": "in_progress"
}

planStatus は再計算後の親プランのステータスです。派生ルールは データモデル を参照してください。

record_phase_test_result

フェーズのテスト結果を記録します。追記式で、同じフェーズに複数回記録できます（再テストのたびにラウンドが増えます）。ステータスは変更しません。

レスポンス:

{
  "ok": true,
  "round": 2,
  "verdict": "passed"
}

record_plan_review

プランの最終レビュー結果（GO / NO-GO）を記録します。追記式で、同じプランに複数回記録できます。ステータスは変更しません（GO ＝ 完了ではありません）。

レスポンス:

{
  "ok": true,
  "verdict": "go"
}