Konfigurowanie, łączenie i używanie serwera MCP Usługi GitHub w programie VS Code

Zakończone

W tej lekcji dowiesz się, jak skonfigurować i używać serwera MCP Usługi GitHub w programie Visual Studio Code, aby umożliwić bezpośrednie przenoszenie przepływów pracy opartych na sztucznej inteligencji do środowiska projektowego. Dowiesz się:

  • Jak skonfigurować przy użyciu protokołu OAuth lub osobistego tokenu dostępu (PAT)

  • Opcjonalna konfiguracja lokalna korzystająca z platformy Docker w celu uzyskania większej kontroli

  • Jak używać serwera MCP w usłudze GitHub z funkcją Copilot Chat na potrzeby produktywności opartej na sztucznej inteligencji

  • Typowe kroki rozwiązywania problemów

Konfigurowanie serwera MCP w usłudze GitHub w programie VS Code

Korzystanie z protokołu OAuth

Teraz, gdy wiesz, co może zrobić serwer MCP w usłudze GitHub, przejdźmy przez proces konfigurowania go w programie Visual Studio Code, aby można było go natychmiast użyć. Umożliwi to zintegrowanie preferowanych przepływów pracy opartych na sztucznej inteligencji bezpośrednio ze środowiskiem kodowania bez złożonej konfiguracji.

  1. W programie Visual Studio Code otwórz paletę poleceń, naciskając Ctrl+Shift+P (Windows/Linux) lub Cmd+Shift+P (Mac).
  2. Wpisz MCP: dodaj serwer i naciśnij Enter.
  3. Z listy wybierz pozycję HTTP (HTTP lub Server-Sent Events).
  4. W polu Adres URL serwera wprowadź ciąg https://api.githubcopilot.com/mcp/, a następnie naciśnij Enter.
  5. Po wyświetleniu monitu o wprowadzenie identyfikatora serwera możesz nacisnąć Enter, aby użyć wartości domyślnej lub wpisać niestandardowy identyfikator, jeśli wolisz.
  6. Wybierz lokalizację, w której chcesz zapisać konfigurację serwera MCP. Możesz dodać go do ustawień użytkownika, aby używać ich we wszystkich projektach lub do ustawień obszaru roboczego dla bieżącego projektu.
  7. Zostanie wyświetlony monit z prośbą o autoryzowanie w usłudze GitHub przy użyciu protokołu OAuth. Jeśli zostanie wyświetlony monit, wybierz pozycję Zezwalaj i zaloguj się do konta usługi GitHub.

Po skonfigurowaniu serwer MCP usługi GitHub będzie gotowy do użycia z projektami w programie VS Code. Teraz możesz rozpocząć korzystanie z narzędzi i przepływów pracy opartych na sztucznej inteligencji w celu automatyzowania zadań, zarządzania problemami i analizowania kodu bezpośrednio w edytorze, co ułatwia skoncentrowanie się na pracy, podczas gdy serwer MCP w usłudze GitHub obsługuje duże obciążenia w tle.

Korzystanie z osobistego tokenu dostępu

Aby użyć osobistego tokenu dostępu (PAT) do zaawansowanej kontroli, możesz wykonać następujące kroki:

  1. Utwórz identyfikator PAT z repozytorium i odczyt: zakres pakietów na koncie usługi GitHub.

  2. Po wyświetleniu monitu wykonasz te same kroki, ale anulujesz uwierzytelnianie OAuth.

  3. W pliku konfiguracji dodaj:

    "headers": {
      "Authorization": "Bearer ${input:github_token}"
    }
    
  4. Następnie dodaj monit wejściowy, aby bezpiecznie wprowadzić token:

    "inputs": [
      {
        "id": "github_token",
        "type": "promptString",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ]
    
  5. Na koniec uruchom ponownie serwer MCP w programie VS Code i wprowadź swój identyfikator dostępu po wyświetleniu monitu.

  6. Serwer MCP zostanie teraz skonfigurowany do używania pat do autoryzacji.

Konfiguracja lokalnego serwera MCP za pomocą platformy Docker (opcjonalnie)

Jeśli przedsiębiorstwo korzysta z serwera GitHub Enterprise Server z ograniczeniami pat, możesz uzyskać dostęp tylko do zakresów interfejsu API dozwolonych przez zasady organizacji. Jeśli wszystkie punkty końcowe są ograniczone, serwer MCP nie będzie dostępny, sprawdź administratora, jeśli nie masz pewności.

Do użytku lokalnego serwer MCP wymaga platformy Docker i uwierzytelniania przy użyciu osobistego tokenu dostępu (PAT). Protokół OAuth nie jest obsługiwany w tej konfiguracji.

  1. Najpierw należy potwierdzić, że platforma Docker jest zainstalowana i uruchomiona w systemie.

  2. Następnie wygeneruj identyfikator PAT z wymaganymi zakresami.

  3. Użyj następującej konfiguracji, aby uruchomić serwer lokalnie:

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub Personal Access Token",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
          }
        }
      }
    }
    
  4. Uruchom ponownie serwer MCP i wprowadź swój identyfikator dostępu po wyświetleniu monitu o ukończenie instalacji.

Rozwiązywanie problemów

Jeśli wystąpią problemy podczas korzystania z serwera MCP w usłudze GitHub, poniżej przedstawiono kilka praktycznych testów:

  • Upewnij się, że zalogowaliśmy się do konta usługi GitHub w programie VS Code.
  • Jeśli używasz pat, upewnij się, że ma poprawne zakresy i został wprowadzony poprawnie.
  • Sprawdź konfigurację pod kątem dowolnych literówek lub brakujących pól.
  • Jeśli używasz platformy Docker, upewnij się, że jest ona zainstalowana i aktywnie uruchomiona.
  • Spróbuj ponownie uruchomić program VS Code lub serwer MCP, aby rozwiązać tymczasowe problemy z połączeniem.