Orangescrum MCP Server について
Orangescrum MCP Server は、プロジェクトマネージャー、開発者、QA チーム、デリバリーリード向けに、AI ツールを Orangescrum ワークスペースへ接続します。プロジェクト遂行、テスト、リリース、リスク、ワークスペース内コンテンツをリアルタイムで読み書きでき、OAuth 2.1 によりログインユーザーの権限が適用されます。
主な機能
- 01プロジェクト項目の読み取りと更新
- 02テストケースとリリースの管理
- 03スプリントとScaled Agileの計画
- 04リスク、リソース、勤怠へのアクセス
- 05Wikiページとドキュメントの検索
- 06OAuth 2.1によるワークスペース権限の適用
活用シーン
- 01会議メモからタスクを作成
- 02仕様からバックログを作成
- 03スプリントとリリース準備状況の確認
- 04AIツールからプロジェクト情報を検索
MCP 対応
ホスト型MCPサーバーとして、Streamable HTTPとOAuthを介してOrangescrumのデータや操作を対応クライアントに公開します。クライアントで利用できるプロンプトとリソースも提供します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.orangescrum.com/mcp/partnerclaude mcp add --transport http com-orangescrum-orangescrum https://mcp.orangescrum.com/mcp/partner{"mcpServers":{"com-orangescrum-orangescrum":{"type":"http","url":"https://mcp.orangescrum.com/mcp/partner"}}}Cursor で開く{"servers":{"com-orangescrum-orangescrum":{"type":"http","url":"https://mcp.orangescrum.com/mcp/partner"}}}VS Code で開く{"mcpServers":{"com-orangescrum-orangescrum":{"type":"http","url":"https://mcp.orangescrum.com/mcp/partner"}}}{"mcpServers":{"com-orangescrum-orangescrum":{"serverUrl":"https://mcp.orangescrum.com/mcp/partner"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Orangescrum MCP サーバー
Orangescrum 公式の Model Context Protocol(MCP)サーバーです。クラウドホスト型のブリッジとして、AI ツールから Orangescrum ワークスペース内のプロジェクト、タスク、ユーザー、スプリント、テストケース管理、リリース、スケールドアジャイル、リスク、リソース、勤怠、休暇管理、ナレッジベース(Wiki)、ドキュメントに安全かつリアルタイムにアクセスできます。
はじめに · 対応ツール · セキュリティと管理 · トラブルシューティング
公式の Orangescrum MCP Server は、Orangescrum のワークスペースと互換性のある AI ツールをつなぐクラウドベースのブリッジです。接続すると、それらのツールを使って、プロジェクト、タスク、ユーザー、エピック・フィーチャー・ストーリーの階層、スプリント、タイムログ、テストケース管理、バージョンとリリース、スケールド・アジャイル、リスク管理、リソース管理、出勤状況、休暇、チェックリスト、ナレッジベース(Wiki)ページ、保存済みのプロジェクトコンテキスト、アップロード済みドキュメントをリアルタイムで操作できます。認証にはPKCE を使用した OAuth 2.1を採用しているため、すべてのアクションはサインイン中のユーザーとして実行され、既存の Orangescrum のロールと権限が適用されます。
Orangescrum MCP Server を使うと、次のことができます。
- ツールを切り替えずに、プロジェクト、タスク、スプリント、欠陥、リリース、Wiki ページ、ドキュメントを要約して検索できます。
- 自然な言葉で指示して、タスク、ストーリー、欠陥、テストケース、タイムログ、リリース、ナレッジベースページを作成・更新できます。
- ライブデータを使って、スプリント、プログラムインクリメント、リリース準備状況を計画・追跡できます。
- 議事録をタスクにしたり、仕様書をバックログにしたりするなど、反復的な作業を自動化できます。
一度接続したら、希望する内容を説明するだけです。タブの切り替えやコピー&ペーストは不要です。AI が適切なアクションを選択して実行します。
AI アシスタントや IDE を使い、コンテキストを絶えず切り替えることなく Orangescrum のデータを利用したいプロジェクトマネージャー、開発者、QA チーム、デリバリーリード向けに構築されています。
重要
推奨エンドポイントは
https://mcp.orangescrum.com/mcp/partnerです。 OAuth 2.1 を使用するため、API キーを設定ファイルに貼り付ける必要はありません。クライアントが自身を登録し、ブラウザーを開いてサインインを促した後、ワークスペースを 1 つ選ぶよう求めます。設定手順については、クイックスタートをご覧ください。
ワンクリックセットアップ
以下から AI クライアントを選択して、公式 Orangescrum MCP Server を追加してください。ワンクリックインストールボタンを使うとサーバーが追加されるため、JSON 設定を手動で編集する必要はありません。それ以外のボタンをクリックすると、そのクライアントの手順ガイドが開きます。
|
Claude Custom connector |
Claude Code One command |
Codex One command |
ChatGPT Custom connector |
VS Code One-click install |
|
OpenCode One command |
Gemini Custom app |
Antigravity IDE and CLI |
Perplexity Custom connector |
Cursor One-click install |
|
Muse Chat prompt |
Hermes Agent config.yaml |
OpenClaw One command |
GitHub Copilot CLI and IDE |
Grok Custom connector |
|
Kiro One-click install |
Devin Desktop Settings |
Zed Settings |
LM Studio mcp.json |
n8n Workflow node |
70 を超えるクライアントが、クライアントガイドで紹介されています。
エージェントにセットアップを任せる
ほとんどの AI エージェントは、サーバーの追加とサインインを自分で行えます。このプロンプトをエージェント(Claude Code、Codex、OpenCode、Cursor、Copilot、Antigravity など)に貼り付けてください。
Set up the Orangescrum MCP Server for the AI client you are running in.
Read https://raw.githubusercontent.com/Orangescrum/orangescrum-mcp-server/main/INSTALL.md
and follow it exactly: add the server https://mcp.orangescrum.com/mcp/partner
using my client's own method, keep my existing MCP servers, walk me through
the browser sign-in, then call get_current_user to confirm it works.
INSTALL.mdには、エージェントが自身のクライアントの手順を確認し、ほかの設定には触れずにサーバーを追加し、サインインをユーザーに引き継ぎ、接続を確認する方法が記載されています。
または、サーバーを自分で追加してください。
| クライアント | コマンドまたは設定 |
|---|---|
claude mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partnerを実行し、続けて/mcpでサインインします | |
codex mcp add orangescrum --url https://mcp.orangescrum.com/mcp/partnerを実行し、続けてcodex mcp login orangescrumを実行します | |
{"mcp": {"orangescrum": {"type": "remote", "url": "https://mcp.orangescrum.com/mcp/partner"}}}をopencode.jsonに追加し、続けてopencode mcp auth orangescrumを実行します | |
copilot mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partnerを実行し、続けて/mcp authを実行します | |
{"mcpServers": {"orangescrum": {"url": "https://mcp.orangescrum.com/mcp/partner"}}}を~/.cursor/mcp.jsonに追加します | |
{"servers": {"orangescrum": {"type": "http", "url": "https://mcp.orangescrum.com/mcp/partner"}}}を.vscode/mcp.jsonに追加します | |
{"mcpServers": {"orangescrum": {"serverUrl": "https://mcp.orangescrum.com/mcp/partner"}}}を~/.gemini/config/mcp_config.jsonに追加します | |
Customize → Connectors → + Add → Add custom connectorを選び、名前にOrangescrumを指定して、サーバー URL を貼り付けます | |
| chatgpt.com/plugins → + → Add custom MCP serverを選び、サーバー URL を貼り付けて、OAuthを選択します | |
| Settings → Connected Apps → Custom appsを選び、サーバー URL を貼り付けてサインインします | |
| grok.com/connectors → New Connector → Customを選び、サーバー URL を貼り付けてサインインします | |
| Plugins → Add custom → Add MCP connector → Remoteを選び、サーバー URL を貼り付けて、OAuth 2.0を選択します | |
| 実行する各エージェントにサーバーを追加します(エージェントオーケストレーターを参照) | |
| オーケストレーションツールと SDKを参照してください | |
サーバー URL https://mcp.orangescrum.com/mcp/partnerを使用するか、INSTALL.mdを参照してください |
目次
- ワンクリックセットアップ
- 対応クライアント
- プラグインのパッケージ化と互換性
- 対応モジュールとツール
- サーバーがツールを公開する方法
- MCP ゲートウェイ
- 始める前に
- データとセキュリティ
- 仕組み
- ワークフローの例
- ヒントとコツ
- 管理者向けメモ:アクセスの管理
- セキュリティ
- サポートとフィードバック
- 免責事項
対応クライアント
Orangescrum MCP Server は、OAuth を使用した Streamable HTTP 経由のリモート MCP に対応するすべてのクライアントで動作します。70 種類以上のクライアント向けに、手順を追ったセットアップガイドを用意しています。
| ガイド | 対象 |
|---|---|
| コーディングエージェントと IDE | Claude Code、OpenAI Codex CLI、OpenCode、Cursor、VS Code、GitHub Copilot CLI、Visual Studio、Google Antigravity、Gemini CLI、Devin Desktop(旧 Windsurf)、Zed、Cline、Kilo Code、Roo Code、Continue、Goose、Amp、Kiro、JetBrains Junie と AI Assistant、Factory Droid、Augment Code、Crush、Qwen Code、Trae、Hermes Agent、OpenClaw、さらに Orca や T3 Code などのエージェントオーケストレーター |
| チャットアプリとアシスタント | Claude(Claude.ai、Desktop、Cowork)、ChatGPT、Gemini、Grok、Perplexity、Mistral Le Chat、Microsoft Copilot Studio、Muse、Raycast AI、Notion AI、Slack、LibreChat、Open WebUI、Jan、LM Studio、Cherry Studio、Msty Studio |
| オーケストレーションツールと SDK | n8n、Zapier、Make、Dify、Flowise、Langflow、OpenAI、Anthropic、xAI、Gemini の各 API、公式 MCP SDK、OpenAI Agents SDK、Claude Agent SDK、Vercel AI SDK、LangChain と LangGraph、Pydantic AI、LlamaIndex、Mastra、CrewAI、Google ADK、Microsoft Agent Framework、Semantic Kernel、AutoGen、Agno、Strands Agents、Cloudflare Agents、smolagents、Haystack、AWS Bedrock AgentCore Gateway |
| INSTALL.md | AI エージェントが読み取って、自身のセットアップに使用できる手順 |
また、このサーバーは mcp-remote プロキシを通じて、ローカルの STDIO 専用 MCP クライアントにも対応します。プロキシは localhost で実行され、ブラウザーで OAuth フローを完了し、リクエストをホストされたサーバーに転送します。
メモ
Microsoft 365 Copilot 宣言型エージェントと Gemini Enterprise は、まだ対応していません。どちらも OAuth クライアントシークレットを必要としますが、このサーバーはシークレットなしで公開クライアントを登録します。
ヒント
ホスト型アプリのメニューは頻繁に変わります。手順が表示内容と異なる場合は、クライアントのセットアップまたはクライアント独自の MCP ドキュメントを確認してください。
プラグインのパッケージ形式と互換性
このリポジトリでは、クライアントがそれぞれのネイティブな検出・インストールフローを利用できるよう、同じ MCP サーバーとスキルを複数のパッケージ形式で公開しています。
| 形式 | マニフェストと設定 | 共通コンポーネント |
|---|---|---|
| Agent Plugins v1 | plugin.json および mcp.json | skills/ |
| Claude Code プラグイン | .claude-plugin/plugin.json および .claude-plugin/marketplace.json | .mcp.json および skills/ |
| Cursor プラグイン | .cursor-plugin/plugin.json | .mcp.json および skills/ |
| Gemini 拡張機能 | gemini-extension.json | マニフェストに埋め込まれた MCP サーバー設定 |
| MCP Registry | server.json | リモートサーバーのメタデータ |
skills/ にあるスキルは、パッケージ化されたすべてのプラグインがインストールするものです。それぞれの機能については、skills/README.md をご覧ください。
mcp.json と .mcp.json はどちらも意図的に用意されています。Agent Plugins では、ルートのファイル名として mcp.json、および移植可能なトランスポート用語(streamable-http)が必要です。一方、既存のクライアントでは引き続き .mcp.json とそれぞれのネイティブな用語(http)が使われます。どちらかのファイルを変更する場合は、エンドポイントの設定を一致させてください。差異があると、npm run validate は失敗します。
スキルを含む Claude Code プラグインをインストールするには:
/plugin marketplace add Orangescrum/orangescrum-mcp-server
/plugin install orangescrum@orangescrum
サポート対象のモジュールとツール
ツールはモジュールごとに整理され、目的(読み取りまたは書き込み)に分かれています。各モジュールには独自の OAuth スコープがあります。ユーザーは同意画面でスコープを承認し、ワークスペース管理者は付与可能なスコープの上限を設定します。
| モジュール | ツール | スコープ |
|---|---|---|
| プロジェクト | 5 | mcp:projects.read · mcp:projects.write |
| タスク:コメント、依存関係、リンク、ラベル、添付ファイル、ステータス、タイプ | 27 | mcp:tasks.read · mcp:tasks.write |
| ユーザー | 3 | mcp:users.read |
| テストケース管理:ケース、スイート、計画、実行、シナリオ、戦略、ベースライン、データセット、不具合 | 69 | mcp:tests.read · mcp:tests.write |
| バージョンとリリース:項目、準備状況、承認、リリースノート、依存関係、リリース開始チェックリスト、ブラックアウト期間、顧客への影響、テンプレート、分析 | 60 | mcp:releases.read · mcp:releases.write |
| スケールドアジャイル:リリーストレイン、プログラムインクリメント、イテレーション、プログラムボード、PI 目標、ROAM リスク、信頼度投票、WSJF、Inspect and Adapt、フローメトリクス | 50 | mcp:safe.read · mcp:safe.write |
| リスク管理:リスクレジスター、ワークフロー、コメント、リンク、ウォッチャー、承認、ヒートマップ、レポート | 27 | mcp:risks.read · mcp:risks.write |
| チェックリスト:グループ、項目、テンプレート、項目ごとのチェックリスト | 20 | mcp:checklists.read · mcp:checklists.write |
| 休暇:休暇の種類、残日数、休日、申請、承認、レポート | 12 | mcp:leaves.read · mcp:leaves.write |
| リソース管理:稼働状況、キャパシティ、稼働率、アロケーションレポート、スキル | 8 | mcp:resources.read |
| スプリント | 7 | mcp:sprints.read · mcp:sprints.write |
| 勤怠:出退勤の打刻、記録、チームのステータス、ダッシュボード、レポート | 7 | mcp:attendance.read · mcp:attendance.write |
| バックログ階層:エピック、フィーチャー、ストーリー、サブタスク | 5 | mcp:epics.read · mcp:epics.write |
| ナレッジベース(Wiki):棚、ブック、ページツリー、ページ、バージョン、コメント、添付ファイル、バックリンク、アクションアイテム、レビュー、作業項目へのリンク、検索 | 36 | mcp:wiki.read · mcp:wiki.write |
| タイムログ | 3 | mcp:timelogs.read · mcp:timelogs.write |
| プロジェクトコンテキスト(「メモリー」) | 2 | mcp:context.read · mcp:context.write |
| ドキュメント管理:アップロード済みドキュメントの横断検索(RAG) | 1 | mcp:documents.read |
| 合計 | 342 |
すべてのリクエストには基本スコープ mcp:use も必要です。これは、クライアントが詳細なスコープ名を認識できない場合に使用するスコープです。
サーバーは、ほとんどのクライアントでスラッシュコマンドとして表示される daily_standup と overdue_report の2つのプロンプトと、クライアントがコンテキストとして添付できる3つのリソース(プロジェクト、タスク、保存済みのプロジェクトコンテキスト)も提供します。
モジュール固有の条件:
- ワークスペースのプランに該当するモジュールが含まれている場合、スプリントおよびスケールドアジャイルのツールを利用できます。
- **書き込みスコープはオプトインです。**読み取り専用の許可では、何も変更できない調査用アシスタントとして利用できます。
- **エンタイトルメントの変更は即時に適用されます。**管理者がワークスペースで許可されるスコープを拡大または縮小すると、接続済みのクライアントは再接続せず、次のリクエストから変更を反映します。
メモ
各ツールで必要なスコープを含む、最新の完全なツールリファレンスについては、ツールを参照してください。
サーバーがツールを公開する方法
Orangescrum MCP Server は、接続で使用できるすべてのツールを、ページネーションカーソルなしで1つの tools/list レスポンスとして送信します。ツール名は list_projects、create_task、get_release_readiness、start_sprint などの通常の snake_case 動詞なので、エージェントは検出手順を挟まず、どれでも直接呼び出せます。
この仕組みには次の2つの利点があります。
- ツールのページを数ページ取得した時点で処理を終了するクライアントや、最初のページだけをキャッシュするクライアントでも、すべてのツールを確認できます。
- エージェントは、追加の検索を行わずに、プロジェクトを探し、次にそのアクティブなスプリントを探し、さらに未完了のタスクを探すといった複数手順の作業を計画できます。
クライアントで有効なツールを制限できる場合は、使用しないモジュールを無効にして、目の前のタスクに必要な情報だけがコンテキストに含まれるようにしてください。
MCP ゲートウェイ
MCP ゲートウェイまたはプロキシを使用する場合は、同じ URL を指定してください。オーバーライドは不要です。ツールリスト全体が1ページで届き、ゲートウェイはユーザーの Authorization: Bearer トークンを変更せずに転送します。
https://mcp.orangescrum.com/mcp/partner
ゲートウェイは、クライアントが認証サーバーを検出できるよう、401 レスポンスの WWW-Authenticate ヘッダーをそのまま転送する必要があります。
開始する前に
サーバーをセットアップする前に、お使いの環境が次の要件を満たしていることを確認してください。
前提条件
要件は接続方法によって異なります。
対応クライアントの場合
- 管理者によって MCP が有効化された Orangescrum Cloud ワークスペース(管理者向けの注意事項を参照)
- Orangescrum へのサインイン(メールアドレスとパスワード、または Google サインイン)
- 任意のクライアントへのアクセス
- OAuth 2.1 認証フローを完了するための最新のブラウザー
IDE またはローカルクライアントの場合(デスクトップのセットアップ)
- MCP が有効化された Orangescrum Cloud ワークスペース
- 対応 IDE(例:VS Code または Cursor)、またはカスタムの MCP 互換クライアント
- クライアントがローカル MCP プロキシ(
mcp-remote)を必要とする場合は、Node.js v18+ がインストールされていること - OAuth サインインを完了するための最新のブラウザー
データとセキュリティ
サーバーでは、次の複数のセキュリティ制御が適用されます。
- すべての通信は HTTPS(TLS 1.2 以降) で暗号化されます。
- OAuth 2.1 と PKCE、および 動的クライアント登録(RFC 7591)を使用します。共有シークレット、クライアントシークレット、ディスク上の API キーはありません。
- 同意はワークスペースごとに行われます。 各トークンはサインイン時に選択した1つのワークスペースに紐付けられるため、アシスタントが別のワークスペースにアクセスすることはできません。
- スコープが境界になります。 ユーザーが許可していないスコープを必要とするツールは、不足しているスコープを示す
403を返します。 - データアクセスには、ユーザーが Orangescrum ですでに持っているロールとプロジェクトメンバーシップが適用されます。ユーザーが閲覧できないプロジェクトは、見つからないものとして扱われます。
- トークンの有効期間は短く設定されています。 アクセストークンの有効期間は1時間、リフレッシュトークンの有効期間は30日で、交換のたびにローテーションされます。
セキュリティモデルと管理者向け制御の詳細については、次を参照してください。
仕組み
アーキテクチャと通信
-
対応クライアントがサーバーエンドポイントに接続します。
https://mcp.orangescrum.com/mcp/partnerサーバーは Streamable HTTP 上で JSON-RPC 2.0 を使用し、MCP プロトコルのリビジョン
2025-11-25、2025-06-18、2025-03-26、2024-11-05をネゴシエートします。 -
最初の未認証リクエストは、
WWW-Authenticateヘッダー付きの401を返します。クライアントは/.well-known/oauth-protected-resourceと/.well-known/oauth-authorization-serverを読み取り、自身を登録してブラウザーを開きます。 -
ユーザーがサインインし、ワークスペースを選択して、スコープを承認します。クライアントは、PKCE 検証子を添えて認可コードをアクセストークンとリフレッシュトークンに交換します。
-
以降のすべてのリクエストには
Authorization: Bearer <access-token>が付加され、クライアントはバックグラウンドでトークンを自動的にリフレッシュします。
権限管理
アクセスできるのは、ユーザーが Orangescrum ですでに閲覧権限を持っているデータのみです。スコープを使用するには、ワークスペースでそのスコープが許可されていることと、ユーザーが同意画面で承認することの両方が必要です。クライアントがワークスペースで許可されている範囲を超えて要求した場合、拒否されるのではなく、許可されている範囲に制限されます。
レート制限
リクエストには、分単位および日単位のレート制限があります。429 レスポンスが返された場合は、制限に達しています。適切に動作するクライアントは、待機してから再試行します。レート制限を参照してください。
ワークフローの例
接続すると、クライアントから次のようなタスクを実行できます。
プロジェクト、タスク、ユーザー
- 検索:「Project Apollo で、優先度が高く未完了のタスクをすべて見つけてください。」
- 作成/更新:「『Redesign onboarding』というタイトルのタスクを作成し、Priya に割り当ててください。」
- 一括作成:「これらのメモからタスクを5件作成してください。」
- ユーザー:「ワークスペースのユーザー一覧を表示し、Priya に割り当てられている内容を示してください。」
スプリントとバックログ
- ステータス:「Project Apollo の現在のスプリントの進捗状況はどうですか?」
- 計画:「この仕様をエピック、機能、ストーリーに分割してください。」
- 作業の移動:「この3つのストーリーを次のスプリントに割り当ててください。」
テストケース管理
- 報告:「ステージングで先ほど発生したチェックアウトのタイムアウトについて、重大な不具合を報告してください。」
- 実行:「昨日の回帰テストで失敗したテストをすべて再実行してください。」
- 比較:「この実行結果を前回のベースラインと比較してください。」
リリース
- 準備状況:「リリース4.2の準備はできていますか?まだ何が妨げになっていますか?」
- リリースノート:「リリース4.2のリリースノートを作成してください。」
- カレンダー:「今月、ブラックアウト期間に該当するリリースはどれですか?」
人員と時間
- タイムログ:「タスク1482に今日の作業時間として2時間を記録してください。」
- キャパシティ:「来週、プラットフォームチームで負荷が高すぎる人は誰ですか?」
- 休暇:「金曜日に休暇を申請し、残りの日数を表示してください。」
複合タスク
- 作業の関連付け:「この3つのタスクをリリース4.2に関連付け、チェックリストにも追加してください。」
- ドキュメントの検索:「アップロード済みのドキュメントから、API のレート制限ポリシーを検索してください。」
- 作業の進行:「タスク1482を『レビュー中』に移動し、PR が作成済みであることをコメントに追加してください。」
メモ
実際に利用できる機能は、スコープ、役割、ワークスペースのプラン、クライアントプラットフォームによって異なります。
ヒントとコツ
デフォルトのワークスペースコンテキストを設定する
以下の Markdown を AGENTS.md に追加すると、探索のための呼び出しを減らし、時間とトークンを節約し、結果セットを小さくできます。
## Orangescrum MCP
When connected to orangescrum:
- **MUST** use project_id = "YOUR_PROJECT_ID" unless I name another project
- **MUST** use `limit: 20` for ALL list and search tools
- **MUST** call get_current_user once and reuse the user id instead of looking it up again
- **MUST** ask before any delete_* tool
プロジェクトコンテキストを保存する
add_project_context ツールを使用して、アシスタントがプロジェクトについて常に把握しておくべき情報(完了の定義、命名規則、担当者など)を保存します。後のセッションでは、get_project_context とプロジェクトコンテキストリソースを使ってそれらを取得できます。
スキルを使う
Claude などのデスクトップクライアントを使用している場合、繰り返し行うタスク用のスキルを作成したり、既存のスキルを再利用したりできます。Orangescrum MCP のデフォルトスキルを参照してください。
組み込みプロンプトを使う
daily_standup を実行すると自分の作業のスタンドアップサマリーが表示され、overdue_report を実行すると期限を過ぎた項目がすべて表示されます。
管理者向けメモ:アクセスの管理
組織で Orangescrum MCP Server を使用する準備をしている管理者は、以下の項目を確認してください。
アクセスの管理、監視、取り消し
- ワークスペースで MCP を有効にする: MCP は、会社で有効化され、許可するスコープが選択されるまでオフになっています。有効化されるまでは、誰がサインインしても、すべての認可リクエストが拒否されます。有効化するには、[email protected] またはアカウントマネージャーにお問い合わせください。
- スコープの上限: ワークスペースで許可されているスコープが、各ユーザーに付与できるスコープの上限です。慎重に導入する場合は、読み取り専用のスコープに絞ってください。
- 即時の取り消し: ワークスペースの利用資格を無効にすると、処理中のトークンは次のリクエストで直ちに無効になります。トークンの有効期限が切れるまで待つ必要はありません。
- エンドユーザーによる制御: 個々のユーザーは、クライアントから接続をいつでも解除できます。新たにサインインし直すには、サーバーを削除して再追加してください。
- 監査ログ: すべてのツール呼び出しは、ユーザー、ワークスペース、ステータスコード、応答時間とともに監査証跡に記録されます。
よくある問題のトラブルシューティング
- サインインページがループする、または認可が完了しない。 初回接続で最もよくある原因は、所属するどのワークスペースでも MCP が有効になっておらず、同意画面に選択肢が表示されないことです。管理者に有効化を依頼してください。クライアントが開いたブラウザーでポップアップやサードパーティー Cookie がブロックされている場合も、フローが停止することがあります。
- ツールがスコープ名を示す 403 を返す。 トークンの認証は正常に完了していますが、その機能に必要な権限が付与されていません。再接続してスコープを承認してください。同意画面に表示されない場合、そのスコープはワークスペースでまだ許可されていません。
- 存在するとわかっているプロジェクトがアシスタントに表示されない。 トークンは 1 つのワークスペースに紐付いています。もう一度接続し、別のワークスペースを選択してください。
詳細については、トラブルシューティングをご覧ください。
セキュリティ
Model Context Protocol(MCP)を使うと、AI エージェントはアカウントの権限でツールや Orangescrum のデータに接続できます。強力なワークフローを実現できる一方、構造的なリスクも生じます。有効にした MCP クライアントやサーバー(IDE プラグイン、デスクトップアプリ、ホスト型 MCP サーバー、「ワンクリック」連携など)は、いずれも AI エージェントに代わりに操作を実行させる可能性があります。
大規模言語モデル(LLM)は、プロンプトインジェクションや関連する攻撃(間接プロンプトインジェクションやツールポイズニングなど)の影響を受けやすくなっています。こうした攻撃により、明示的な依頼がなくても、エージェントがデータを外部に流出させたり、意図しない変更を加えたりするよう指示される可能性があります。
リスクを軽減するため、信頼できる MCP クライアントとサーバーのみを使用し、各エージェントがアクセスできるツールとデータを注意深く確認して、最小権限を適用してください(まずは読み取り専用スコープを使用し、試行には重要度の低いワークスペースを使います)。影響の大きい操作や破壊的な操作には、人間による確認を必須とし、監査証跡を監視して不審な活動がないか確認してください。脆弱性を報告するには、SECURITY.mdをご覧ください。
サポートとフィードバック
Orangescrum MCP Server の改善に、皆さまからのフィードバックを活用しています。不具合や制限事項がある場合、または提案がある場合は、次の方法をご利用ください。
- Orangescrum ヘルプセンターのMCP ガイドをお読みください。
- ホスト型サーバー、サインイン、スコープ、ワークスペースに関する問題は、[email protected]までメールでお問い合わせください。
- このリポジトリ内の内容(ドキュメント、マニフェスト、レジストリエントリー、スキルなど)については、issueを作成してください。
免責事項
MCP クライアントは、既存の権限で Orangescrum 上の操作を実行できます。最小権限を適用し、影響の大きい変更は確認前に見直し、監査証跡を監視して不審な活動がないか確認してください。
この README に掲載されている AI クライアントの製品名およびロゴは、それぞれの所有者の商標です。これらは、このサーバーが対応するクライアントを識別する目的でのみ使用しており、推奨を意味するものではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。