MCP ツールリファレンス

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

認証

OAuth 2.1 のみ（Authorization: Bearer mcp_at_*）。Personal API Token (nolto_user_*) は受け付けません。セットアップ方法は MCP セットアップを参照してください。

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

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

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


スコープ	`mcp:read`
パラメータ	なし

レスポンス:

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

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


スコープ	`mcp:write`

パラメータ	型	必須	説明
`name`	string	Yes	プロジェクト名（1文字以上）
`description`	string	No	説明
`repositoryUrl`	string	No	リポジトリ URL

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


スコープ	`mcp:write`

パラメータ	型	必須	説明
`projectId`	UUID	Yes	デフォルトに設定するプロジェクト ID

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


スコープ	`mcp:read`

パラメータ	型	必須	説明
`projectId`	UUID	No	プロジェクト ID（省略時はデフォルト）
`status`	string	No	ステータスフィルタ（`not_started` / `in_progress` / `done` / `discarded`）

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


スコープ	`mcp:read`

パラメータ	型	必須	説明
`planId`	UUID	Yes	プラン ID
`projectId`	UUID	No	プロジェクト ID（省略時はデフォルト）

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


スコープ	`mcp:write`

パラメータ	型	必須	説明
`projectId`	UUID	No	プロジェクト ID（省略時はデフォルト）
`plan.title`	string	Yes	タイトル（1〜500文字）
`plan.content`	string	Yes	本文（1〜50,000文字）
`plan.status`	string	No	初期ステータス（デフォルト: `not_started`）
`plan.phases`	array	No	フェーズのリスト（最大50件）
`plan.plannedStartAt`	string	No	予定開始日時（ISO 8601）
`plan.plannedEndAt`	string	No	予定終了日時（ISO 8601）
`source.kind`	string	No	登録元（デフォルト: `mcp`）
`source.path`	string	No	ファイルパス
`source.url`	string	No	URL
`source.hash`	string	No	コンテンツハッシュ
`git.userName`	string	No	Git ユーザー名
`git.userEmail`	string	No	Git メールアドレス

レスポンス:

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

ℹ️

プランの登録は月間 AI 変換クォータを 1 回分消費します。

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


スコープ	`mcp:write`

パラメータ	型	必須	説明
`planId`	UUID	Yes	プラン ID
`projectId`	UUID	No	プロジェクト ID（省略時はデフォルト）
`status`	string	Yes	新しいステータス
`message`	string	No	変更理由（最大1,000文字）

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

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


スコープ	`mcp:write`

パラメータ	型	必須	説明
`planId`	UUID	Yes	プラン ID
`phaseId`	UUID	Yes	フェーズ ID
`projectId`	UUID	No	プロジェクト ID（省略時はデフォルト）
`status`	string	Yes	新しいステータス
`message`	string	No	変更理由（最大1,000文字）

レスポンス:

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

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