sdp-remote-mcp

OpenText Model Context Protocol サーバー

OpenText のデリバリー製品に組み込まれた、公式の Model Context Protocol サーバーです。ローカルプロキシや追加プロセスは必要ありません。有効にすると、AI ツールからバックログ、作業項目、デリバリーデータにリアルタイムで読み書きできるようになります。認証には OAuth 2.1 または API アクセスキーを使用するため、すべての操作でユーザーの既存のワークスペース権限が尊重されます。

---

ガイドを選択

このリポジトリでは、2 つの製品について説明しています。どちらも同じプロトコル、ツールセット、クライアント設定を共有していますが、異なるドキュメントベースとリリース系列を基に構築されています。お使いのデプロイに合ったガイドを選択してください。

お使いのデプロイ	別名	ガイド
Core Software Delivery Platform	OpenText ValueEdge	README-Core-Software-Delivery-Platform.md
Software Delivery Management	OpenText ALM Octane	README-Software-Delivery-Management.md

---

目次

• ガイドを選択
• サーバーの機能
• できること
• 対応ツール
• 共通の前提条件
• 共通のセットアップ概要
• セキュリティ
• サポートとフィードバック

---

サーバーの機能

Model Context Protocol サーバーは製品に組み込まれており、/mcp パスの HTTPS 経由でアクセスできます。

プロトコル	ステートレス HTTP — ツール呼び出しには POST、エンドポイントの検出には GET を使用。JSON-RPC 2.0
認証	OAuth 2.1（対話型ブラウザーフロー）・API アクセスキー（ヘッドレスまたはサービスでの利用）
ホスティング	製品に組み込み — オンプレミスおよびクラウド
権限	すべての操作は、認証済みユーザーのワークスペースアクセス権の範囲内で実行されます

---

できること

AI クライアントをワークスペースに接続すれば、IDE を離れることなくデリバリーデータを操作できます。

機能	プロンプトの例
検索と絞り込み	「現在のスプリントで、自分に割り当てられている未解決の不具合をすべて一覧表示してください。」
キーワードで検索	「バックログ内でパフォーマンスに言及しているストーリーをすべて検索してください。」
作業項目の作成	「この会議メモからユーザーストーリーを 5 件作成してください。」
エンティティの更新	「ストーリー #1042 の説明を、これらの受け入れ条件で更新してください。」
メタデータの確認	「Feature エンティティにはどのようなフィールドがありますか？」
ステータスの確認	「エピック #205 の現在のステータスは何ですか？」

---

対応ツール

どちらの製品も同じツールセットを提供します。

ツール	説明
get_entity_types	ワークスペースで使用できるエンティティタイプを一覧表示します
get_filter_metadata	フィルター構文と対応する演算子を返します
get_entity_field_metadata	エンティティタイプのフィールドとフィールドタイプを表示します
get_entities	オプションの絞り込み、検索、並べ替え、ページネーションを指定してエンティティを一覧表示します
get_entity	識別子で単一のエンティティを取得します
create_entity	新しいエンティティを作成します
update_entity	既存のエンティティの指定したフィールドを更新します

---

共通の前提条件

以下は両製品に共通です。

• オンプレミスまたはクラウドの、稼働中の製品サイト
• OpenText 管理者によって有効化された Model Context Protocol 機能
• サポート対象の AI クライアントのいずれか：GitHub Copilot を備えた Visual Studio Code、GitHub Copilot を備えた IntelliJ、Claude Desktop、または Cursor
• OAuth 2.1 の場合：サインインのフローを完了するための最新のブラウザー
• アクセスキーの場合：対象のワークスペースで生成された API アクセストークン
• 接続するエージェントまたはユーザーごとの Aviator AI ライセンス
• 各接続では、ワークスペースにアクセスする通常のユーザーと同様に、名前付きユーザーライセンスを消費します

---

共通のセットアップ概要

詳細でリンクを正確に記載した手順は、各製品のガイドにあります。大まかな手順は、両製品で同じです。

1. 機能を有効にします。 サイト管理者がサポートチケットを送信し、サイトまたはテナントで Model Context Protocol を有効にしてもらいます。
2. 認証方法を選択します。 対話型クライアントには OAuth 2.1 を、ヘッドレス環境やサービス環境にはアクセスキーを使用します。
3. OAuth 2.1 の場合のみ、各クライアントのリダイレクトアドレスを含めて、OAUTH_AUTHORIZATION_SERVER_CLIENTS サイトパラメーターにクライアントを登録します。
4. サーバーアドレスと選択した認証情報を使って、AI クライアントを設定します。
5. クライアントで利用可能なツールを一覧表示し、接続を確認します。

OpenText ValueEdge については README-Core-Software-Delivery-Platform.md、OpenText ALM Octane については README-Software-Delivery-Management.md をご覧ください。

---

セキュリティ

すべての通信は、TLS 1.2 以降を使用した HTTPS によって転送中に暗号化されます。アクセスは認証済みユーザーが既に持っているワークスペース権限の範囲内に厳密に制限されます。サーバーがユーザーの既存の権限を超えるアクセスを許可することはありません。

注意： 設定ファイルにアクセストークンをプレーンテキストで埋め込まないでください。クライアントが対応している場合は、代わりに環境変数またはクライアント管理の入力変数を使用してください。

サーバーの使用には、OpenText agreements page で確認できる OpenText エンドユーザーライセンス契約と、導入環境に適用されるサービス内容の説明が適用されます。

---

サポートとフィードバック

• サポートチケット： OpenText Support Portal
• コミュニティ： 機能リクエストは OpenText Community Ideas から送信してください。

---

免責事項

サーバーは、認証済みユーザーの権限で製品上の操作を実行します。最小権限を適用し、影響の大きい変更は確定前に確認し、不審なアクティビティがないか監査ログを監視してください。