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.

Narzędzia do odczytu

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

`search_updates`

Przeszukuje aktualizacje 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	Aktualizacje z określonego źródła (opcjonalnie)
`tags`	Tablica	Tagi aktualizacji, 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ść pojedynczej aktualizacji.

Wymagany zakres: read

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

`list_sources`

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

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.

`list_reports`

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

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 obszaru roboczego: 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 obszaru roboczego.

Wymagany zakres: read

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

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 aktualizacjami.

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)

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.