ONES

GitHub Copilot 向け ONES MCP

GitHub Copilot を ONES に接続して、認可されたワークスペースでプロジェクトを管理し、ナレッジを活用できます。このリモート MCP サーバーとこのリポジトリは、ONES が管理しています。

機能

• プロジェクト、課題、スプリント、コメントの検索と管理。
• テストケースと工数記録の操作。
• Wiki ナレッジの作成と取得、および対応している添付ファイルの閲覧。

利用できるツールとアクションは、アカウントの権限と有効になっている ONES の機能によって異なります。

要件

• GitHub Copilot と MCP のサポートを有効にした VS Code。
• https://us.ones.com/mcp が提供するワークスペースにアクセスできる ONES アカウント。
• 組織のポリシーに基づいて MCP サーバーを使用する権限。

このエンドポイントは米国のデプロイメント向けです。他の地域やプライベート環境のデプロイメントでは、別の MCP エンドポイントが必要になる場合があります。接続前に、ワークスペースの MCP 設定を確認してください。

VS Code で接続する

1. コマンドパレットを開き、MCP: Add Server を実行します。
2. HTTP を選択し、https://us.ones.com/mcp を入力します。
3. サーバーに ones という名前を付けます。新しいワークスペース接続の場合は .mcp.json を選択し、複数のプロジェクトでアクセスする場合は、クライアントに表示されるグローバル設定オプションを選択します。
4. サーバーを起動し、確認を求められたら信頼を承認します。ブラウザーでの OAuth 認可を完了します。ONES にサインインし、要求されたアクセス権を確認してください。
5. ツールに対応したエージェントモードで Copilot Chat を開きます。Configure Tools を使って、ONES のツールが利用可能であることを確認します。

または、次の設定を使って、自分のプロジェクトのルートに .mcp.json を作成します。ファイルがすでに存在する場合は、mcpServers オブジェクトに ones エントリをマージしてください。

{
  "mcpServers": {
    "ones": {
      "type": "http",
      "url": "https://us.ones.com/mcp"
    }
  }
}

コピー可能な設定例：portable-mcp.json は上記の .mcp.json 形式を使用し、vscode-mcp.json は既存の .vscode/mcp.json 設定用に servers 形式を使用します。重複したエントリを避けるため、サーバーは 1 か所で設定してください。このリポジトリのクローンや、ローカル ONES サーバーの実行は必要ありません。

ONES は OAuth 認可を使用します。Git にコミットされる設定ファイルに、パスワード、アクセストークン、クライアントシークレットを記載しないでください。アクセス権は、認可された ONES ユーザーの権限に従います。

接続を確認する

設定を保存したら、MCP: List Servers を実行し、ones を選択して、必要に応じてサーバーを起動します。使用する ONES アカウントでブラウザー認可を完了してから、VS Code に戻ります。Copilot Chat で Configure Tools を開き、ONES のツールが利用可能で有効になっていることを確認してください。

最初に次のリクエストを送信します。

ONES を使って、アクセス可能なプロジェクトを一覧表示してください。データは変更しないでください。

確認が成功すると、実際にアクセス可能なプロジェクトの結果が返されるか、アカウントにアクセス可能なプロジェクトがない場合は、空の結果が明示的に返されます。ONES に関する一般的な回答では、ツール呼び出しを確認できません。Copilot のツール実行状況を展開し、ONES のツールが正常に実行されたことを確認してください。認可やツール呼び出しに失敗した場合は、以下のトラブルシューティング手順を参照してください。

Copilot Chat で ONES を使う

ツールに対応したチャットモードを選び、関連する ONES のツールを有効にします。作業したいプロジェクト、課題、または Wiki ページを指定してください。名前が曖昧な場合は、先に一致するレコードを表示するよう Copilot に依頼してください。以下の山括弧付きプレースホルダーは、自分の値に置き換えてください。

作業を検索して要約する

ONES を使って、<project name> という名前のプロジェクトを検索してください。複数のプロジェクトが一致する場合は、選択できるようにしてください。次に、そのプロジェクトで自分に割り当てられている課題を、タイトルとステータスとともに一覧表示してください。何も変更しないでください。

以降のリクエストでは、返された課題 ID を使用してください。

ONES の課題 <issue ID> を取得し、説明、ステータス、コメントを要約してください。

ワークスペースのナレッジを取得する

認可された ONES Wiki コンテンツから <release process> を検索してください。一致するページのタイトルを表示し、関連するページを取得して、リリース手順を要約してください。返された場合は、ソースページのリンクを含めてください。

結果は、認可されたアカウントがアクセスできる Wiki コンテンツによって異なります。

課題を作成する

ONES プロジェクト <project name> で、タイトルを <title>、説明を <description> とする課題を準備してください。不足している必須フィールドがあれば確認し、作成する前に対象プロジェクト、課題タイプ、入力予定のフィールドを提示してください。

提示された値を確認してから、Copilot に課題の作成を依頼してください。VS Code がツールの承認を求めた場合は、操作内容を確認してから承認してください。返された課題 ID を確認し、ONES で課題を開いて保存結果を検証してください。書き込み操作を評価する場合は、テストプロジェクトを使用してください。

既存の課題を更新する

ONES の課題 <issue ID> を取得してください。現在のステータスと選択可能な移行先ステータスを提示し、更新する前にどのステータスを使うか確認してください。

更新後、ONES でレコードを確認してください。利用できる操作と必須フィールドは、ワークスペースの設定とアカウントの権限によって異なります。

切断する

MCP: List Servers を使用して ones サーバーを停止します。接続設定を削除するには、選択した設定ファイルから該当するエントリーのみを削除してください。サーバーを停止したり、クライアント設定を削除したりしても、既存の OAuth 許可が取り消されるわけではありません。この認可は、ONES アカウントの設定で別途管理してください。

トラブルシューティング

• 認可に失敗する場合： ONES アカウントとワークスペースが、設定したデプロイメントに属していることを確認してから、再接続して OAuth を再度完了してください。
• ツールが表示されない場合： MCP: List Servers でサーバーの状態を確認し、その出力を確認してから、Copilot Chat のツール選択を確認してください。
• 操作が拒否される場合： 管理者に、ONES の権限とワークスペースで有効になっている機能を確認してください。
• MCP が制限されている場合： 組織の管理者に、このサーバーの使用が許可されているか確認してください。

再現可能な連携の問題については、クライアントのバージョンとサニタイズ済みのエラーメッセージを添えて、issue を作成してください。トークン、認証情報、非公開のワークスペースデータは絶対に含めないでください。

レジストリのメタデータ

このサーバーの Official MCP Registry 識別子は com.ones/ones です。server.json には、この公開リポジトリの URL を含む、公開用に準備されたメタデータが含まれています。このリポジトリ内のファイルは、該当バージョンが GitHub によって公開または承認された証拠にはなりません。公開済みバージョンについては、レジストリの最新レコードを確認してください。

このリポジトリは、ホスト型 ONES MCP サービスの公開ドキュメントと接続メタデータを提供します。ホスト型サービスのバックエンドソースコードは含まれていません。

リンク

• ONES
• ONES MCP の概要
• VS Code MCP セットアップドキュメント
• GitHub MCP Registry の公開ガイド