mcpField
O
Orangescrum MCP Server

Orangescrum MCP Server

リモート
helpdesk.orangescrum.com生産性35 日前に更新
リポジトリ公式サイト

Orangescrum MCP Server について

Orangescrum MCP Server は、プロジェクトマネージャー、開発者、QA チーム、デリバリーリード向けに、AI ツールを Orangescrum ワークスペースへ接続します。プロジェクト遂行、テスト、リリース、リスク、ワークスペース内コンテンツをリアルタイムで読み書きでき、OAuth 2.1 によりログインユーザーの権限が適用されます。

主な機能

  1. 01プロジェクト項目の読み取りと更新
  2. 02テストケースとリリースの管理
  3. 03スプリントとScaled Agileの計画
  4. 04リスク、リソース、勤怠へのアクセス
  5. 05Wikiページとドキュメントの検索
  6. 06OAuth 2.1によるワークスペース権限の適用

活用シーン

  1. 01会議メモからタスクを作成
  2. 02仕様からバックログを作成
  3. 03スプリントとリリース準備状況の確認
  4. 04AIツールからプロジェクト情報を検索

MCP 対応

ホスト型MCPサーバーとして、Streamable HTTPとOAuthを介してOrangescrumのデータや操作を対応クライアントに公開します。クライアントで利用できるプロンプトとリソースも提供します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.orangescrum.com/mcp/partner
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

Orangescrum

Orangescrum MCP サーバー

Orangescrum 公式の Model Context Protocol(MCP)サーバーです。クラウドホスト型のブリッジとして、AI ツールから Orangescrum ワークスペース内のプロジェクト、タスク、ユーザー、スプリント、テストケース管理、リリース、スケールドアジャイル、リスク、リソース、勤怠、休暇管理、ナレッジベース(Wiki)、ドキュメントに安全かつリアルタイムにアクセスできます。

Orangescrum 公式サーバー GitHub のスター数 ライセンス:Apache 2.0 ステータス:一般提供

Model Context Protocol 互換 MCP レジストリ:com.orangescrum 認証:PKCE を使用する OAuth 2.1 ホスティング:Orangescrum Cloud

プロジェクト タスク ユーザー スプリント テストケース管理 リリース スケールドアジャイル リスク管理 リソース 勤怠と休暇 チェックリスト ナレッジベースと 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 設定を手動で編集する必要はありません。それ以外のボタンをクリックすると、そのクライアントの手順ガイドが開きます。

README の画像
Claude

Custom connector
README の画像
Claude Code

One command
README の画像
Codex

One command
README の画像
ChatGPT

Custom connector
README の画像
VS Code

One-click install
README の画像
OpenCode

One command
README の画像
Gemini

Custom app
README の画像
Antigravity

IDE and CLI
README の画像
Perplexity

Custom connector
README の画像
Cursor

One-click install
README の画像
Muse

Chat prompt
README の画像
Hermes Agent

config.yaml
README の画像
OpenClaw

One command
README の画像
GitHub Copilot

CLI and IDE
README の画像
Grok

Custom connector
README の画像
Kiro

One-click install
README の画像
Devin Desktop

Settings
README の画像
Zed

Settings
README の画像
LM Studio

mcp.json
README の画像
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には、エージェントが自身のクライアントの手順を確認し、ほかの設定には触れずにサーバーを追加し、サインインをユーザーに引き継ぎ、接続を確認する方法が記載されています。

または、サーバーを自分で追加してください。

クライアントコマンドまたは設定
README の画像 Claude Codeclaude mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partnerを実行し、続けて/mcpでサインインします
README の画像 Codex CLIcodex mcp add orangescrum --url https://mcp.orangescrum.com/mcp/partnerを実行し、続けてcodex mcp login orangescrumを実行します
README の画像 OpenCode{"mcp": {"orangescrum": {"type": "remote", "url": "https://mcp.orangescrum.com/mcp/partner"}}}をopencode.jsonに追加し、続けてopencode mcp auth orangescrumを実行します
README の画像 GitHub Copilot CLIcopilot mcp add --transport http orangescrum https://mcp.orangescrum.com/mcp/partnerを実行し、続けて/mcp authを実行します
README の画像 Cursor{"mcpServers": {"orangescrum": {"url": "https://mcp.orangescrum.com/mcp/partner"}}}を~/.cursor/mcp.jsonに追加します
README の画像 VS Code{"servers": {"orangescrum": {"type": "http", "url": "https://mcp.orangescrum.com/mcp/partner"}}}を.vscode/mcp.jsonに追加します
README の画像 Google Antigravity{"mcpServers": {"orangescrum": {"serverUrl": "https://mcp.orangescrum.com/mcp/partner"}}}を~/.gemini/config/mcp_config.jsonに追加します
README の画像 Claude.ai / Claude DesktopCustomize → Connectors → + Add → Add custom connectorを選び、名前にOrangescrumを指定して、サーバー URL を貼り付けます
README の画像 ChatGPTchatgpt.com/plugins → + → Add custom MCP serverを選び、サーバー URL を貼り付けて、OAuthを選択します
README の画像 Gemini appSettings → Connected Apps → Custom appsを選び、サーバー URL を貼り付けてサインインします
README の画像 Grokgrok.com/connectors → New Connector → Customを選び、サーバー URL を貼り付けてサインインします
README の画像 PerplexityPlugins → Add custom → Add MCP connector → Remoteを選び、サーバー URL を貼り付けて、OAuth 2.0を選択します
README の画像 Orca、T3 Code、その他のエージェントオーケストレーター実行する各エージェントにサーバーを追加します(エージェントオーケストレーターを参照)
README の画像 n8n、Zapier、Make、Dify、エージェント SDKオーケストレーションツールと SDKを参照してください
README の画像 その他の MCP クライアントサーバー URL https://mcp.orangescrum.com/mcp/partnerを使用するか、INSTALL.mdを参照してください

目次


対応クライアント

Orangescrum MCP Server は、OAuth を使用した Streamable HTTP 経由のリモート MCP に対応するすべてのクライアントで動作します。70 種類以上のクライアント向けに、手順を追ったセットアップガイドを用意しています。

ガイド対象
コーディングエージェントと IDEClaude 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
オーケストレーションツールと SDKn8n、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.mdAI エージェントが読み取って、自身のセットアップに使用できる手順

また、このサーバーは mcp-remote プロキシを通じて、ローカルの STDIO 専用 MCP クライアントにも対応します。プロキシは localhost で実行され、ブラウザーで OAuth フローを完了し、リクエストをホストされたサーバーに転送します。

メモ

Microsoft 365 Copilot 宣言型エージェントと Gemini Enterprise は、まだ対応していません。どちらも OAuth クライアントシークレットを必要としますが、このサーバーはシークレットなしで公開クライアントを登録します。

ヒント

ホスト型アプリのメニューは頻繁に変わります。手順が表示内容と異なる場合は、クライアントのセットアップまたはクライアント独自の MCP ドキュメントを確認してください。

プラグインのパッケージ形式と互換性

このリポジトリでは、クライアントがそれぞれのネイティブな検出・インストールフローを利用できるよう、同じ MCP サーバーとスキルを複数のパッケージ形式で公開しています。

形式マニフェストと設定共通コンポーネント
Agent Plugins v1plugin.json および mcp.jsonskills/
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 Registryserver.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 スコープがあります。ユーザーは同意画面でスコープを承認し、ワークスペース管理者は付与可能なスコープの上限を設定します。

モジュールツールスコープ
プロジェクト5mcp:projects.read · mcp:projects.write
タスク:コメント、依存関係、リンク、ラベル、添付ファイル、ステータス、タイプ27mcp:tasks.read · mcp:tasks.write
ユーザー3mcp:users.read
テストケース管理:ケース、スイート、計画、実行、シナリオ、戦略、ベースライン、データセット、不具合69mcp:tests.read · mcp:tests.write
バージョンとリリース:項目、準備状況、承認、リリースノート、依存関係、リリース開始チェックリスト、ブラックアウト期間、顧客への影響、テンプレート、分析60mcp:releases.read · mcp:releases.write
スケールドアジャイル:リリーストレイン、プログラムインクリメント、イテレーション、プログラムボード、PI 目標、ROAM リスク、信頼度投票、WSJF、Inspect and Adapt、フローメトリクス50mcp:safe.read · mcp:safe.write
リスク管理:リスクレジスター、ワークフロー、コメント、リンク、ウォッチャー、承認、ヒートマップ、レポート27mcp:risks.read · mcp:risks.write
チェックリスト:グループ、項目、テンプレート、項目ごとのチェックリスト20mcp:checklists.read · mcp:checklists.write
休暇:休暇の種類、残日数、休日、申請、承認、レポート12mcp:leaves.read · mcp:leaves.write
リソース管理:稼働状況、キャパシティ、稼働率、アロケーションレポート、スキル8mcp:resources.read
スプリント7mcp:sprints.read · mcp:sprints.write
勤怠:出退勤の打刻、記録、チームのステータス、ダッシュボード、レポート7mcp:attendance.read · mcp:attendance.write
バックログ階層:エピック、フィーチャー、ストーリー、サブタスク5mcp:epics.read · mcp:epics.write
ナレッジベース(Wiki):棚、ブック、ページツリー、ページ、バージョン、コメント、添付ファイル、バックリンク、アクションアイテム、レビュー、作業項目へのリンク、検索36mcp:wiki.read · mcp:wiki.write
タイムログ3mcp:timelogs.read · mcp:timelogs.write
プロジェクトコンテキスト(「メモリー」)2mcp:context.read · mcp:context.write
ドキュメント管理:アップロード済みドキュメントの横断検索(RAG)1mcp: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日で、交換のたびにローテーションされます。

セキュリティモデルと管理者向け制御の詳細については、次を参照してください。


仕組み

アーキテクチャと通信
  1. 対応クライアントがサーバーエンドポイントに接続します。

    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 をネゴシエートします。

  2. 最初の未認証リクエストは、WWW-Authenticate ヘッダー付きの 401 を返します。クライアントは /.well-known/oauth-protected-resource と /.well-known/oauth-authorization-server を読み取り、自身を登録してブラウザーを開きます。

  3. ユーザーがサインインし、ワークスペースを選択して、スコープを承認します。クライアントは、PKCE 検証子を添えて認可コードをアクセストークンとリフレッシュトークンに交換します。

  4. 以降のすべてのリクエストには 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 クライアントの製品名およびロゴは、それぞれの所有者の商標です。これらは、このサーバーが対応するクライアントを識別する目的でのみ使用しており、推奨を意味するものではありません。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。