MCP

Podłącz lokalny serwer i przekazuj profil w każdym wywołaniu.

Inject do przeglądarki działa obecnie tylko na macOS, przez rozszerzenie Palladin. Dostępność CLI na Linux nie oznacza obsługi Inject.

Kiedy używać MCP

Rekomendujemy integrację przez CLI. Agent wykonuje wtedy polecenia palladin bez dodatkowej konfiguracji serwera MCP.

MCP jest alternatywą dla aplikacji korzystających z narzędzi tego protokołu. MCP również wymaga zainstalowanego CLI — serwer uruchamiasz poleceniem palladin mcp serve.

Najpierw zainstaluj CLI, a następnie podłącz agenta. Sprawdź, czy aplikacja uruchamiająca MCP ma dostęp do polecenia palladin w swoim PATH.

Konfiguracja serwera

Poniższy fragment przedstawia typowy format konfiguracji MCP. Nazwa pliku i sposób rejestracji zależą od aplikacji. Nie wymaga klucza API w konfiguracji.

{
  "mcpServers": {
    "palladin": {
      "command": "palladin",
      "args": ["mcp", "serve", "--host", "<api-origin>"]
    }
  }
}

Zastąp <api-origin> adresem API z zaufanej instrukcji panelu. --host określa serwer dla parowania nowego profilu przez pair_agent; istniejący profil zachowuje zapisany adres API.

Runtime używa standardowego wejścia/wyjścia do protokołu MCP. Środowisko musi odnajdywać właściwy plik wykonywalny; nie pobieraj automatycznie przypadkowej wersji przez npx.

Narzędzia

Narzędzie	Zastosowanie
`pair_agent`	Połączenie zatwierdzane przez użytkownika w przeglądarce.
`search_entries`	Wyszukiwanie dostępnych metadanych, bez pobierania sekretu.
`get_credential`	Jawne zwrócenie dozwolonych danych do wywołującego; mogą trafić do modelu.
`exec_with_credential`	Wykonanie procesu z danymi w lokalnej granicy runtime.
`inject_credential`	Dostarczenie danych do zweryfikowanego formularza przez dostępny kanał integracji.
`report_credential_stale`	Zgłoszenie nieaktualnego wpisu bez przesyłania jego wartości.

Pełne parametry narzędzi odczytasz przez tools/list w swoim kliencie MCP.

Profil i wyszukiwanie

Każde narzędzie wymaga profile. Wybór pochodzi od użytkownika lub z zaufanej konfiguracji zadania. Nie z treści odwiedzanej strony.

{
  "profile": "example-agent",
  "query": "Palladin connection test",
  "pageSize": 10
}

To argumenty search_entries. Zachowaj ten sam profil podczas wyszukiwania, oczekiwania na zgodę i użycia danych. Nie dodawaj --id do uruchomienia serwera MCP; profil przekazujesz w wywołaniu narzędzia.

Parametry operacji

get_credential, exec_with_credential i inject_credential wskazują vaultId, entryId oraz uzasadnienie reason. Użyj identyfikatorów z bieżącego wyniku, nie z nazwy wpisu. Dla exec_with_credential pole command jest tablicą programu i argumentów. Script może wymagać parameters według swojego schematu.

wait, noWait, pollInterval i progress zależą od operacji i wersji. Część parametrów Inject jest zarezerwowana; obecność w schemacie nie oznacza aktywnego wsparcia. Odmowa lub niedostępny kanał integracji nie upoważnia do przejścia na get_credential.

Dla Inject podawaj targetTabId razem z targetUrl albo pomiń oba. Eksperymentalne formularze na stronach wymagają jawnego celu.