ガイド · 約 5 分

Onplana を Claude Desktop に接続する方法

五つのステップです。トークンを生成し、設定スニペットを貼り付け、Claude Desktop を再起動し、ツールの呼び出しで確認します。全体で約 5 分です。

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

Onplana を開く → 設定 → エージェント Claude Desktop をダウンロード

五つのステップ

  1. 1

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

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

  2. 2

    Claude Desktop の設定を開く

    Claude Desktop で Settings → Developer → Edit Config をクリックします。既定のエディターで claude_desktop_config.json が開きます。macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.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

    Claude Desktop を再起動する

    Claude Desktop を完全に終了し（macOS では Command+Q、Windows では完全に終了）、もう一度開きます。ツールの選択画面に Onplana のツールが表示されるはずです。

  5. 5

    接続を確認する

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

claude_desktop_config.json

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

動作を確認する方法

Claude Desktop で新しい会話を開き、次のいずれかを試してください。

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

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

よくある質問

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

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

トークンの代わりに OAuth は使えますか？

はい。Onplana は Claude の Connectors ディレクトリに掲載されています。Claude Desktop（または claude.ai）で Settings を開き、Connectors を探してディレクトリを参照し、Onplana を選んでブラウザーでアクセスを承認すれば、何も貼り付ける必要はありません。その仕組みは PKCE 付きの OAuth 2.1 で、Onplana は RFC 9728 と RFC 8414 に沿ったディスカバリーのメタデータを https://mcp.onplana.com/.well-known/oauth-protected-resource と oauth-authorization-server で公開しています。ここで説明しているトークンを貼り付ける方法は設定ファイルを使いたい場合のもので、OAuth は有効期間の長いトークンを管理したくない方のためのものです。

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

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

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

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

Claude Desktop の代わりに Claude Code（CLI）を使えますか？

はい。Claude Code には MCP のサポートが組み込まれています。インストールは一行です：`claude mcp add onplana --transport http https://mcp.onplana.com/mcp`。Claude Code は最初のツール呼び出しで OAuth を開始し（貼り付けるトークンは不要）、ブラウザーを開いて Onplana にサインインし、同意を完了します。それ以降、そのプロジェクトのどの `claude` セッションからも Onplana のツールカタログが見えます。OAuth の代わりにトークンを使うには、コマンドに `--header "Authorization: Bearer pat_…"` を追加します。`claude mcp list` で確認します。macOS、Linux、Windows 上の WSL で動作します。

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

Onplana の 設定 → エージェント → 接続 に、個人用アクセストークンもブラウザーからのアクセスも含め、すべての接続が表示されます。その行で失効を選びます。すぐに有効になり、Claude の次のツール呼び出しは 401 を返し、Claude は再接続を求めます。

トークンが漏れたらどうなりますか？

すぐに失効させ（上記を参照）、同じパネルから新しいトークンを生成します。漏れたトークンは次の呼び出しから使えなくなります。Enterprise プラン以上では、組織のオーナーまたは管理者が、漏れたトークンによるすべての呼び出しを Audit Logs ページの Agent Activity で確認し、攻撃者が何を見たり変更したりできたかを調べられます。

Linux でも動きますか？

Claude Desktop は今のところ macOS と Windows 版しかありません。Linux では、公式の MCP Inspector（npx @modelcontextprotocol/inspector）や Cursor（Linux 対応）など別の MCP クライアントを使うか、Onplana の型付き TypeScript クライアント SDK を使ってローカルのエージェントスクリプトに Onplana の接続を組み込んでください。

関連情報