ガイド · 約 5 分

Onplana を Windsurf に接続する方法

五つのステップです。トークンを生成し、mcpServers のスニペットを貼り付け（Windsurf は serverUrl を使います）、Cascade を更新し、ツールの呼び出しで確認します。約 5 分です。

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

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

五つのステップ

  1. 1

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

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

  2. 2

    Windsurf Cascade の MCP 設定を開く

    Windsurf で Plugins (MCP) パネルを開き、"View raw config" を選びます。mcp_config.json が開きます。macOS と Linux では ~/.codeium/windsurf/mcp_config.json、Windows ではユーザープロファイルの .codeium\windsurf フォルダーにあります。ファイルが空の場合は {} から始めます。

  3. 3

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

    "mcpServers" キーの下に "onplana" のエントリーを追加します。設定の全体は {"mcpServers": {"onplana": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}} です。Windsurf はリモートの HTTP サーバーに "serverUrl" キーを使います（"url" ではありません）。pat_paste-your-token-here をステップ 1 のトークンに置き換えて保存します。

  4. 4

    Cascade を更新する

    Plugins (MCP) パネルで "Refresh"（円形の矢印）をクリックし、Cascade に設定を読み直させて MCP のハンドシェイクを実行させます。onplana サーバーに緑の状態表示と使えるツールの数が表示されるはずです。Cascade が同時に有効にできる MCP ツールは最大 100 個で、Onplana は 351 個を公開しているので、Onplana のツールが足りない場合は、不要なほかのサーバーやツールを無効にしてください。

  5. 5

    接続を確認する

    Cascade で「自分の Onplana のプロジェクトを一覧にして」と頼みます。Windsurf が Onplana の list_projects ツールを呼び出し、結果を表示します。エラーが出た場合は、トークンを確認し、キーが "serverUrl"（"url" ではない）であることと、JSON が有効であることを確かめてください。

~/.codeium/windsurf/mcp_config.json

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

動作を確認する方法

Cascade を開き、次のいずれかを試してください。

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

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

よくある質問

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

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

Windsurf が "url" ではなく "serverUrl" を使うのはなぜですか？

それが、HTTP 経由のリモート MCP サーバーに対する Windsurf の設定スキーマだからです。Claude Desktop と Cursor は "url" を使い、Windsurf Cascade は "serverUrl" を使います。エントリーのほかの部分（onplana というサーバー名と Authorization ヘッダー）は同じです。誤って "url" を使うことが、Windsurf の接続がエラーも出さずに表示されない最もよくある原因です。

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

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

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

どの 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 にあります。

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

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

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

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

関連情報