Codestin Search App

          Copilot クラウドエージェント は、MCP サーバーへの接続、プライベート パッケージの使用、外部サービスへのアクセスを行うことができます。ただし、組織のリポジトリが許可するように構成されている場合に限られます。

以下の構成の多くはリポジトリレベルで行われますが、組織の所有者は、スコープ内のリソースと、それらのリソースへのアクセスを構成できるユーザーを制御できます。

サンプルシナリオ

組織では、Sentry を使用して Node アプリのバグを追跡しています。 GitHubの問題として新しい例外が発生し、開発者はこれらの問題をCopilotに割り当てたいと考えています。

次の Copilot が必要です。

Sentry インスタンスの詳細にアクセスできるように、Sentry MCP サーバーに接続します
アプリをビルドしてテストを実行するために、 GitHubでホストされているプライベートパッケージを含む依存関係をインストールする
組織の規則に従ってエラー処理を行う

シークレットを安全に格納する

既定では、 Copilotの認証トークンのスコープは、実行されているリポジトリに制限されます。つまり、 Copilot は外部システムに対して認証を行ったり、プライベートな組織スコープのパッケージにアクセスしたりすることはできません。

リポジトリ管理者は、専用のCopilotcopilot環境GitHub Actions必要な変数とシークレットを追加する必要があります。 Copilot は、セットアップとタスクの実行でこのデータにアクセスできます。組織全体の GitHub Actions シークレットなど、この環境以外の変数やシークレットにアクセスすることはできません。

例: シークレットを保存する

リポジトリ管理者は、組織の Sentry インスタンスの認証トークンを保存します。

リポジトリ設定の [環境 ] セクションに移動します。

       `copilot`という新しい環境を作成します。

Sentry インスタンスのアクセストークンを、 COPILOT_MCP_SENTRY_ACCESS_TOKEN という環境シークレットに保存します。

ヒント

標準のGitHub PackagesGitHub Actionsを使用してアクセスするプライベート GITHUB_TOKEN レジストリのトークンを保存する必要はありません。ただし、外部パッケージレジストリを使用している場合は、認証トークンを保存する必要があります。

組織と企業の所有者は、ユーザーが MCP サーバーへのアクセスを構成できるようにポリシーを設定できます。このポリシーが有効になっている場合、ユーザーはリポジトリ設定またはカスタムエージェントプロファイルで Copilot クラウドエージェント用に MCP サーバーを構成できます。組織全体の一貫性を確保するために、組織レベルまたはエンタープライズレベルで カスタムエージェントプロファイル を作成することをお勧めします。

カスタムエージェントを使用するセッションは、リポジトリ設定とエージェントプロファイルの両方で構成された MCP サーバーにアクセスできます。ただし、組織全体のカスタムエージェントに対応するユースケースが多いほど、リポジトリ設定で MCP サーバーへのアドホックアクセスを構成する必要が少なくなります。

          [
          GitHub MCP レジストリ](https://github.com/mcp)を参照して、信頼できる高評価のオプションを見つけることをお勧めします。

例: カスタムエージェントを作成する

組織の所有者は、Sentry エージェントのカスタムエージェントプロファイルを作成します。 Sentry MCP サーバーと、組織のエラー処理規則に関するカスタム命令にアクセスできます。

組織内に .github-private というリポジトリを作成します。必要に応じて、エンタープライズ所有者は、エンタープライズ内のすべてのカスタムエージェントのソースとしてこのリポジトリを設定できます。

リポジトリで、次のようなプロファイルを含む agent.md ファイルを追加します。これには、保存したシークレットを参照する MCP サーバーの構成が含まれます。

---
name: sentry-error-fixer
description: Proposed fixes for exception issues raised from Sentry
mcp-servers:
  sentry:
    type: 'local'
    command: 'npx'
    args: ['@sentry/mcp-server@latest']
    env:
      SENTRY_ACCESS_TOKEN: ${{ secrets.COPILOT_MCP_SENTRY_ACCESS_TOKEN }}
---

You are an error resolution specialist. When you're assigned an issue created by our Sentry integration, check for error details and stack traces using the MCP server, then propose a fix.

Make sure you check that your proposed fix works by building the site with `npm run build` and running the test suite in `npm test`.

開発者は、 Copilotに問題を割り当てるときに、ドロップダウンからカスタムエージェントを選択できます。

プライベートパッケージのインストール

プロジェクトの依存関係に Copilot アクセスできるようにする最善の方法は、 copilot-setup-steps.yml ワークフローファイルにインストールすることです。このファイルは、 Copilot が動作を開始する前に環境を設定する方法を定義します。

ワークフローが組織スコープのプライベートパッケージをプルできるようにするには、パッケージ設定を更新して、リポジトリの GITHUB_TOKEN がパッケージにアクセスできることを確認します。これは、組織のアクセス許可を持つ有効期間の長い personal access token を使用するよりも安全です。

例: ノードの依存関係をインストールする

開発者は、リポジトリの package-lock.json ファイルに定義されている Node 依存関係をインストールするワークフローを作成します。これには、 GitHubでホストされている、組織を対象としたプライベートパッケージが含まれます。

開発者は、リポジトリに copilot-setup-steps.yml ファイルを作成します。

プロジェクトの依存関係をインストールするための手順を追加します。例えば次が挙げられます。

# ...

jobs:
  copilot-setup-steps:
    # ...

    # You can define any steps you want, and they will run before the agent starts.
    # If you do not check out your code, Copilot will do this for you.
    steps:
      - name: Checkout code
        uses: actions/checkout@v5

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"

      - name: Install JavaScript dependencies
        run: npm ci

組織の管理者は、各パッケージの設定でリポジトリへのアクセスを許可することで、リポジトリが組織のプライベートパッケージにアクセスできることを確認します。「パッケージのアクセス制御と可視性の設定」を参照してください。

ヒント

社内ネットワーク内で内部的にホストされているパッケージにアクセスする必要がある場合は、セルフホステッド Copilot クラウドエージェントランナーでGitHub Actionsを実行することが必要になる場合があります。

これらの設定を構成できるユーザーの制御

リポジトリと組織レベルでリソースへのアクセスを制御する方法を確認しました。これらの設定を管理するためにユーザーに付与するスコープの量を検討します。

       **
       **にCopilot クラウドエージェントします。 特定のリポジトリが気になる場合は、すべてのユーザーに対してそれをブロックできます。

これらのリポジトリへの管理者アクセス権を取得するユーザーを検討します。これを組織レベルで制御するには、 すべてのリポジトリ管理者 カスタムロールを持つチームを作成します。これらのユーザーは、MCP 構成や__ 環境などの構成copilotをすべてのリポジトリで管理できます。

       **ルールセットと CODEOWNERS ファイルを使用して**、__ などの構成`copilot-setup-steps.yml`の編集を制御します。書き込みアクセス権を持つすべてのユーザーが既定で編集できます。

       **既定のファイアウォールを確認します**。 ファイアウォールは MCP サーバーへの接続や `copilot-setup-steps.yml`のセットアップ手順には影響しませんが、タスクの実行中にインターネットへの Copilotのアクセスが制限されます。 「[AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-firewall)」を参照してください。

GitHub Copilot クラウドエージェントに組織内のリソースへのアクセス権を付与する

この記事で