Polarion MCP について
Polarion MCPは、Polarion ALMを扱うAIアシスタント向けのMCPサーバーです。ドキュメント、作業項目、テスト実行、トレーサビリティリンクを読み書きでき、書き込み前の検証とdry_runに対応します。
主な機能
- 01ドキュメントと作業項目の読み取り・検索
- 02テスト実行と記録の作成・更新
- 03トレーサビリティリンク、コメント、添付ファイルの管理
- 04書き込みの事前検証とdry_run
- 05リクエストの調整と自動リトライ
活用シーン
- 01要件を検索して関連ドキュメントを確認
- 02作業項目を更新してワークフロー状態を変更
- 03テスト結果を記録し検証リンクを管理
- 04ドキュメント構成を整理してコメントに対応
MCP 対応
MCPサーバーは、Polarionのドキュメント、作業項目、テスト実行、トレーサビリティリンク、コメント、添付ファイルを読み書きするツールを提供します。Polarion 2506以降に接続します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx mcp-server-polarionPOLARION_URLBase URL of the Polarion serverPOLARION_TOKENシークレットPolarion personal access tokenPOLARION_MAX_REQUESTS_PER_SECONDClient-side request rate cap in requests per second; match your deployment's throttle. 0 disables pacing (default: 1)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
46掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | Polarion プロジェクト ID。 |
| space_id | string | はい | スペース ID(「_default」= デフォルトスペース)。 |
| document_name | string | はい | space_id 内のドキュメント名。 |
| page_size | integer | いいえ | |
| page_number | integer | いいえ |
詳細
mcp-server-polarion
Polarion と対話できます。AI がドキュメント、作業項目、テスト実行、トレーサビリティリンクを読み取り、書き込み、再編成します。
Model Context Protocol(MCP)に対応するPolarion ALM向けサーバーです。実運用のインスタンスを想定しており、すべての書き込みでdry_runを利用できます。変更を確定する前にガードがフィールドと列挙値を検証し、リクエストはインスタンスに合わせて設定したレート上限に従って送信されるため、AI アシスタントが予期せぬ事態を招くことなく本番データを操作できます。

機能
- 46 個のツールで、ドキュメント、作業項目、テスト実行、トレーサビリティリンク、コメント、添付ファイルの読み取りと書き込みに対応します。
- 読み取り — ドキュメントを Markdown としてレンダリングし、Lucene または SQL で検索し、受信/送信リンクをたどり、列挙型の選択肢を解決します。
- 書き込み — 作業項目、ドキュメント、テスト実行の作成と更新、リンクの管理、ドキュメント構造の再編成、コメントの投稿ができます。
- 安全な書き込み — すべての書き込みツールで
dry_runを利用でき、Polarion に変更を加える前に、事前書き込みガードがフィールド、列挙値、リンク先を検証します。 - サーバーと円滑に連携 — リクエストは直列化され、設定可能なレート上限に従って送信されます。429/5xx 応答があった場合は自動的に再試行します。
- LLM 向けに設計 — 厳密な非同期処理と完全な型付けを採用し、すべての一覧表示ツールでページネーションに対応しています。docstring はアシスタント向けのマニュアルとして記述されています。
クイックスタート
Polarion 2506 以降とuvが必要です。詳しくは前提条件をご覧ください。最も手早く始めるには、Claude Code を使用します。
claude mcp add mcp-server-polarion \
-e POLARION_URL=https://polarion.example.com \
-e POLARION_TOKEN=your-personal-access-token \
-- uvx mcp-server-polarion
その他のクライアント(VS Code、Claude Desktop、Cursor)については、クライアントの設定をご覧ください。
ツール
読み取り
| ツール | 説明 |
|---|---|
list_projects | アクセス可能なプロジェクトを一覧表示します |
list_documents | プロジェクト内のドキュメントを一覧表示します |
list_work_items | プロジェクト内の作業項目を一覧表示します(Lucene/SQL クエリ) |
list_test_runs | プロジェクト内のテスト実行を一覧表示します(Lucene クエリ、テンプレートによるフィルタリング) |
get_test_run | テスト実行の詳細を取得します。オプションで生の HTML レポート本文も取得できます |
list_test_records | テスト実行の実行記録を一覧表示します。テストケースの各反復につき 1 件です |
get_test_record | 1 件のテスト記録の実行コメントとテストケースのリビジョンを取得します |
get_sql_query_recipes | 高度なクエリ用のコピー&ペースト可能な SQL レシピを取得します |
get_html_recipes | 生の HTML 本文を編集するためのコピー&ペースト可能な Polarion HTML テンプレートを取得します |
get_document | ドキュメントのメタデータを取得します。オプションで生の本文 HTML も取得できます |
read_document | ドキュメント全体を Markdown としてレンダリングします |
read_document_parts | 埋め込みの作業項目メタデータとともに、ドキュメントの構造部分を一覧表示します |
get_work_item | 本文を生の HTML として、作業項目の詳細を取得します |
read_work_item | 本文を Markdown として、作業項目の詳細を取得します |
list_work_item_links | 作業項目の発信リンクまたは着信リンクを一覧表示します |
list_document_attachments | ファイル名、サイズ、作成者とともに、ドキュメントの添付ファイルを一覧表示します |
get_document_attachment_content | 表示用に画像の添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得) |
list_work_item_attachments | ファイル名、サイズ、作成者とともに、作業項目の添付ファイルを一覧表示します |
get_work_item_attachment_content | 表示用に作業項目の画像添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得) |
list_test_record_attachments | ファイル名、サイズ、作成者とともに、テスト記録の添付ファイルを一覧表示します |
get_test_record_attachment_content | 表示用にテスト記録の画像添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得) |
list_document_comments | スレッドの関連情報とともに、ドキュメントのコメントを一覧表示します |
list_work_item_comments | スレッドの関連情報とともに、作業項目のコメントを一覧表示します |
list_document_enum_options | ドキュメントのフィールドで有効な列挙型 ID を解決します |
list_work_item_enum_options | 作業項目のフィールドで有効な列挙型 ID を解決します |
すべての一覧表示ツールは、page_size(1~100)および page_number パラメーターによるページネーションに対応しています。
書き込み
| ツール | 説明 |
|---|---|
create_work_items | 1 回のリクエストで 1 件以上の作業項目を作成します |
update_work_items | 1 件以上の作業項目のフィールド、本文、またはワークフローのステータスを更新します |
create_document | 新しいドキュメントを作成します |
update_document | ドキュメントのメタデータ、本文、またはワークフローのステータスを更新します |
copy_document | ドキュメントを新しい名前、スペース、またはプロジェクトにコピーします |
create_test_runs | テンプレートを使用するかどうかを指定して、1 件以上のテスト実行を作成します |
create_test_records | テスト実行にテストケースの実行結果を記録します |
update_test_runs | 1 件以上のテスト実行のタイトル、ステータス、グループ、またはカスタムフィールドを更新します |
update_test_records | テスト実行の 1 件以上のテスト記録について、結果、コメント、または不具合へのリンクを更新します |
create_work_item_links | ソースの作業項目から 1 件以上の発信リンクを作成します |
update_work_item_link | 1 件の発信リンクの suspect / revision を更新します |
delete_work_item_links | ソースの作業項目から 1 件以上の発信リンクを削除します |
move_work_item_to_document | 指定した位置に作業項目をドキュメントへ添付します |
move_work_item_from_document | 作業項目をドキュメントから切り離します |
create_document_attachments | 1 件以上のローカルファイルをドキュメントの添付ファイルとしてアップロードします |
create_work_item_attachments | 1 件以上のローカルファイルを作業項目の添付ファイルとしてアップロードします |
create_test_record_attachments | 1 件以上のローカルファイルをテスト記録の添付ファイルとしてアップロードします |
create_document_comments | ドキュメントに 1 件以上のコメントまたは返信を追加します |
create_work_item_comments | 作業項目に 1 件以上のコメントまたは返信を追加します |
update_document_comment | ドキュメントのコメントを解決済みにするか、再度開きます |
update_work_item_comment | 作業項目のコメントを解決済みにするか、再度開きます |
プロンプトの例
探索と検索
「アクセスできるプロジェクトを一覧表示してから、プロジェクト MCPT のドキュメントを種類とともに表示してください。」
「プロジェクト MCPT のスペース『Specifications』にあるドキュメントを一覧表示してください。」
「プロジェクト MCPT で、タイトルが『Auth』で始まる承認済みの要件をすべて検索し、それぞれの所有ドキュメントを表示してください。」
「プロジェクト MCPT で、カスタムフィールド『verification_method』が『Test』の作業項目を検索してください。結合が必要な場合は、まず SQL のレシピを取得してください。」
「プロジェクト MCPT の SRS モジュールで、直近のスプリント中に変更された作業項目をすべて検索してください。」
読み取りと要約
「プロジェクト MCPT の SRS ドキュメントを読み、未完了の各要件を要約してください。」
「SRS ドキュメントの構成を、見出しと各見出しの下にある作業項目とともに表示してください。」
「作業項目 MCPT-042 を Markdown として表示し、要求内容を説明してください。」
「MCPT-042 の発信リンクと着信リンクを表示し、未完了の子タスクがあれば示してください。」
「SRS ドキュメント内で、テストケースから『verifies』のバックリンクがない要件はどれですか?」
「SRS ドキュメントの未解決のコメントスレッドを一覧表示し、それぞれの開始者を示してください。」
作成と編集
「プロジェクト MCPT に『Refactor authentication module』というタイトルのタスクを作成し、MCPT-042 に『relates_to』としてリンクしてください。」
「このチェックリストから、プロジェクト MCPT にテストケースの作業項目を3つ作成し、それぞれを MCPT-042 に『verifies』としてリンクしてください。」
「先ほど作成した本文を使って、SRS ドキュメントのセクション 3.2 の下に新しい要件を追加してください。」
「貼り付ける改訂版のテキストで MCPT-042 の説明を更新し、既存の書式を維持してください。」
「SRS ドキュメントに、セクション 4 の説明を求めるコメントを追加してから、スレッド T-12 に返信し、解決済みとしてマークしてください。」
「『Regression』テンプレートから、ステータス『open』のテスト実行 REG-SPRINT-7 をプロジェクト MCPT に作成してください。」
ワークフローと再編成
「プロジェクト MCPT の不具合に有効なステータス値を一覧表示してから、MCPT-077 を『in_review』に移してください。」
「MCPT-042 の優先度を 90 に上げ、重大度を『major』に設定して、ワークフローを承認してください。」
「MCPT-201 をタスクから要件に変更し、以前のステータスを再適用してください。」
「MCPT-201 を SRS ドキュメント内の MCPT-150 の直後に移してください。」
「MCPT-077 をドキュメントから切り離し、単独のタスクとして作業できるようにしてください。」
「MCPT-042 から MCPT-099 への『blocks』リンクを要確認としてマークし、古い MCPT-010 への『relates_to』リンクを削除してください。」
セットアップ
前提条件
Polarion 2506 以降が必要です。それ以前のバージョンには、このサーバーが依存する REST API エンドポイントがありません。
このサーバーは Python パッケージとして配布されており、実行には uv が必要です。
uv をインストール(まだインストールされていない場合):
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
または pip を使用:
pip install uv
ほかにインストールするものはありません。uvx mcp-server-polarion を実行すると、サーバーが自動的にダウンロードされて起動します。
環境変数
| 変数 | 説明 | 例 |
|---|---|---|
POLARION_URL | Polarion インスタンスのベース URL | https://polarion.example.com |
POLARION_TOKEN | 認証用のパーソナルアクセストークン | your-personal-access-token |
POLARION_MAX_REQUESTS_PER_SECOND | 任意。クライアント側のリクエストレート上限です。デプロイ環境のスロットリングに合わせて値を上げるか、ペーシングを無効にするには 0 を設定します。書き込みには、これとは別に一定の追加待機時間が適用されます(デフォルト:1) | 1 |
パーソナルアクセストークンを生成するには、Polarion を開き、ユーザー名をクリックして、My Account → Personal Access Tokens に移動してください。
クライアント設定
VS Code(GitHub Copilot)
.vscode/mcp.json に追加します:
{
"servers": {
"mcp-server-polarion": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Claude Desktop
claude_desktop_config.json に追加します:
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Cursor
Cursor の MCP 設定に追加します:
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Claude Code
claude mcp add コマンドで登録します:
claude mcp add mcp-server-polarion \
-e POLARION_URL=https://polarion.example.com \
-e POLARION_TOKEN=your-personal-access-token \
-- uvx mcp-server-polarion
貢献
バグ報告やプルリクエストを歓迎します。ブランチ、コミット、レビューの規約については、CONTRIBUTING.md をご覧ください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。