CLI i edytory

Customermates to otwartoźródłowy CRM zaprojektowany od początku z myślą o AI. Po połączeniu Twój agent programistyczny odczytuje i zapisuje kontakty, szanse sprzedaży i notatki, nie wychodząc z terminala. Wszyscy opisani tu klienci uwierzytelniają się tak samo: kluczem API w nagłówku x-api-key na adres <BASE_URL>/api/v1/mcp, gdzie <BASE_URL> to adres, pod którym otwierasz Customermates, w chmurze lub we własnej instancji. Poniższe fragmenty zawierają już adres strony, która pokazuje tę stronę dokumentacji; jeśli otwierasz Customermates pod innym adresem, zmień go oraz YOUR_KEY.

Utwórz klucz API

W Customermates otwórz Klucze API i konektory, kliknij Dodaj i wybierz Standardowy klucz API. Nadaj mu nazwę klienta (na przykład Claude Code); bez wartości w polu Wygasa za klucz nigdy nie wygasa. 64-znakowy klucz jest pokazywany tylko raz, więc skopiuj go od razu. Szybkie połączenia w tym samym oknie robią to za Ciebie: nadają kluczowi nazwę klienta, ustawiają jego wygaśnięcie po 365 dniach i pokazują fragment konfiguracji z wpisanym kluczem, a pod nim termin jego ważności.

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. Klucz dziedziczy uprawnienia użytkownika, który go utworzył; nie ma zakresów przypisanych do pojedynczego klucza. Utwórz osobny klucz dla każdego klienta, aby móc unieważnić jeden bez ruszania pozostałych; dziennik aktywności zapisuje użytkownika, do którego należy klucz, a nie sam klucz. Klucze API i MCP działają w każdym planie oraz w instancjach hostowanych samodzielnie. Szczegóły: Klucze API.

Claude Code

Claude Code dodaje serwery MCP przez swoje CLI. Całą konfigurację załatwia jedno polecenie. Uruchom je w dowolnym terminalu, zastępując YOUR_KEY:

claude mcp add --transport http customermates https://customermates.com/api/v1/mcp \
  --header "x-api-key: YOUR_KEY"

Nie trzeba ponownie uruchamiać programu ani edytować pliku konfiguracji. Claude Code łączy się automatycznie. Uruchom claude mcp list, aby sprawdzić, czy customermates jest na liście.

Zakres: polecenie domyślnie używa zakresu lokalnego. Dodaj --scope user, aby Customermates było dostępne wszędzie na Twoim komputerze, albo --scope project, aby zapisać je w pliku .mcp.json repozytorium, tak by pobrali je członkowie zespołu.

Codex

Codex łączy się bezpośrednio z Customermates przez Streamable HTTP. Polecenie codex mcp add customermates --url <BASE_URL>/api/v1/mcp dodaje adres serwera, ale polecenie CLI nie ma opcji na własny nagłówek x-api-key. Aby użyć klucza API, otwórz ~/.codex/config.toml (utwórz go, jeśli go nie ma) i dodaj poniższy kompletny blok, zastępując YOUR_KEY:

[mcp_servers.customermates]
enabled = true
url = "https://customermates.com/api/v1/mcp"
http_headers = { "x-api-key" = "YOUR_KEY" }

Aby pobierać klucz ze zmiennych środowiskowych zamiast zapisywać go w pliku, zastąp linię http_headers w powyższym bloku taką:

env_http_headers = { "x-api-key" = "CUSTOMERMATES_API_KEY" }

Następnie wyeksportuj CUSTOMERMATES_API_KEY w profilu powłoki. Nowe sesje wczytują serwer, więc zakończ bieżącą sesję i uruchom nową.

Ten sam endpoint HTTP przyjmuje też OAuth. Jeśli wolisz się zalogować, dodaj adres poleceniem codex mcp add customermates --url <BASE_URL>/api/v1/mcp, a potem uruchom codex mcp login customermates. Opisany niżej most stdio jest dla klientów Claude Desktop, którzy go potrzebują.

Cursor

Aby skonfigurować Cursor, otwórz Settings → Tools & MCP → Add new MCP server i wklej poniższy fragment, zastępując YOUR_KEY:

{
  "customermates": {
    "url": "https://customermates.com/api/v1/mcp",
    "headers": {
      "x-api-key": "YOUR_KEY"
    }
  }
}

Cursor przeładowuje konfigurację w locie, więc restart nie jest potrzebny. Narzędzia pojawiają się w Composerze od razu. Aby edytować plik bezpośrednio, ten sam blok trafia do ~/.cursor/mcp.json (globalnie) albo do <project>/.cursor/mcp.json (dla projektu), w obiekcie mcpServers.

Gemini CLI

Gemini CLI wczytuje serwery MCP z ~/.gemini/settings.json. Dołącz poniższy fragment do pliku, zastępując YOUR_KEY:

{
  "mcpServers": {
    "customermates": {
      "httpUrl": "https://customermates.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Jeśli w mcpServers są już wpisy, dodaj customermates obok istniejących, zamiast nadpisywać cały obiekt.

Claude Desktop (plik konfiguracji)

Zalecaną drogą dla Claude Desktop jest ścieżka przez konektor: OAuth, bez klucza, synchronizowane między Twoimi urządzeniami. W planie darmowym albo jeśli wolisz stały klucz, działa też poniższy plik konfiguracji.

Otwórz Claude → Settings → Developer → Edit Config albo bezpośrednio plik:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Dołącz poniższy fragment do pliku, zastępując YOUR_KEY:

{
  "mcpServers": {
    "customermates": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://customermates.com/api/v1/mcp",
        "--header",
        "x-api-key:YOUR_KEY"
      ]
    }
  }
}

mcp-remote to nakładka, dzięki której Claude Desktop może rozmawiać ze zdalnym serwerem MCP przez HTTP za pośrednictwem stdio. Pobiera się przy pierwszym uruchomieniu przez npx, więc potrzebujesz Node 18+ w PATH.

Potem uruchom program ponownie: zamknij go całkowicie (⌘Q w macOS, samo zamknięcie okna nie wystarczy) i otwórz jeszcze raz. Customermates pojawi się w panelu narzędzi z wypisanymi narzędziami CRM.

Wypróbuj pierwsze polecenie

Serwer przekazuje instrukcje połączenia, które opisują jego narzędzia, zasady bezpieczeństwa i sposób pobierania odpowiednich stron Bazy wiedzy. Klient sam decyduje, czy przekaże je swojemu agentowi. Jeśli Twój tego nie robi, dodaj regułę pobierania Bazy wiedzy do stałych instrukcji tego klienta. W klientach obsługujących prompty MCP (jak Claude Code) możesz uruchomić wbudowany prompt get-started, który prowadzi przez start: najpierw odczytuje Twoją przestrzeń roboczą i odpowiednie strony Bazy wiedzy, a potem pyta tylko o brakujące informacje.

• „Ustaw w szansie sprzedaży Acme pole Status na «Wygrana» i dodaj notatkę, że umowa została dziś podpisana.”
• „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.”
• „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 atrybuty, na przykład etap szansy sprzedaży albo priorytet zadania, również zależą od konfiguracji przestrzeni roboczej. Zanim zaczniesz zapisywać, wywołaj discover_record_types, a potem get_record_model dla odpowiednich identyfikatorów typów.

Rozwiązywanie problemów

Dalej

• Własny konektor: ścieżka OAuth dla aplikacji Claude i ChatGPT.
• Katalog narzędzi MCP: każde narzędzie, które agent może wywołać.
• Webhooki: subskrybuj zmiany w CRM w innych systemach.