Własny konektor

Customermates to otwartoźródłowy CRM zaprojektowany z myślą o AI, którym Twoje AI zarządza bezpośrednio przez MCP. Własny konektor to najprostszy sposób połączenia: wklej jeden adres URL, zaloguj się do Customermates i zatwierdź dostęp. Nie ma klucza API do skopiowania, pliku konfiguracji do edycji ani nakładki do zainstalowania. Autoryzujesz raz, a połączenie pozostaje aktywne.

To zalecana ścieżka dla Claude (web, aplikacja na komputer i aplikacja mobilna) oraz ChatGPT. W CLI lub edytorze (Claude Code, Codex, Cursor, Gemini CLI) użyj zamiast niej metody z kluczem API.

Jaki adres URL wkleić?

Każda przestrzeń robocza ma własny adres URL MCP:

<BASE_URL>/api/v1/mcp/w/<WORKSPACE_ID>

<BASE_URL> to adres, pod którym otwierasz Customermates, w chmurze lub we własnej instancji, a <WORKSPACE_ID> wskazuje przestrzeń roboczą. Nie musisz składać go samodzielnie: Customermates pokazuje adres URL Twojej bieżącej przestrzeni roboczej z przyciskiem kopiowania w Klucze API i konektory, gdy klikniesz Dodaj i wybierzesz Claude, a potem Konto Claude (albo ChatGPT & Codex, a potem Aplikacja ChatGPT), a także w kroku wdrożenia Połącz AI, której już używasz. Przełącz przestrzeń roboczą, aby skopiować adres innej.

Ponieważ każda przestrzeń robocza ma własny adres URL, możesz dodać do Claude kilka przestrzeni roboczych jednocześnie, po jednym konektorze na przestrzeń. Claude odrzuca drugi konektor z adresem, który już ma („A connector with this URL already exists in your organization”), więc druga przestrzeń robocza potrzebuje własnego adresu.

<BASE_URL>/api/v1/mcp nadal działa: udostępnia te same narzędzia, a ekran zgody pyta, do której przestrzeni roboczej ma należeć połączenie. Połączenia dodane wcześniej tą drogą pozostają bez zmian.

Konektor działa w każdym planie Customermates i w instancjach hostowanych samodzielnie; tylko narzędzia wiadomości, kalendarza i social media wymagają w chmurze planu z wiadomościami, czyli Pro lub wyższego.

Jak połączyć Claude z CRM Customermates?

Aby połączyć Claude ze swoim CRM, dodaj Customermates w Claude jako własny konektor:

1. Otwórz formularz konektora

   Claude → Settings → Connectors → Add custom connector.

2. Wklej adres URL

   Zostaw uwierzytelnianie na wartości domyślnej (OAuth). Bez nagłówka, bez klucza.

3. Zaloguj się i zatwierdź

   Otworzy się okno Customermates. Zaloguj się, a potem kliknij Zatwierdź na ekranie zgody.

4. Sprawdź, czy narzędzia dotarły

   Po powrocie do Claude zobaczysz Customermates z listą jego narzędzi.

Dodaj go raz, a zsynchronizuje się z Claude w przeglądarce, na komputerze i w aplikacji mobilnej. Połączenie jest powiązane z Twoim kontem Claude, a nie z jednym urządzeniem, i odświeża się w tle.

Jednym kliknięciem: w Customermates otwórz Klucze API i konektory, kliknij Dodaj, wybierz Claude w sekcji Szybkie połączenia, potem Konto Claude i kliknij Dodaj do Claude. Otworzy się okno dodawania konektora w Claude, już wypełnione adresem URL bieżącej przestrzeni roboczej i nazwą konektora zawierającą nazwę przestrzeni roboczej (tylko Claude web i Teams). Ten sam przycisk oferuje krok wdrożenia Połącz AI, której już używasz. Dodaj wymaga uprawnienia Tworzenie w wierszu API i webhooki; bez niego wklej adres URL tak, jak opisano wyżej.

Jak połączyć ChatGPT?

Aby połączyć ChatGPT, otwórz w ChatGPT: Settings → Connectors → Add connector → Custom connector (MCP).

• Name: Customermates
• URL: adres URL Twojej przestrzeni roboczej, <BASE_URL>/api/v1/mcp/w/<WORKSPACE_ID> (jaki adres)
• Authentication: OAuth

Zapisz. ChatGPT otworzy okno Customermates. Zaloguj się, a potem kliknij Zatwierdź na ekranie zgody. Wyświetlą się wszystkie narzędzia Customermates, bez klucza do przechowywania czy rotowania.

Czy ChatGPT może używać klucza API zamiast OAuth?

Tak. Dodaj konektor tak samo, ale uwierzytelnij się nagłówkiem:

1. Utwórz klucz

   W Customermates otwórz Klucze API i konektory, kliknij Dodaj i wybierz Standardowy klucz API. Skopiuj od razu 64-znakowy ciąg. Jest pokazywany tylko raz. Utworzenie klucza wymaga uprawnienia Tworzenie w wierszu API i webhooki Twojej roli, a sama strona wymaga w tym wierszu uprawnienia Dostęp do odczytu ustawionego na Wszystkie; wbudowana rola Administrator ma oba. Zobacz Klucze API.

2. Uwierzytelnij się nagłówkiem

   W formularzu konektora ustaw Authentication: Header, Header name: x-api-key, Header value: Twój klucz.

Zapisz. ChatGPT łączy się z serwerem i wyświetla wszystkie narzędzia. Customermates sprawdza klucz przy każdym żądaniu: przy kluczu błędnym, obciętym, wygasłym lub usuniętym serwer odpowiada HTTP 401 z nagłówkiem WWW-Authenticate i nic się nie wyświetla, więc utwórz nowy klucz.

Co pokazuje ekran zgody?

Konektor otwiera okno Customermates:

1. Zaloguj się

   Albo sesja jest już otwarta.

2. Sprawdź, co jest autoryzowane

   Ekran zgody, zatytułowany Połącz … z …, podaje nazwę aplikacji, która się łączy, wymienia, o co prosi (na przykład Potwierdzanie Twojej tożsamości, Odczytywanie Twojego podstawowego profilu, Odczytywanie Twojego adresu e-mail i Utrzymywanie połączenia, gdy Cię nie ma) oraz pokazuje Miejsce docelowe połączenia z hostem, do którego trafi dostęp. Przy adresie URL przestrzeni roboczej pokazuje tę przestrzeń razem z jej awatarem, a połączenie dostaje dokładnie tę przestrzeń. Przy <BASE_URL>/api/v1/mcp i kilku przestrzeniach roboczych pyta, do której ma należeć połączenie; Twoja bieżąca przestrzeń robocza jest zaznaczona domyślnie.

3. Zatwierdź

   Kliknij Zatwierdź albo Odrzuć, aby odmówić.

Wracasz do swojego AI z działającym połączeniem i listą narzędzi Customermates.

Jeśli nie możesz połączyć przestrzeni roboczej z adresu URL, ekran podaje powód i oferuje tylko Odrzuć: nie jesteś jej członkiem (zaloguj się kontem, którego tam używasz), Twoja prośba o dołączenie czeka na zatwierdzenie, Twój dostęp jest wyłączony, Twoja rola nie ma uprawnienia Dostęp do odczytu ustawionego na Wszystkie w wierszu API i webhooki, przestrzeń robocza nie ma aktywnej subskrypcji albo trzeba zaakceptować zaktualizowany regulamin.

Konektor akceptuje każdego klienta, więc bramką jest ekran zgody. Zatwierdzaj tylko połączenie, które sam zainicjujesz, a przy każdym, którego nie zainicjowano z Twojej strony, kliknij Odrzuć. Połączenie przez OAuth nie wymaga klucza API, ale Twoja rola potrzebuje uprawnienia Dostęp do odczytu ustawionego na Wszystkie w wierszu API i webhooki, tak jak przy każdym połączeniu MCP; bez niego ekran odrzuca połączenie.

Jak długo połączenie pozostaje ważne?

• Dodaj je raz w Claude web, a pojawi się też na komputerze i w aplikacji mobilnej. Połączenie jest powiązane z Twoim kontem Claude, a nie z jednym urządzeniem.
• Odświeża się w tle. Używaj go w dowolnym 30-dniowym oknie, a nie musisz autoryzować go ponownie; jeśli połączenie zostanie nieużywane dłużej, zatwierdzasz je jeszcze raz.
• Każde wywołanie działa jako użytkownik Customermates, który zatwierdził połączenie, w przestrzeni roboczej wybranej na ekranie zgody i z uprawnieniami roli tego użytkownika w niej. Klucze API działają tak samo: dziedziczą uprawnienia użytkownika-właściciela w przestrzeni roboczej, w której zostały utworzone, a zakresów przypisanych do pojedynczego klucza nie ma.
• Połączenie pozostaje w swojej przestrzeni roboczej, także z odświeżonymi tokenami. Aby pracować w kilku przestrzeniach roboczych, dodaj po jednym konektorze na przestrzeń z jej adresem URL; działają obok siebie na tym samym koncie Claude. Zobacz Przestrzenie robocze.
• Jeśli ten użytkownik ma status Nieaktywny, każde wywołanie, które odczytuje lub zmienia dane przestrzeni roboczej, kończy się komunikatem „Twoje konto użytkownika jest nieaktywne. Skontaktuj się z administratorem przestrzeni roboczej.”, dopóki członek z uprawnieniem Edycja do Użytkownicy i role nie ustawi go z powrotem na Aktywny.

Co wypróbować najpierw?

Serwer wysyła swoje instrukcje do Twojego AI w momencie połączenia, więc klient zna już przebieg pracy i zasady bezpieczeństwa. W klientach obsługujących prompty MCP (jak Claude) możesz też uruchomić wbudowany prompt get-started, żeby zacząć w spersonalizowany sposób: Twoje imię, Twoja rola i pierwsze podsumowanie przestrzeni roboczej.

• „Pokaż ostatnie dziesięć kontaktów, które utworzyłem. Czy któryś nie ma adresu e-mail?”
• „Utwórz kontakt Jane Doe w Initech, powiąż go z organizacją Initech i załóż szansę sprzedaży na 12 godzin konsultacji.”
• „Ustaw w szansie sprzedaży Acme pole Status na Wygrana i dodaj notatkę, że umowa została dziś podpisana.”
• „Które rozmowy z klientami czekają na moją odpowiedź? Przygotuj odpowiedź na najstarszą i zapisz ją jako szkic.”

Prompt z odpowiedzią wymaga kanału połączonego w Customermates Cloud od planu Pro; szkic czeka w rozmowie, aż go sprawdzisz i wyślesz.

Każda przestrzeń robocza definiuje własne typy rekordów, takie jak kontakty, szanse sprzedaży czy zadania, a pola, na przykład etap szansy sprzedaży albo priorytet zadania, również konfiguruje się osobno dla każdej przestrzeni. Zanim zaczniesz zapisywać, poproś swoje AI o wywołanie discover_record_types i get_record_model, aby zobaczyć odpowiednie pola i dozwolone wartości.

Potwierdzanie wywołań narzędzi: które mogę zawsze dopuszczać?

Customermates nigdy nie zatrzymuje wywołania narzędzia, żeby poprosić o potwierdzenie; robi to Twój klient i tam to kontrolujesz. W Claude: Settings → Connectors → Customermates, a potem ustaw każde narzędzie (albo grupę tylko do odczytu) na Always allow lub Ask.

• Odczyty (get_*, list_*, search_*) mają znacznik „tylko do odczytu”, więc można je bezpiecznie dopuszczać.
• Narzędzia, które mogą usuwać, mają znacznik destrukcyjny i zawierają słowo IRREVERSIBLE.
• Narzędzia, które tylko tworzą, zmieniają lub wysyłają, nie mają żadnego z tych znaczników; narzędzia łączone z akcją usuwania, takie jak manage_webhooks, mają znacznik destrukcyjny, podobnie jak manage_team, którego remove_member odbiera członkowi dostęp. Wśród narzędzi bez znacznika są send_email, send_chat_message, request_support, manage_social_relations, publish_social_post i comment_on_social_post, które docierają do prawdziwych ludzi, oraz move_email_thread, które przenosi pocztę w prawdziwej skrzynce.

Każde narzędzie, które nie jest tylko do odczytu, zostaw na Ask. Pełna lista znajduje się w katalogu narzędzi MCP.

Co zrobić, gdy połączenie się nie udaje?

W planie darmowym albo w CLI?

ChatGPT wymaga planu płatnego dla własnych konektorów (Claude Free pozwala na jeden), a klienci CLI i edytory w ogóle nie korzystają z przepływu konektora. Obie te grupy uwierzytelniają się kluczem API: zobacz CLI i edytory. Claude Desktop w planie darmowym może użyć wariantu z plikiem konfiguracji.

Dalej

• Katalog narzędzi MCP: każde narzędzie, które może wywołać Twoje AI.
• Webhooki: druga połowa pętli agentowej.
• CLI i edytory: konfiguracja z kluczem API dla Claude Code, Codex, Cursor i Gemini CLI.

Grok Bot

Grok Bot może pracować w Customermates przez swoją przeglądarkę. Poproś go o otwarcie Twojego adresu URL Customermates, przejmij logowanie, gdy o to poprosi, a potem opisz zadanie. Sprawdzaj szkice przed wysłaniem. Ten przepływ w przeglądarce nie wymaga nowego klucza API Customermates.

Grok Bot i konektory czatu Grok mają różne sposoby konfiguracji. W czacie Grok dodaj własny konektor MCP z adresem <BASE_URL>/api/v1/mcp i dokończ uwierzytelnianie. Zobacz oficjalny przewodnik po aplikacji Grok Bot i przewodnik po konektorach Grok.