ガイド · 約 5 分

Onplana を Cursor に接続する方法

五つのステップです。トークンを生成し、mcpServers のスニペットを貼り付け、Cursor を再読み込みし、ツールの呼び出しで確認します。約 5 分です。

その後は Cursor の Agent に「Q3 のローンチのプロジェクト計画を、週ごとのマイルストーン付きで作成して」や「進行中のすべてのプロジェクトについて、今週のリスクをまとめて」と頼めば、Cursor がエディターを離れずに Onplana の中で直接作業します。

Onplana を開く → 設定 → エージェント Cursor の MCP ドキュメント

五つのステップ

  1. 1

    Onplana の接続トークンを生成する

    app.onplana.com で Onplana にサインインします。設定 → エージェント → エージェントを接続 と進み、Cursor のタイル（または Custom MCP client）を選び、次に個人用アクセストークン、最後にトークンを生成して接続スニペットを表示 を選びます。個人用アクセストークン（pat_ で始まります）をコピーします。このトークンのスコープは MCP_AGENT だけです。MCP ツールは呼び出せますが、ほかのトークンの作成、請求の変更、MCP の範囲外への操作はできません。

  2. 2

    Cursor の MCP 設定を開く

    Cursor で Settings を開き（macOS では Command+Shift+J、Windows や Linux では Ctrl+Shift+J）、Tools & MCP に進んで New MCP Server を選びます。Cursor は JSON の設定も直接読み込みます。プロジェクト単位ならリポジトリのルートの .cursor/mcp.json、全体なら ~/.cursor/mcp.json です。JSON を編集しても、画面で設定するのと同じ結果になります。

  3. 3

    Onplana の MCP サーバーの設定を貼り付ける

    "mcpServers" キーの下に "onplana" のエントリーを追加します。設定の全体は {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}} です。pat_paste-your-token-here を、ステップ 1 のトークンに置き換えます。ファイルを保存します。

  4. 4

    Cursor を再読み込みする

    Cursor のウィンドウを再読み込みするか（Command+Shift+P または Ctrl+Shift+P のあと "Reload Window"）、Settings の Tools & MCP で onplana サーバーをいったん無効にしてから有効にします。ハンドシェイクが成功すると、Onplana のツールが緑の状態表示とともに Agent のツール一覧に表示されます。

  5. 5

    接続を確認する

    Cursor の Agent のチャットで「自分の Onplana のプロジェクトを一覧にして」と頼みます。Cursor が Onplana の list_projects ツールを呼び出し、結果を表示します。エラーが出た場合は、トークンを確認し、設定ファイルが有効な JSON になっているかを確かめてください。

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（全体）

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

動作を確認する方法

Cursor の Agent のチャットを開き、次のいずれかを試してください。

  • 「自分の Onplana のプロジェクトを一覧にして。」
  • 「自分の Onplana アカウントで遅れているものは？」
  • 「プロジェクト X に『Postgres を Aurora に移行』という Onplana のタスクを作成して。」
  • 「プロジェクト Y の状況レポートを作成して。」

Cursor はツールの呼び出しを実行する前に表示するので、どのデータが読み書きされるかを確認できます。変更はすべてのプランで適用されます。Free プランでは一部の書き込み操作に毎月の上限があり（Professional プラン以上では上限なし）、エージェントは dryRun オプションで何も確定しない試し実行を求めることもできます。

よくある質問

MCP を含むのは Onplana のどのプランですか？

MCP は無料プランを含むすべてのプランで利用できます。同時に使えるエージェント接続の数はプランに応じて増え（Free 2、Professional 3、Business 5、Enterprise 10、Enterprise+ 無制限）、実際の AI の利用を制限するのはお客様の AI トークン残高（有料プランでは毎月の割り当て、Free プランでは一回限りのボーナス、それに購入したクレジット）です。プランは app.onplana.com/billing でいつでも変更できます。

Cursor の MCP のサポートは安定していますか？

はい。MCP は Cursor ですでにリリースされた機能で、実験的な機能ではありません。Onplana の接続は CURSOR プロバイダーに結び付けられ、読み取り、作成、更新のすべてのツールを受け取ります。ただし、Cursor の設定の場所はバージョンによって変わることがあります。その場合は docs.cursor.com で現在の場所を確認し、onplana サーバーのエントリーはそのままにしてください。

プロジェクトの設定と全体の設定、どちらにしますか？

どちらでも構いません。リポジトリのルートの .cursor/mcp.json は接続をそのプロジェクトに限定します（リポジトリごとに別々のトークンで別々の Onplana の組織に対応する場合に便利です）。~/.cursor/mcp.json は接続をすべての Cursor のウィンドウに適用します。両方に "onplana" サーバーが定義されている場合は、プロジェクトのほうが優先されます。

Cursor はどのツールにアクセスできますか？

どの MCP クライアントにも見える 351 個のツールの同じカタログです。読み取り（list_projects、get_project、list_tasks、list_my_tasks、list_overdue、list_risks、search_org_knowledge、summarize_project、generate_status_report）、書き込み（create_project、create_task、update_task、assign_task、create_milestone、create_comment、bulk_update_tasks、create_sprint_with_tasks、link_dependency）、それにガバナンス、変更管理、コンプライアンス、ドキュメント、ワークフローの領域です。一部のツールはプランによって有効になります。カタログの全体は onplana.com/mcp にあります。

Cursor は MCP 経由でプロジェクトやタスクを削除できますか？

はい、復元できる形で削除できます（管理者が無効にしていない場合）。MCP 経由の削除ツールは、タスク、プロジェクト、リスト、ドキュメントの削除です。それぞれがワークスペースごとのスイッチで、管理者が選択を保存するまでは有効のままです。また、呼び出す側には、もともと必要な権限が引き続き必要です。どれもごみ箱への可逆的な削除で、削除されたタスクやプロジェクトはサブツリー全体ごと保持され、元の ID のまま復元されるので、依存関係と階層はそのまま残ります。スプリント、マイルストーン、エピック、目標には MCP 経由の削除ツールはありません。

トークンを貼り付ける代わりに OAuth は使えますか？

Onplana は OAuth 2.1 のディスカバリーのメタデータ（RFC 9728 と RFC 8414）を mcp.onplana.com/.well-known/ で公開しています。Cursor がそれを自動で使うかどうかは、お使いの Cursor のバージョンが MCP の認証にどこまで対応しているかによります。ここで説明しているヘッダーにトークンを入れる方法は、リモートの MCP サーバーに対応したすべてのバージョンで動作します。

接続はどこで取り消せますか？

Onplana の設定から、エージェント、接続と進み、トークンの行で失効を選びます。すぐに有効になり、Cursor の次のツール呼び出しは 401 を返します。Enterprise プラン以上では、組織のオーナーまたは管理者が、そのトークンによるすべての呼び出しを Audit Logs ページの Agent Activity で確認できます。

関連情報