Narzędzia MCP — przegląd

Uprawnienia dostępu

Narzędzia MCP są przypisane do trzech poziomów zakresu:

Zakres	Znaczenie
`read`	Dostęp tylko do odczytu; brak możliwości tworzenia, edytowania ani usuwania
`write`	Odczyt i zapis źródeł, kanałów, Inbox; brak dostępu do ustawień zespołu
`admin`	Pełny dostęp do MCP, w tym do ustawień zespołu

W przypadku połączeń OAuth zakres wybrany podczas autoryzacji ogranicza dostęp do narzędzi. W przypadku tokenów API maksymalny zakres dostępu określa rola tokenu.

Wybór Workspace

Serwer MCP znajduje się pod adresem https://picasi.app/mcp, bez Workspace w adresie.

Logowanie	Workspace
Token API	stały, Workspace tokenu; parametr nie jest potrzebny
OAuth	wszystkie Workspaces konta; każde wywołanie wymaga `workspace_id`

Przy OAuth list_workspaces zwraca możliwe wartości. Bez workspace_id wywołanie zostaje odrzucone.

Narzędzia do odczytu

Wszystkie narzędzia do odczytu wymagają co najmniej zakresu read.

`search_updates`

Przeszukuje Updates pod kątem słów kluczowych, źródeł, tagów i okresu.

Wymagany zakres: read

Parametr	Typ	Opis
`query`	Ciąg znaków	Słowo kluczowe do wyszukiwania pełnotekstowego (opcjonalnie)
`source_id`	Ciąg znaków	Updates z określonego źródła (opcjonalnie)
`tags`	Tablica	Tagi Updates, według których ma być filtrowane (opcjonalnie)
`folder`	Ciąg znaków	`inbox`, `saved` lub `dropped` (opcjonalnie)
`source_ownership`	Ciąg znaków	`all` (domyślnie), `own` (tylko własne źródła) lub `competitor` (tylko źródła zewnętrzne)
`limit`	Liczba całkowita	Liczba wyników (domyślnie: 20, maks.: 100)

Filtr source_ownership wykorzystuje pole is_own w źródle. Stanowi on odpowiednik filtra własności w interfejsie użytkownika Inbox i pozwala asystentowi AI na celowe uwzględnianie wyłącznie własnej obecności lub wyłącznie konkurencji.

`get_update_details`

Zwraca pełną treść pojedynczego Update.

Wymagany zakres: read

Parametr	Typ	Opis
`update_id`	Ciąg znaków	Identyfikator Updates

`list_sources`

Wyświetla listę wszystkich źródeł w Workspace.

Wymagany zakres: read

Parametr	Typ	Opis
`is_own`	Boolean	`true` = tylko własne źródła, `false` = tylko konkurenci, pominięcie = wszystkie

Każde zwrócone źródło zawiera pole is_own, dzięki czemu asystenci AI mogą odróżnić własną obecność od konkurencji bez konieczności wysyłania drugiego zapytania.

Do każdego kanału dochodzą trzy pola, które trzeba rozróżniać:

Pole	Znaczenie
`monitoring_active`	Przełącznik kanału: włączony albo wyłączony. Nie jest to stan zdrowia.
`state`	Stan pobierania: `healthy`, `degraded`, `broken`, `quarantined` albo `paused`. Kanały e-mail nie są pobierane, tylko odbierają; zgłaszają `receiving`, `stale` albo `waiting`. `null` oznacza, że nie ma jeszcze przypiętego pobierania.
`last_checked`	Ostatnia próba pobrania, przy kanałach e-mail ostatnia odebrana wiadomość.

Do pełnej diagnozy pojedynczego kanału służy get_channel_status.

`list_reports`

Wyświetla listę dostępnych raportów.

Wymagany zakres: read

Parametr	Typ	Opis
`type`	Ciąg znaków	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (opcjonalnie)
`limit`	Liczba całkowita	Liczba (domyślnie: 10)

`get_report`

Zwraca pełną treść raportu.

Wymagany zakres: read

Parametr	Typ	Opis
`report_id`	Ciąg znaków	Identyfikator raportu

`get_team_context`

Zwraca kontekst AI Workspace: metadane zespołu (nazwa, język, strefa czasowa), adres URL strony internetowej, dokumenty kontekstowe oraz konfigurację własności.

Wymagany zakres: read

Brak parametrów obowiązkowych.

Odpowiedź zawiera w bloku context:

website_url – zapisany adres URL organizacji
is_own_sources_configured – true, gdy co najmniej jedno źródło jest oznaczone jako własne
own_sources_count – liczba własnych źródeł

Asystenci AI powinni proponować porównania Voice Share lub Momentum tylko wtedy, gdy is_own_sources_configured jest równe true — w przeciwnym razie brakuje podstawy do porównania.

`list_tags`

Wyświetla listę wszystkich tagów Workspace.

Wymagany zakres: read

Parametr	Typ	Opis
`type`	Ciąg znaków	`sources`, `channels`, `updates` (opcjonalnie)

`get_update_statistics`

Zlicza Updates, zamiast je wypisywać. Przyjmuje te same filtry co search_updates i nie ma limitu 100 wyników.

Wymagany zakres: read

Parametr	Typ	Opis
`group_by`	Ciąg znaków	`source` (domyślnie), `source_tag`, `update_tag`, `day`, `week`, `month`, `quarter`
`compare_previous_period`	Boolean	Zlicza dodatkowo równie długi okres poprzedzający i podaje różnicę
`query`	Ciąg znaków	Hasło wyszukiwania pełnotekstowego (opcjonalnie)
`source_id`	Ciąg znaków	Ograniczenie do jednego źródła (opcjonalnie)
`source_tags`	Tablica	Tagi źródeł (opcjonalnie)
`update_tags`	Tablica	Tagi tematyczne (opcjonalnie)
`source_ownership`	Ciąg znaków	`all` (domyślnie), `own` lub `competitor`
`platform`	Ciąg znaków	Ograniczenie do jednej platformy, np. `linkedin` (opcjonalnie)
`folder`	Tablica	`inbox`, `saved`; domyślnie oba
`days`	Liczba całkowita	Okres w dniach, od 1 do 365 (domyślnie: 30)
`date_from`, `date_to`	Ciąg znaków	Okres jako data, zamiast `days`

Grupowanie według platformy nie jest możliwe. Odrzucone Updates oraz te w Overflow nie są zliczane.

`get_channel_status`

Zwraca stan kanału: ostatnie pobranie, ostatni sukces, ostatni błąd, liczbę kolejnych niepowodzeń, następną zaplanowaną próbę oraz liczbę Updates z tego kanału.

Wymagany zakres: read

Parametr	Typ	Opis
`channel_id`	Ciąg znaków	ID kanału, z `list_sources` z `include_channels=true`

`discover_channels`

Bada stronę internetową i zgłasza kanały, które można by obserwować. Niczego nie zakłada.

Wymagany zakres: read

Parametr	Typ	Opis
`url`	Ciąg znaków	Strona do zbadania (opcjonalnie, jeśli ustawiono `source_id`)
`source_id`	Ciąg znaków	Używa strony tego źródła i oznacza kanały, które już do niego należą

`list_workspaces`

Wypisuje Workspaces zalogowanego konta wraz z workspace_id, nazwą i rolą.

Wymagany zakres: brak; narzędzie jest dostępne dla każdego połączenia

Bez parametrów.

Narzędzia do raportów

`create_report`

Tworzy raport z Updates pasujących do filtra. Filtry są takie same jak w search_updates.

Generowanie działa w tle: wywołanie od razu zwraca request_id. get_report_status mówi, na jakim jest etapie, a get_report odczytuje gotowy raport.

Wymagany zakres: read

Parametr	Typ	Opis
`type`	Ciąg znaków	Wymagane. `summary`, `feedback`, `list` lub `conversation_starters`
`title`	Ciąg znaków	Nazwa raportu (opcjonalnie)
`instructions`	Ciąg znaków	Fokus dla AI (opcjonalnie)
`language`	Ciąg znaków	Kod języka, np. `de`; domyślnie język Workspace
`query`	Ciąg znaków	Hasło wyszukiwania pełnotekstowego (opcjonalnie)
`source_ids`	Tablica	Ograniczenie do tych źródeł (opcjonalnie)
`source_tags`	Tablica	Tagi źródeł (opcjonalnie)
`source_tags_mode`	Ciąg znaków	`AND` lub `OR`
`update_tags`	Tablica	Tagi tematyczne (opcjonalnie)
`update_tags_mode`	Ciąg znaków	`AND` lub `OR`
`source_ownership`	Ciąg znaków	`all`, `own` lub `competitor`
`platform`	Ciąg znaków	Ograniczenie do jednej platformy (opcjonalnie)
`folder`	Tablica	Foldery bazy danych; domyślnie `inbox` i `saved`
`days`	Liczba całkowita	Okres w dniach, od 1 do 365 (domyślnie: 30)
`date_from`, `date_to`	Ciąg znaków	Okres jako data, zamiast `days`

`get_report_status`

Zwraca stan raportu zleconego przez create_report.

Wymagany zakres: read

Parametr	Typ	Opis
`request_id`	Ciąg znaków	`request_id` z `create_report`

Status	Znaczenie
`queued`	czeka w kolejce
`running`	jest generowany
`ready`	gotowy; odczytaj go przez `get_report` i `report_id`
`empty`	zakończony, ale żaden Update nie pasował do filtrów
`failed`	przerwany; powód znajduje się w odpowiedzi

Narzędzia do zapisu

Wszystkie narzędzia do zapisu wymagają co najmniej zakresu write.

`create_source`

Tworzy nowe źródło.

Wymagany zakres: write

Parametr	Typ	Opis
`url`	Ciąg znaków	Adres URL strony źródła
`name`	Ciąg znaków	Nazwa wewnętrzna
`tags`	Tablica	Identyfikatory tagów (opcjonalnie)

`update_source`

Zmienia nazwę, adres URL lub tagi istniejącego źródła.

Wymagany zakres: write

Parametr	Typ	Opis
`source_id`	Ciąg znaków	Identyfikator źródła
`name`	Ciąg znaków	Nowa nazwa (opcjonalnie)
`url`	Ciąg znaków	Nowy adres URL (opcjonalnie)

`delete_source`

Usuwa źródło wraz ze wszystkimi kanałami i Updates.

Wymagany zakres: write

Parametr	Typ	Opis
`source_id`	Ciąg znaków	Identyfikator źródła

`create_channel`

Ręcznie tworzy kanał.

Wymagany zakres: write

Parametr	Typ	Opis
`source_id`	Ciąg znaków	Identyfikator źródła nadrzędnego
`url`	Ciąg znaków	Adres URL kanału
`name`	Ciąg znaków	Nazwa kanału (opcjonalnie)

`update_channel`

Zmienia nazwę lub opis kanału.

Wymagany zakres: write

Parametr	Typ	Opis
`channel_id`	Ciąg znaków	Identyfikator kanału
`name`	Ciąg znaków	Nowa nazwa (opcjonalnie)

`delete_channel`

Usuwa kanał.

Wymagany zakres: write

Parametr	Typ	Opis
`channel_id`	Ciąg znaków	Identyfikator kanału

`toggle_channel`

Włącza lub wyłącza kanał.

Wymagany zakres: write

Parametr	Typ	Opis
`channel_id`	Ciąg znaków	Identyfikator kanału
`active`	Boolean	`true` = aktywny, `false` = nieaktywny

`create_tag`

Tworzy nowy tag.

Wymagany zakres: write

Parametr	Typ	Opis
`name`	Ciąg znaków	Nazwa tagu
`type`	Ciąg znaków	`sources`, `channels` lub `updates`
`description`	Ciąg znaków	Opis tagowania AI (opcjonalnie)

`update_tag`

Zmienia nazwę lub opis tagu.

Wymagany zakres: write

Parametr	Typ	Opis
`tag_id`	Ciąg znaków	Identyfikator tagu
`name`	Ciąg znaków	Nowa nazwa (opcjonalnie)
`description`	Ciąg znaków	Nowy opis AI (opcjonalny)

`update_update_state`

Przenosi Updates między folderami Workspace.

Wymagany zakres: write

Parametr	Typ	Opis
`update_ids`	Tablica	ID Updates, maksymalnie 100 na wywołanie
`folder`	Ciąg znaków	`inbox`, `saved` lub `dropped`

Stan obowiązuje w obrębie Workspace i nie zmienia samego Update. Odpowiedź podaje każde ID osobno.

`tag_update`

Przypisuje Updates istniejące tagi tematyczne.

Wymagany zakres: write

Parametr	Typ	Opis
`update_ids`	Tablica	ID Updates, maksymalnie 100 na wywołanie
`tags`	Tablica	Tagi jako slug, ID lub nazwa
`mode`	Ciąg znaków	`add` (domyślnie) zachowuje istniejące tagi, `replace` ustawia dokładnie te

Dopuszczalne są tylko tagi z applies_to = updates; tag źródła zostaje odrzucony. Brakujące tagi utwórz najpierw przez create_tag.

`untag_update`

Usuwa tagi tematyczne z Updates.

Wymagany zakres: write

Parametr	Typ	Opis
`update_ids`	Tablica	ID Updates, maksymalnie 100 na wywołanie
`tags`	Tablica	Tagi do usunięcia, jako slug, ID lub nazwa

Usuwane jest tylko przypisanie tego Workspace. Sam tag pozostaje.

`refresh_source_channels`

Ponownie uruchamia wykrywanie kanałów dla istniejącego źródła.

Wymagany zakres: write

Parametr	Typ	Opis
`source_id`	Ciąg znaków	ID źródła
`create_detected`	Boolean	`false` (domyślnie) tylko zgłasza, `true` zakłada brakujące kanały

Istniejące kanały nie są zakładane podwójnie; kanał wyłączony liczy się jako istniejący. Nowe kanały same zaczynają pobieranie.

Powiązane tematy

MCP — korzystanie z Picasi w asystencie AI Informacje ogólne: Czym jest MCP, poziomy zakresu OAuth oraz koncepcja bezpieczeństwa.

Połącz Picasi z Claude Code Utwórz token API i skonfiguruj go w Claude Code.

Połącz Picasi z Claude.ai Skonfiguruj połączenie OAuth dla Claude.ai.