Przejdź do głównej zawartości
Do aplikacji

Czym jest MCP i jak korzystać z Picasi w asystencie AI?

Czym jest MCP

Model Context Protocol (MCP) to otwarty protokół, który określa, w jaki sposób asystenci AI uzyskują dostęp do zewnętrznych narzędzi i danych. Zamiast tego, by każdy dostawca musiał tworzyć własną integrację, wszyscy stosują ten sam standard.

Claude Code, Claude.ai, ChatGPT i inne asystenty obsługujące MCP mogą łączyć się z każdą usługą zgodną z MCP — a Picasi jest jedną z nich.

Co daje wam MCP

Monitorowanie konkurencji staje się naprawdę przydatne, gdy informacje są dostępne tam, gdzie pracujecie — a nie w osobnej aplikacji, którą musicie dodatkowo otwierać.

Jeśli piszecie analizę konkurencji w Claude i w trakcie pracy chcecie wiedzieć, co firma Muster AG ogłosiła w zeszłym tygodniu, po prostu zapytacie Claude’a. Claude w tle zapyta Picasi za pośrednictwem MCP — a wy natychmiast zobaczycie dane na czacie, bez konieczności zmiany kontekstu.

Jak działa połączenie

Istnieją dwa sposoby połączenia Picasi z asystentem AI:

Token API — dla Claude Code, Cursor i własnych agentów. Tworzycie token w Picasi, wpisujecie go w konfiguracji asystenta i już ma on dostęp. Token ma rolę, która określa zakres dostępu.

OAuth — dla Claude.ai i ChatGPT. Autoryzujecie asystenta bezpośrednio za pośrednictwem swojego konta Picasi, bez konieczności zarządzania tokenami. Połączenie jest powiązane z waszym osobistym kontem.

Co potrafi asystent

Dzięki uprawnieniom do odczytu asystent może:

  • wyszukiwać i czytać Updates
  • wyświetlać listę źródeł i kanałów
  • pobierać Reports
  • sprawdzać kontekst zespołu (kontekst AI)

Dzięki uprawnieniu do zapisu (token członka lub administratora, OAuth z poziomem Czytanie i pisanie) asystent może dodatkowo:

  • tworzyć, edytować i usuwać źródła
  • tworzyć, edytować i dezaktywować kanały
  • tworzyć i edytować tagi

Poziom zakresu OAuth

Konfigurując połączenie OAuth — na przykład z Claude.ai lub ChatGPT — na etapie autoryzacji wybieracie w polu Poziom uprawnień, co asystent może robić. Poziom ten stanowi ograniczenie: określa, co asystent może robić za pośrednictwem tego połączenia, niezależnie od waszej roli w Workspace.

PoziomDozwoloneNiedozwolone
Tylko do odczytuOdczytywanie Updates, pobieranie źródeł i Reports, sprawdzanie kontekstu zespołuTworzenie, edytowanie lub usuwanie źródeł lub kanałów
Czytanie i pisanie (domyślnie)Wszystko z poziomu Tylko do odczytu oraz zarządzanie źródłami, kanałami i InboxZarządzanie ustawieniami zespołu

Jeśli asystent sam prosi tylko o dostęp do odczytu, Picasi oferuje również tylko Tylko do odczytu.

Wybrany zakres pozostaje trwale powiązany z połączeniem. Po autoryzacji jest on widoczny na liście połączeń w postaci ikony. Aby zmienić zakres, należy cofnąć połączenie i skonfigurować je ponownie.

Zalecenie: Wybierz zakres wystarczający do konkretnego celu — nie przyznajcie więc większego dostępu niż to konieczne. Do samych zapytań i analiz wystarczy opcja Tylko do odczytu.

Jak długo obowiązuje połączenie

Tokeny dostępu Workspace nie mają daty wygaśnięcia. Pozostają ważne do momentu ich cofnięcia w sekcji Ustawienia Workspace → Połączenia AI lub do momentu, gdy osoba, która je utworzyła, opuści Workspace. Osobiste tokeny dostępu z sekcji Ustawienia osobiste → Połączenia wygasają po 90 dniach. Cofnięty lub wygasły token natychmiast traci ważność; należy wygenerować nowy i zapisać go w kliencie.

Połączenia OAuth działają w oparciu o dwa tokeny:

  • Token dostępu, który jest ważny przez krótki czas i autoryzuje pojedyncze wywołanie narzędzia.
  • Token odnawiania, który jest ważny tak długo, jak długo trwa połączenie — klient wymienia go w tle na nowe tokeny dostępu.

Dopóki asystent regularnie korzysta z połączenia, odnawia się on samoczynnie. Jeśli połączenie pozostaje nieaktywne przez ponad około dwa tygodnie, token odnawiania może wygasnąć — w takim przypadku asystent wyświetli błąd autoryzacji, a wy łączycie asystenta ponownie, tak jak za pierwszym razem.

Jeden adres dla wszystkich Workspaces

Serwer MCP ma stały adres, https://picasi.app/mcp. Nie zawiera już Workspace. To, który Workspace ma na myśli wywołanie, zależy od tego, czym się logujecie.

Przy tokenie dostępu Workspace token należy dokładnie do jednego Workspace, więc Workspace jest ustalony jeszcze przed pierwszym wywołaniem. Asystent nie może zobaczyć nic innego.

Przy OAuth połączenie należy do waszego konta, nie do Workspace. Obejmuje wszystkie Workspaces, których jesteście członkami; na liście połączeń widnieje Wszystkie Workspaces. Asystent najpierw pyta przez list_workspaces, jakie istnieją, i w każdym kolejnym wywołaniu podaje ten właściwy. Bez tej informacji Picasi odrzuca wywołanie.

W obu przypadkach decyduje członkostwo. Workspace, do którego nie należycie, nie pojawia się, nawet jeśli ktoś wymieni jego nazwę w czacie.

Łączenie wielu Workspaces jednocześnie

Jeśli posiadacie kilka Workspaces Picasi (np. agencja z wieloma kontami klientów), macie dwie drogi:

  • OAuth: wystarczy jedno połączenie. Obejmuje wszystkie wasze Workspaces, a w czacie wskazujecie ten właściwy.
  • Token API: wygeneruj osobny token dla każdego Workspace. W konfiguracji klienta każdy token należy przypisać do osobnej nazwy serwera MCP (picasi-kunde-a, picasi-kunde-b). Asystent będzie wtedy postrzegał te narzędzia jako oddzielne zestawy. To droga na wypadek, gdy asystent ma świadomie widzieć tylko jeden Workspace.

Wywołanie get_team_context pokazuje w dowolnym momencie w polu team.name, z którym Workspace asystent aktualnie pracuje — pozwala to wykluczyć pomyłki.

Starszy adres z kodem Workspace na końcu (https://picasi.app/mcp/t-...) pozostaje ważny. Istniejące połączenia działają dalej, niczego nie musicie przestawiać.

Bezpieczeństwo i kontrola

To wy zachowujecie kontrolę. Każde połączenie jest w Picasi widoczne i można je w każdej chwili cofnąć pojedynczo — natychmiast i bez pozostałości. Gdzie stoi, wynika z tego, do kogo należy:

  • Połączenia osobiste są w sekcji Ustawienia osobiste → Połączenia. Tam trafia wszystko, co powstało przez adres ogólny. Każda osoba widzi i cofa tam własne.
  • Tokeny dostępu Workspace są w sekcji Ustawienia Workspace → Połączenia AI. Tę stronę widzą wszyscy członkowie; to, jaki poziom mogą nadać tokenowi, ogranicza ich własna rola.

Połączenie osobiste nie pojawia się na stronie Workspace, bo nie należy do żadnego Workspace. Aby zakończyć dostęp członka do waszego Workspace, usuńcie go z Workspace — to działa też na jego połączenie osobiste, bo decyduje członkostwo.

Tokeny są ograniczone pod względem ról: token czytelnika nie pozwala na tworzenie źródeł, niezależnie od tego, jak asystent go wykorzystuje. W przypadku połączeń OAuth dodatkowym ograniczeniem jest wybrany zakres (scope).

Tematy powiązane