# MCP

> Palladin documentation · 1.0 · PL · 2026-10-25


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](/pl/docs/developers/installation), a następnie [podłącz agenta](/pl/docs/developers/connect). 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.

```json
{
  "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.

```json
{
  "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.