Kontakt
(Poradnik)

Konektor Claude dla SaaS:czego wymaga

Aktualizacja · 3 min czytania

Jeśli twoi użytkownicy pracują w Claude, konektor sprawia, że twój produkt jest w tej pracy obecny: Claude czyta ich dane i wykonuje działania na ich koncie. Oto czego Anthropic wymaga od takiego konektora, od logowania po wpis w katalogu.

Co daje konektor

Konektor to zdalny serwer MCP dodany do Claude. Dla produktu SaaS oznacza to:

  • Jedno logowanie dla wszystkich aplikacji: claude.ai, aplikacji desktopowej i mobilnej, Cowork i Claude Code.
  • W planach Team i Enterprise właściciel organizacji włącza konektor dla całego zespołu.
  • Wpis w katalogu jest opcjonalny. Użytkownik może dodać konektor po adresie serwera, a katalog daje widoczność i oznaczenie jakości.
  • Ten sam serwer zadziała jako plugin ChatGPT, z osobną konfiguracją logowania i wpisu.

Logowanie: OAuth, nie klucze API

Gdy narzędzia działają na koncie użytkownika, każdy loguje się swoim kontem przez OAuth 2.0. Klient OAuth Claude ma kilka wymagań, o które najczęściej potyka się konfiguracja:

  • Rejestracja klienta: domyślnie przez Dynamic Client Registration albo Client ID Metadata Document. Przy dużym ruchu z katalogu lepszy jest CIMD, bo DCR rejestruje nowego klienta przy każdym nowym połączeniu.
  • Na prośbę (mail do mcp-review@anthropic.com) Anthropic może przechowywać dane klienta OAuth, którego utworzysz dla Claude.
  • PKCE z metodą S256 przy każdej autoryzacji. Przepływ client_credentials bez udziału użytkownika nie jest obsługiwany.
  • Odpowiedź 401 z nagłówkiem WWW-Authenticate wskazującym metadane zasobu. Na odpowiedź 200 Claude nie zacznie logowania.
  • Adres powrotu https://claude.ai/api/mcp/auth_callback oraz adresy localhost na dowolnym porcie dla Claude Code.
  • Endpointy OAuth muszą odpowiedzieć w 10 sekund, odświeżanie tokenu w 30.

Część narzędzi bez logowania

Jeśli część narzędzi działa bez konta (np. wyszukiwanie w publicznej dokumentacji), Claude obsługuje leniwe logowanie: użytkownik korzysta z nich od razu i loguje się dopiero przy narzędziu, które potrzebuje konta. Dla firm z SSO jest Enterprise Managed Auth, czyli połączenie przez dostawcę tożsamości organizacji bez ekranu zgody.

Stały klucz API w nagłówku, wpisywany raz przez właściciela organizacji, jest w becie i dostępny tylko dla części organizacji. Nie planuj na nim konektora dla wszystkich.

Narzędzia, które przejdą weryfikację

  • Osobne narzędzia do odczytu i do zapisu. Jedno ogólne narzędzie typu api_request z parametrem metody zostanie odrzucone.
  • Każde narzędzie ma tytuł i adnotację readOnlyHint albo destructiveHint. Narzędzia do odczytu mogą działać bez pytania, zmieniające dane zawsze proszą o zgodę.
  • Nazwy do 64 znaków i opisy, które dokładnie mówią, co narzędzie robi. Bez instrukcji sterujących zachowaniem Claude i bez promocji.
  • Konkretne komunikaty błędów zamiast „Internal Server Error” i odpowiedzi o rozsądnym rozmiarze.
  • Twoje własne API na domenie twojej usługi. Konektory, które przelewają pieniądze albo generują obrazy, wideo lub dźwięk przez modele AI, nie są przyjmowane.

Osobny adres dla każdego klienta

W wielu produktach SaaS każdy klient ma własną subdomenę. W zgłoszeniu wybierasz jeden wspólny adres, stałą listę adresów (np. po jednym na region) albo wzorzec, do którego musi pasować adres wpisany przez użytkownika. Przy wzorcu Anthropic zaleca CIMD, a takie wpisy dłużej czekają na weryfikację.

Zgłoszenie do Connectors Directory

Zgłoszenie złoży każdy z płatnym planem Claude, przez portal na claude.ai/directory/manage. Poza serwerem potrzebujesz konta testowego z pełnymi danymi, publicznej dokumentacji (wystarczy wpis na blogu albo artykuł w centrum pomocy) i siedmiu oświadczeń dotyczących zasad. Pełną checklistę dla obu katalogów opisujemy w poradniku Jak trafić do katalogów ChatGPT i Claude.

Community czy Verified

Anthropic automatycznie sprawdza zgłoszenie pod kątem zasad i domyślnie publikuje je jako konektor Community. Wpisy, które system uzna za szczególnie przydatne, trafiają do weryfikacji Verified, w której recenzenci testują każde narzędzie. Nie ma osobnego wniosku o ten status. Verified dostaje znaczek przy nazwie, a przed połączeniem z konektorem Community Claude pokazuje użytkownikowi przypomnienie, że nie był szczegółowo sprawdzony.

FAQ
Czy do zgłoszenia potrzebuję planu Team albo Enterprise?
Nie. Zgłoszenie złoży każdy z płatnym planem Claude.
Czy klient może podłączyć konektor przed publikacją w katalogu?
Tak. Każdy może dodać konektor po adresie serwera jako konektor własny. Katalog dodaje widoczność i oznaczenie, nie zmienia działania narzędzi.
Czy potrzebuję osobnej aplikacji OAuth dla każdego klienta firmowego?
Nie. Klienci firmowi łączą się przez tę samą aplikację OAuth co wszyscy, a zakres dostępu wyznaczają uprawnienia użytkownika w twoim produkcie.
Poradniki

Chcesz konektor Claude dla swojego produktu?

Konektory Claude

ZRÓBMYCOŚ, COZOSTAJE→W GŁOWIE

Napisz do nas