MCP — korzystanie 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ć raporty
- sprawdzać kontekst zespołu (kontekst AI)
Dzięki uprawnieniu do zapisu (token administratora lub OAuth z zakresem „write”) 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 poziom uprawnień (poziom uprawnień). Poziom ten stanowi ograniczenie: określa, co asystent może robić za pośrednictwem tego połączenia, niezależnie od waszej roli w Workspace.
| Poziom | Dozwolone | Niedozwolone |
|---|---|---|
| Tylko do odczytu | Odczytywanie Updates, pobieranie źródeł i raportów, sprawdzanie kontekstu zespołu | Tworzenie, edytowanie lub usuwanie źródeł lub kanałów |
| Tylko do odczytu i zapisu (domyślnie) | Wszystko z poziomu „Tylko do odczytu” oraz zarządzanie źródłami, kanałami i Inbox | Zarządzanie ustawieniami zespołu i ustawieniami AI |
| Administrator | Wszystkie operacje MCP, w tym ustawienia zespołu | Zarządzanie rozliczeniami |
Poziomy, które możecie wybrać, są ograniczone przez waszą rolę w Workspace. Członek bez uprawnień administratora nie widzi opcji Admin.
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 API nie mają daty wygaśnięcia. Pozostają ważne do momentu ich cofnięcia w Picasi w sekcji Ustawienia → Tokeny API lub do momentu opuszczenia Workspace przez danego użytkownika. Cofnięty 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 musicie ponownie skonfigurować połączenie, wybierając Ustawienia → Połącz asystenta AI.
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 API 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 Ustawieniach osobistych → Połączenia. Tam trafia wszystko, co powstało przez adres ogólny. Każda osoba widzi i cofa tam własne.
- Połączenia powiązane z Workspace oraz tokeny API są w Ustawienia → Połączenia AI i tokeny. Tę stronę widzą admini i ownerzy.
Połączenie osobiste nie pojawia się na liście 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).