Testowanie i rozwiązywanie problemów - MCP

Test integracji

Z klienta MCP wywołaj tools/list i porównaj wynik z uprawnieniami zaznaczonymi przy tworzeniu klucza - lista powinna zawierać dokładnie te narzędzia, a nie więcej. Następnie wywołaj jedno narzędzie do odczytu, na przykład projects.list, i sprawdź w panelu Ustawienia → Integracja MCP, że przy kluczu zaktualizowała się data ostatniego użycia.

Typowe problemy

Narzędzia nie widać w tools/list

Narzędzie pojawia się w odpowiedzi wyłącznie wtedy, gdy klucz ma uprawnienie z nim związane. Sprawdź w ustawieniach klucza, czy odpowiednie uprawnienie jest zaznaczone - narzędzie bez zgody nie jest ukryte ani zablokowane, po prostu nie istnieje z perspektywy tego klucza.

issues.get nie istnieje dla tego klucza

Samo uprawnienie issues.read daje wyłącznie metadane grupy przez issues.list - komunikat błędu, miejsce awarii, stos wywołań i pełne dane żądania wymagają osobnego uprawnienia issues.details, które jest domyślnie niezaznaczone. Włącz je świadomie w ustawieniach klucza, jeśli narzędzie ma naprawdę diagnozować błędy.

Klucz przestał działać z dnia na dzień

Zakres klucza jest przecinany z aktualnymi uprawnieniami osoby, która go wystawiła, przy każdym żądaniu. Jeśli ta osoba została zdegradowana, straciła konkretne uprawnienie albo jej konto zostało dezaktywowane, klucz zawęża się albo przestaje działać natychmiast - bez żadnej zmiany po stronie samego klucza. Przywrócenie uprawnień wydawcy przywraca pełny zakres klucza, bo wiersz w bazie cały czas zostaje nietknięty.

Żądanie kończy się 403

Sprawdź nagłówek Origin żądania. Serwer MCP odrzuca każde żądanie z nagłówkiem wskazującym obcą domenę - to zabezpieczenie przed wywołaniami z przeglądarki, nie błąd konfiguracji. Ten endpoint jest przeznaczony dla klientów działających po stronie serwera, a nie dla kodu uruchamianego w przeglądarce użytkownika.

Klucz nie działa mimo poprawnego tokenu i uprawnień

Sprawdź, czy konto wciąż ma wykupioną składową MCP - to płatna funkcja planu, a jej utrata (na przykład po zejściu na plan darmowy) wyłącza uwierzytelnianie wszystkich kluczy konta, niezależnie od tego, jakie mają zapisane uprawnienia.

Nadal nie działa

Przejdź przez listę kontrolną braku danych w panelu, a jeśli to nie pomoże - napisz do nas. Podaj nazwę projektu, wersję integracji i przybliżoną godzinę testu: to skraca drogę do odpowiedzi.