Integracje organizacji
Zatwierdzanie serwerów MCP, z których osoby w organizacji mogą korzystać jako integracji.
Na tej stronie
Na stronie Integracje w sekcji Organizacja w Ustawieniach administratorzy organizacji zatwierdzają serwery MCP dla swojej organizacji. Dzięki MCP (Model Context Protocol) AITEZA może korzystać z narzędzi systemów zewnętrznych. Osoby w organizacji łączą się następnie z zatwierdzonymi serwerami (zobacz Integracje) i wybierają dla każdej wiadomości, z których integracji AITEZA może korzystać.
Lista serwerów
Strona wymienia serwery organizacji z ich adresem URL i wierszem podsumowania: rodzajem uwierzytelniania, liczbą połączonych osób oraz, jeśli serwer jest wyłączony, Wyłączono. Serwery zatwierdzone tylko dla wybranych grup pokazują te grupy, np. Tylko Sprzedaż, Zakupy.
- Dodaj serwer dodaje nowy serwer.
- Edytuj otwiera ustawienia serwera w panelu bocznym. Zmiany obowiązują od następnej wiadomości.
Propozycje
Pod listą serwerów sekcja Propozycje wymienia często używane serwery MCP hostowane przez ich dostawców: AITEZA Docs, Linear, Notion, Jira & Confluence, Microsoft 365, Microsoft OneDrive, SharePoint, poczta i kalendarz Outlook, Teams i Word, Google Drive, Gmail, Google Calendar, Docs, Sheets, Slides i Chat, GitHub, Slack, HubSpot, Box, Grafana, Figma, Canva i Microsoft Learn. Najpierw wyświetlanych jest sześć; Pokaż wszystkie propozycje (liczba) pokazuje pozostałe. Serwery już dodane (ten sam adres URL) przestają się pojawiać.
Każda propozycja pokazuje rodzaj uwierzytelniania oraz, jeśli dotyczy, następujące uwagi:
- Wymagana rejestracja aplikacji: usługa nie rejestruje AITEZA automatycznie. Utwórz tam aplikację z wyświetlonym URI przekierowania i wpisz jej identyfikator klienta oraz sekret klienta.
- Wymagany identyfikator dzierżawy: w przypadku serwerów Microsoft zastąp symbol zastępczy identyfikatora dzierżawy w nawiasach klamrowych w adresie URL lub serwerze autoryzacji identyfikatorem dzierżawy Microsoft Entra. Dopóki symbol zastępczy jest w adresie, formularza nie można zapisać.
- Wersja zapoznawcza: dostawca nadal oferuje serwer jako wersję zapoznawczą.
- Wymagana licencja Copilot: serwery Agent 365 firmy Microsoft (OneDrive, SharePoint, Outlook, Teams, Word) dopuszczają tylko osoby z licencją Microsoft 365 Copilot w dzierżawie włączonej do wersji zapoznawczej. Bez tej licencji użyj Microsoft 365.
- Tylko zatwierdzone aplikacje: dostawca (obecnie Figma) dopuszcza tylko zatwierdzone przez siebie aplikacje; logowanie może się nie udać, dopóki AITEZA nie zostanie zatwierdzona.
Dodaj otwiera formularz serwera wstępnie wypełniony nazwą, opisem, adresem URL, transportem i uwierzytelnianiem. U góry pokazuje uwagi i link do instrukcji konfiguracji dostawcy. Sprawdź ustawienia i zapisz.
Ustawienia serwera
| Pole | Opis |
|---|---|
| Nazwa | Wyświetlana w czacie. Jest też prefiksem nazw narzędzi w krokach wykonania. |
| Opis | Krótki opis serwera. |
| Adres URL serwera | Punkt końcowy MCP serwera, zwykle kończący się na /mcp. Musi używać https i nie może wskazywać sieci wewnętrznej. |
| Transport | Streamable HTTP (aktualny) lub HTTP z SSE (starsze serwery). |
| Uwierzytelnianie | Sposób logowania osób do serwera. Zobacz niżej. |
| Dostępny w organizacji | Po wyłączeniu nikt nie widzi serwera. Istniejące połączenia zostają zachowane. |
| Tylko dla wybranych grup | Wyłączone: każdy w organizacji może połączyć się z serwerem. Włączone: tylko członkowie wybranych grup go widzą i z niego korzystają. Zobacz Zatwierdzanie dla grup. |
Zatwierdzanie dla grup
Gdy opcja Tylko dla wybranych grup jest włączona, zaznacz jedną lub więcej grup organizacji. Musi być zaznaczona co najmniej jedna grupa („Wybierz co najmniej jedną grupę.”). Bez grup serwer jest dostępny dla całej organizacji.
Osoby spoza wybranych grup nie widzą serwera ani w Ustawienia > Integracje, ani w czacie, nie mogą się z nim połączyć, a jego narzędzia nigdy nie są dla nich używane. Możesz np. udostępnić OneDrive tylko grupie Sprzedaż, a nie grupie Rozwój.
Jeśli zatwierdzona grupa zostanie usunięta, serwer nie zostaje otwarty dla wszystkich. Ma po prostu o jedną grupę mniej; usuń tę grupę z wyboru.
Rodzaje uwierzytelniania
| Rodzaj | Kiedy go używać |
|---|---|
| Osobiste logowanie (OAuth) | Każdy loguje się własnym kontem. Wymagane dla Microsoft 365, Google, GitHub i większości narzędzi biznesowych. |
| Osobisty klucz | Każdy wpisuje własny klucz API lub osobisty token dostępu. |
| Klucz organizacji | Jeden klucz zapisany przez administratora jest używany przez wszystkich. Wszyscy widzą te same dane. |
| Bez uwierzytelniania | Serwery publiczne. |
Klucze
Dla opcji Osobisty klucz i Klucz organizacji pole Klucz przekazywany jako określa, gdzie AITEZA wysyła klucz:
- Nagłówek: nagłówek żądania. Wpisz w polu Nagłówek jego nazwę (domyślnie
Authorization), a w polu Prefiks tekst przed kluczem (domyślnieBearer). - Uwierzytelnianie Basic (użytkownik:hasło): klucz wpisuje się jako
użytkownik:hasło, np.email:api-token. - Parametr URL: parametr adresu URL serwera. Wpisz Nazwę parametru, np.
token. Używaj go tylko wtedy, gdy usługa tego wymaga: adresy URL mogą trafiać do dzienników serwerów i serwerów proxy, dlatego nagłówek jest bezpieczniejszy.
Klucz organizacji można tylko zapisać. Jest przechowywany w postaci zaszyfrowanej i nigdy nie jest ponownie wyświetlany. Aby zachować zapisany klucz podczas edycji serwera, pozostaw pole puste.
Osobiste logowanie (OAuth)
Dla opcji Osobiste logowanie (OAuth) panel boczny pokazuje URI przekierowania. Jeśli usługa wymaga zarejestrowanej aplikacji (klienta), wpisz ten URI podczas tworzenia aplikacji w usłudze.
| Pole | Opis |
|---|---|
| Identyfikator klienta | Identyfikator aplikacji zarejestrowanej w usłudze. Pozostaw puste, jeśli usługa obsługuje automatyczną (dynamiczną) rejestrację klienta. AITEZA zarejestruje się wtedy sama. |
| Sekret klienta | Sekret aplikacji. Podobnie jak klucz organizacji można go tylko zapisać. |
| Zakresy (scopes) | Oddzielone spacjami. Jeśli pole jest puste, AITEZA żąda tego, czego wymaga serwer. AITEZA dodaje offline_access, jeśli usługa to oferuje, aby połączenia mogły być odnawiane. |
| Serwer autoryzacji (opcjonalnie) | Tylko dla serwerów, które nie podają swojego serwera autoryzacji, np. wystawca Microsoft Entra ID taki jak https://login.microsoftonline.com/<tenant-id>/v2.0. |
| Wysyłaj wskaźnik zasobu | Wymagany przez specyfikację MCP. Wyłącz go tylko wtedy, gdy logowanie kończy się błędem dotyczącym parametru resource. |
Testowanie serwera
Testuj połączenie sprawdza zapisane ustawienia:
- Serwery bez osobistego logowania (klucz organizacji lub bez uwierzytelniania) są łączone, a ich narzędzia wyświetlane.
- W przypadku serwerów z osobistym logowaniem AITEZA wyszukuje serwer autoryzacji.
- W przypadku serwerów z osobistymi kluczami AITEZA sprawdza, czy serwer jest osiągalny.
Zmiany wpływające na połączenia
- Zmiana Adresu URL serwera, Identyfikatora klienta lub Serwera autoryzacji powoduje wygaśnięcie połączeń wszystkich osób. Muszą one wtedy połączyć się ponownie.
- Zmiana rodzaju Uwierzytelniania usuwa wszystkie połączenia.
- Usuń usuwa serwer i wszystkie połączenia z nim. Potwierdzenie pokazuje, ile osób straci połączenie.
Wszystkie zmiany są rejestrowane w dzienniku audytu w obszarze Administracja, z akcjami MCP_SERVER_CREATE, MCP_SERVER_UPDATE, MCP_SERVER_DELETE, MCP_CONNECTION_CREATE i MCP_CONNECTION_DELETE. Wpisy MCP_SERVER_CREATE i MCP_SERVER_UPDATE zawierają zatwierdzone grupy.
Microsoft 365
Propozycja Microsoft 365 jest wbudowana w AITEZA. Działa z każdym planem Microsoft 365 dla firm; w przeciwieństwie do serwerów Agent 365 firmy Microsoft osoby nie potrzebują licencji Microsoft 365 Copilot. AITEZA czyta i zapisuje dane przez Microsoft Graph z logowaniem danej osoby, więc każdy widzi tylko to, do czego ma dostęp w Microsoft 365. Zarządza się nią jak każdym innym serwerem: udostępnianie, grupy, połączenia i dziennik audytu działają tak samo.
Narzędzia wyszukują i czytają wiadomości e-mail, wyświetlają wydarzenia z kalendarza, wyszukują i czytają pliki i foldery w OneDrive i SharePoint (Word, Excel, PowerPoint, PDF i pliki tekstowe) oraz znajdują współpracowników. Tworzenie i zmiana wersji roboczych, wysyłanie wiadomości i odpowiedzi, dołączanie plików AITEZA (załączników czatu, plików z pokojów danych, wygenerowanych plików) do wiadomości, przesyłanie plików AITEZA do OneDrive lub SharePoint oraz tworzenie wydarzeń zmieniają dane: przed każdą z tych akcji AITEZA pyta osobę na czacie. Dołączać i przesyłać można tylko pliki, które dana osoba może otworzyć w AITEZA; każdy taki dostęp jest zapisywany w dzienniku audytu.
Konfiguracja Microsoft 365
- 1
W Microsoft Entra zarejestruj aplikację z platformą Sieć Web i dodaj URI przekierowania wyświetlony w formularzu serwera. Jeśli Microsoft 365 jest już skonfigurowany dla magazynu w chmurze, możesz użyć tej aplikacji i dodać w niej ten URI przekierowania.
- 2
Nadaj delegowane uprawnienia Microsoft Graph
offline_access,User.Read,Mail.ReadWrite,Mail.Send,Calendars.ReadWrite,Files.ReadWrite.All,Sites.ReadWrite.All,People.Readoraz zgodę administratora. Utwórz sekret klienta. Jeśli Microsoft 365 skonfigurowano z wcześniejszymi uprawnieniami tylko do odczytuFiles.Read.AlliSites.Read.All, zastąp je w Entra i w zakresach serwera; osoby łączą potem Microsoft 365 ponownie w Ustawienia › Integracje. - 3
W sekcji Propozycje przy Microsoft 365 wybierz Dodaj. Zakresy i serwer autoryzacji są wstępnie wypełnione. W serwerze autoryzacji zastąp symbol zastępczy identyfikatora dzierżawy identyfikatorem lub domeną dzierżawy Microsoft Entra.
- 4
Wpisz Identyfikator klienta i Sekret klienta. Jeśli Microsoft 365 jest już skonfigurowany dla magazynu w chmurze, włącz zamiast tego Użyj aplikacji Microsoft z magazynu w chmurze: AITEZA przejmie identyfikator klienta, sekret klienta i katalog. Zapisz.
AITEZA Docs
Propozycja AITEZA Docs jest wbudowana w AITEZA i nie wymaga logowania ani klucza. Dzięki niej AITEZA przeszukuje i czyta tę dokumentację po angielsku, niemiecku i polsku, odpowiada na pytania o obsługę AITEZA i podaje link do odpowiedniej strony. W sekcji Propozycje wybierz Dodaj obok AITEZA Docs i zapisz; serwer jest wtedy dostępny jak każdy inny, łącznie z grupami i dziennikiem audytu. AITEZA wczytuje opublikowaną dokumentację i co godzinę sprawdza zmiany.
Typowe konfiguracje
Dokładne kroki zależą od usługi. Punkt końcowy MCP i sposób rejestracji aplikacji znajdziesz w dokumentacji usługi.
Usługi z automatyczną rejestracją, np. wiele serwerów MCP dostawców SaaS:
- Wpisz Adres URL serwera.
- Wybierz Osobiste logowanie (OAuth).
- Pozostaw Identyfikator klienta pusty.
Usługi wymagające zarejestrowanej aplikacji, np. Microsoft 365 lub OneDrive przez Microsoft Entra ID, GitHub, Google Workspace, Slack, Box lub HubSpot:
- Wybierz Osobiste logowanie (OAuth) i skopiuj wyświetlony URI przekierowania.
- Zarejestruj u dostawcy aplikację z tym URI przekierowania i nadaj jej potrzebne uprawnienia. W przypadku Microsoft administrator zwykle musi udzielić zgody administratora w Entra ID.
- Wpisz Identyfikator klienta i Sekret klienta aplikacji, a w razie potrzeby Zakresy (scopes) i Serwer autoryzacji.
Usługi z kluczami API lub osobistymi tokenami dostępu:
- Wybierz Osobisty klucz (lub Klucz organizacji, jeśli wszyscy mają używać jednego wspólnego klucza).
- W polu Klucz przekazywany jako wybierz Nagłówek i nagłówek, którego oczekuje usługa.
Warto wiedzieć
- Narzędzia integracji działają tylko z modelami obsługującymi tryb agenta (zobacz Modele organizacji).
- Goście Relay nigdy nie korzystają z integracji.
- AITEZA traktuje wyniki integracji jako niezaufane treści zewnętrzne. Z narzędzi, które zmieniają lub usuwają dane, AITEZA korzysta tylko wtedy, gdy ktoś wyraźnie o to poprosi.
