Jak potwierdzić operację nieodwracalną kodem

Narzędzie nieodwracalne, na przykład jira__delete_issue, uruchamia się dopiero po wpisaniu 6-cyfrowego kodu z wpisu “MCP Platform” w Twojej aplikacji uwierzytelniającej. Agent nie potrafi wygenerować kodu, a model nigdy nie widzi ziarna, z którego kod powstaje. Najpierw musisz mieć zarejestrowany Authenticator, zob. Zarejestruj Authenticator.

Potwierdź operację

1. Poproś agenta o operację. Platforma wstrzymuje wywołanie na 120 sekund i przekazuje agentowi opis operacji, odczytany z argumentów, oraz link do podglądu w portalu.

2. Przeczytaj opis, który pokazuje agent. Jeśli to nie to, co chciałeś zrobić, nie wpisuj kodu.

3. Opcjonalnie otwórz link podglądu w przeglądarce, w której jesteś zalogowany do portalu. Podgląd pokazuje operację tak, jak odczytał ją gateway, niezależnie od tego, co mówi agent.

   

4. Jeśli podgląd się zgadza, otwórz w aplikacji wpis “MCP Platform” i wpisz bieżący kod w sesji agenta.

5. Agent powtarza to samo wywołanie z kodem. Po sukcesie podaje wynik. Wywołanie jest na liście w Logi audytowe, bez kodu.

Podgląd jest opcjonalny, kod działa bez jego otwierania. Jeśli agent zmieni argumenty wywołania, oczekująca operacja przestaje obowiązywać i zaczyna się nowe potwierdzenie.

Na jedną operację masz 3 próby.

Jedna oczekująca operacja

Gdy otworzysz podgląd, inna Twoja operacja nieodwracalna jest odrzucana z confirmation_blocked, dopóki pierwsza nie wygaśnie albo jej nie anulujesz. Nie wpisuj kodu dla zablokowanego wywołania.

Jeśli nie otworzyłeś podglądu, nowsze wywołanie nieodwracalne zastępuje starsze, a starsze kończy się z confirmation_superseded.

Anuluj operację

1. Otwórz podgląd.
2. Wybierz Anuluj operację.

Anulowanie unieważnia kody, które były ważne do tej chwili. Przy następnej operacji poczekaj 30 do 60 sekund na nowy kod. Jeśli agent ponowi anulowane wywołanie, zakończy się ono z confirmation_cancelled.

Gdy czas minął

Po 120 sekundach podgląd pokazuje “Czas minął. Poproś agenta o ponowienie. Nie wpisuj kodu dla tej operacji.” Poproś agenta o powtórzenie operacji.

Link podglądu z napisem “Ten link jest nieaktualny.” dotyczy operacji zastąpionej, wykonanej albo wygasłej. Nie wpisuj dla niej kodu.

Dlaczego kod jest odrzucany

Przyczyna	Co dostaje agent	Co zrobić
kod pochodzi z innego wpisu w aplikacji	confirmation_failed	użyj wpisu “MCP Platform”
zegar telefonu różni się o więcej niż około 30 sekund	confirmation_failed	ustaw automatyczny zegar telefonu
kod został już użyty	confirmation_failed	poczekaj na następny kod
minęło więcej niż 120 sekund albo wpisano 3 błędne kody	confirmation_failed	poproś agenta o powtórzenie operacji
operację anulowano	confirmation_cancelled	zacznij od nowa, jeśli nadal tego chcesz, po 30 do 60 sekundach
zastąpiła ją nowsza operacja	confirmation_superseded	zacznij operację od nowa
czeka inna operacja z otwartym podglądem	confirmation_blocked	anuluj ją albo poczekaj
5 błędnych kodów w 15 minut	rate_limited z czasem oczekiwania	poczekaj 15 minut, nic nie skraca blokady
20 błędnych kodów w ciągu doby	stan Authenticatora “Wyłączony”	zarejestruj ponownie
brak Authenticatora	confirmation_required z linkiem do rejestracji	zarejestruj, zob. Logowanie

Panel Authenticatora pokazuje blokadę i stan wyłączony, zob. Stany Authenticatora. Wszystkie kody błędów: Błędy i limity.

Kody, które wysyła agent, liczą się tak samo jak Twoje. Agent, który zgaduje kody, może zablokować Twój Authenticator.

Które narzędzia wymagają kodu

Narzędzia z ryzykiem Usuwanie. Portal oznacza je w Serwery MCP napisem “Wymaga kodu z Authenticatora”. Wymagają też grupy mcp-<system>-destructive. Lista jest w Narzędzia i grupy dostępu.