ログイン無料で始める

MCP セットアップ

Nolto は /mcp に HTTP transport の MCP サーバー を公開しています。Claude Code、Codex、Claude Desktop などの MCP クライアントから、プロジェクト管理やプラン登録を直接操作できます。

認証は OAuth 2.1 + PKCE で自動的に処理されます。初回接続時にブラウザで承認するだけで利用を開始できます。

Claude Code

claude mcp add --transport http nolto https://nolto.app/mcp

追加後、MCP ツールを使う操作（例:「プロジェクト一覧を表示して」）を行うと、ブラウザが開いて OAuth 同意画面が表示されます。承認すると、トークンが Claude Code に保存され、以降は自動的に認証されます。

動作確認

> Nolto のプロジェクト一覧を見せて

Claude Code が list_projects ツールを呼び出し、参加中のプロジェクトが表示されれば成功です。

Codex CLI

codex mcp add nolto --url https://nolto.app/mcp
codex mcp login nolto

codex mcp login でブラウザが開き、OAuth 同意フローに進みます。

Claude Desktop

Claude Desktop の設定で、MCP サーバーとして以下を追加します:

  • Transport: HTTP
  • URL: https://nolto.app/mcp

初回アクセス時にブラウザで OAuth 認証が行われます。

デフォルトプロジェクトの設定

ほとんどの MCP ツールは projectId パラメータを受け取りますが、毎回指定するのは面倒です。set_default_project ツールでデフォルトプロジェクトを設定すると、projectId を省略できます。

> デフォルトプロジェクトを my-app に設定して

MCP クライアントが set_default_project を呼び出し、以降の操作ではそのプロジェクトが自動的に使われます。

利用可能なツール

ツールスコープ説明
list_projectsmcp:read参加プロジェクト一覧
register_projectmcp:write新規プロジェクト作成
set_default_projectmcp:writeデフォルトプロジェクトを設定
list_plansmcp:readプラン一覧（ステータスフィルタ可）
get_planmcp:readプラン詳細
register_planmcp:writeプラン登録
update_plan_statusmcp:writeプランのステータス変更
update_phase_statusmcp:writeフェーズのステータス変更

各ツールの詳細は MCP ツールリファレンス を参照してください。

トラブルシューティング

401 Unauthorized が返る

  • Personal API Token (nolto_user_*) を /mcp に渡していませんか？ → /mcp は OAuth トークン (mcp_at_*) のみ受け付けます。claude mcp add または codex mcp login で再認証してください。
  • トークンの有効期限が切れている可能性があります。MCP クライアントは自動的にリフレッシュを試みますが、Refresh Token の期限（30日）を過ぎた場合は再ログインが必要です。

429 Too Many Requests が返る

MCP エンドポイントには ユーザーあたり 60 リクエスト/分 のレート制限があります。Retry-After ヘッダーの秒数を待ってからリトライしてください。