Połącz asystentów AI (MCP)

DM Champ dostarcza oficjalny serwer MCP — punkt końcowy Model Context Protocol, który pozwala asystentom AI, takim jak Claude Code, Claude Desktop, ChatGPT, Cursor oraz Twoim własnym aplikacjom, bezpośrednio obsługiwać Twoje konto DM Champ. Pytaj prostym językiem („wymień moje aktywne kampanie”, „dodaj ten lead”, „ile kosztowało mnie AI w tym tygodniu?”), a asystent wywoła API DM Champ za Ciebie.

Jest to to samo API w wersji v1, które zostało opisane w sekcji API, uwierzytelniane za pomocą własnego klucza API. Serwer MCP tworzy jedno narzędzie dla każdej operacji w naszej opublikowanej specyfikacji API, dzięki czemu obejmuje ono większość, choć nie całe API v1: kontakty, wiadomości, kampanie, agentów AI, bazę wiedzy, spotkania, analitykę, tagi, listy oraz subkonta. Transmisje, automatyzacje i transakcje nie są jeszcze dostępne jako narzędzia MCP — w ich przypadku należy korzystać bezpośrednio z REST API. W ramach tego, co jest udostępnione, nie ma uprawnień dla poszczególnych narzędzi ani domyślnego trybu tylko do odczytu, więc klucz API stanowi pełną kontrolę dostępu.

Punkt końcowy: https://mcp.youraiconnector.com/mcp
Autoryzacja: Twój klucz API DM Champ (wysyłany jako nagłówek X-API-Key)
Wymagania: plan z dostępem do API. Utwórz klucz API →

Twój klucz API działa w ramach Twojego własnego konta, z takimi samymi uprawnieniami jak reszta API — i może odczytywać konta klientów, którymi zarządzasz, jeśli korzystasz z planu agencyjnego (patrz poniżej). Traktuj go jak hasło. Możesz go w każdej chwili unieważnić w sekcji Ustawienia → Integracje → Klucz API, co natychmiast odetnie dostęp asystenta.

Claude Code

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Następnie uruchom /mcp wewnątrz Claude Code, aby potwierdzić, że wyświetla się dm-champ ✓ connected.

Domyślnie serwer jest dodawany w zakresie lokalnym (tylko Ty, ten projekt). Użyj --scope user, aby udostępnić go we wszystkich swoich projektach, lub --scope project to commit it to a repo’s .mcp.json dla swojego zespołu:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Edytuj swój plik claude_desktop_config.json (Ustawienia → Deweloper → Edytuj konfigurację) i dodaj:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Zrestartuj Claude Desktop. Narzędzia DM Champ pojawią się w menu narzędzi.

ChatGPT

Niestandardowe konektory MCP są dostępne w ChatGPT Business, Enterprise i Pro. Właściciel lub administrator obszaru roboczego musi najpierw włączyć tryb deweloperski / niestandardowe konektory w ustawieniach obszaru roboczego — bez tego opcja utworzenia konektora się nie pojawi.

Następnie utwórz konektor za pomocą:

URL: https://mcp.youraiconnector.com/mcp
Autoryzacja: Niestandardowe nagłówki
Nazwa nagłówka: X-API-Key
Wartość nagłówka: Twój klucz API DM Champ

Adres URL musi kończyć się na /mcp. Wklejenie samego https://mcp.youraiconnector.com to najczęstszy błąd — ChatGPT sprawdza dokładnie ten adres, nic pod nim nie znajduje i wyświetla “Unable to add connector URL”.

Cursor i inni klienci MCP

Większość edytorów obsługujących MCP korzysta z tego samego formatu .mcp.json, co pokazano powyżej (serwer HTTP z url i nagłówkiem X-API-Key). Dodaj serwer dm-champ wskazujący na https://mcp.youraiconnector.com/mcp i wklej swój klucz API w nagłówku.

API Claude (wbudowanie we własną aplikację)

Możesz połączyć się z serwerem MCP programowo za pomocą konektora MCP API Claude, dzięki czemu tworzony przez Ciebie agent może korzystać z narzędzi DM Champ bez oddzielnego klienta:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

Co możesz zrobić

W ramach części API v1 udostępnianej przez serwer MCP asystent automatycznie wybiera odpowiednie narzędzie:

Kampanie: lista, tworzenie, aktualizacja, wstrzymywanie/wznawianie, sprawdzanie konfiguracji bota.
Kontakty: wyszukiwanie, tworzenie, tagowanie, dodawanie do list, import.
Baza wiedzy / FAQ: dodawanie, edycja, import masowy, zatwierdzanie sugestii AI.
Wiadomości: czytanie konwersacji, wysyłanie wiadomości do kontaktu.
Spotkania: lista, rezerwacja, anulowanie.
Zadania: tworzenie, kończenie, lista.
Analityka: statystyki wiadomości, zużycie kredytów, koszt AI.
Kanały: sprawdzanie statusu połączenia, rozpoczynanie procesu łączenia.

Pytania o konta Twoich klientów (agencje)

Jedno połączenie obejmuje wszystkie konta, którymi zarządzasz. Nie musisz dodawać drugiego połączenia dla każdego klienta: w planie agencyjnym asystent może odczytać dowolne konto klienta podpięte pod Ciebie, dzięki czemu możesz pytać o nie wszystkie w ramach jednej konwersacji.

Wystarczy wymienić nazwę klienta:

„Ile kontaktów ma Bella’s Bistro?”
„Ile kosztowało AI dla każdego z moich klientów w tym tygodniu?”
„Które kampanie są aktywne dla Northside Dental i jaki jest stan ich kanałów?”

Obejmuje to odczyt kontaktów, wiadomości, czatów, kampanii, spotkań, zadań, tagów, wydarzeń, FAQ, źródeł bazy wiedzy, numerów telefonów, kanałów, webhooków i analityki. Zanim cokolwiek zostanie uruchomione, sprawdzamy, czy konto rzeczywiście należy do Ciebie — zapytanie o konto, które do Ciebie nie należy, zwróci wynik „nie znaleziono”. Jeśli pominiesz nazwę klienta, asystent odczyta Twoje własne konto, dokładnie tak jak wcześniej.

Zmiana konta klienta jest bardziej ograniczona. Konfigurowanie agentów AI, funkcji niestandardowych, szablonów WhatsApp, punktów wejścia, połączeń kanałów, statusu kampanii oraz zakup numeru działają dla wskazanego klienta; większość innych operacji zapisu nadal jest wykonywana na Twoim własnym koncie, więc wykonuj je przy użyciu klucza tego klienta lub za pośrednictwem REST API, które oferuje szersze możliwości.

Jest to również rozwiązanie dla klienta, który prowadzi kilka firm w ramach jednego loginu. Przypisz każdej firmie osobne konto, a następnie zaproś adres e-mail klienta jako członka zespołu do wszystkich z nich: loguje się on raz i przełącza między swoimi markami za pomocą selektora kont na pasku bocznym.

Udostępnianie asystentowi dokumentacji pomocy

Serwer MCP udostępnia asystentowi Twoje konto; nie udostępnia mu tej dokumentacji. Jeśli chcesz, aby poprawnie odpowiadał również na pytania typu „jak…”, wskaż mu https://docs.youraiconnector.com/llms.txt (indeks wszystkich stron pomocy z linkiem do wersji Markdown każdej z nich) lub https://docs.youraiconnector.com/llms-full.txt (całą dokumentację w jednym pliku Markdown). Oba zasoby są publiczne, nie wymagają klucza i są przebudowywane przy każdej zmianie w dokumentacji. Zobacz Czytanie tej dokumentacji w formacie Markdown.

Znajdowanie lub generowanie klucza API

Klucz API używany przez to połączenie znajduje się w sekcji Ustawienia → Integracje → Klucz API — jest to osobna sekcja, niezależna od Webhooków. Zobacz Dostęp do API, aby poznać dokładne kroki.

Rozwiązywanie problemów

“Unable to add connector URL” (ChatGPT) / “connection refused” — w adresie brakuje /mcp na końcu. Użyj https://mcp.youraiconnector.com/mcp, a nie https://mcp.youraiconnector.com.
Needs authentication / 401 — Twój klucz API jest błędny lub go brakuje. Dodaj serwer ponownie z poprawnym X-API-Key.
Narzędzie zwraca 403 — Twój plan lub rola w zespole nie pozwalają na wykonanie tej akcji; serwer MCP nie wymusza żadnych dodatkowych ograniczeń, obowiązuje ta sama kontrola uprawnień co w API.
Nie znaleziono narzędzia — lista narzędzi jest generowana na żywo z API, więc zawsze odpowiada aktualnej wersji; połącz się ponownie, aby odświeżyć.
Ostrzeżenie o zabezpieczeniach lub certyfikacie w Twojej domenie — samo wskazanie rekordu DNS na nas nie wystarczy: subdomena musi również zostać zweryfikowana w panelu, zanim będzie mogła obsługiwać bezpieczne połączenie. Agencje korzystające z white-label mogą umieścić adres MCP we własnej domenie (np. mcp.youragency.com) w karcie Własna domena w sekcji Ustawienia → White Labeling — najpierw dodaj CNAME u swojego rejestratora, następnie wprowadź nazwę hosta w bloku Domena MCP (asystenci AI) i kliknij Zweryfikuj, zgodnie z tą samą procedurą, co w przypadku innych Twoich subdomen z brandingiem. Dopóki weryfikacja nie zostanie zakończona, używaj standardowego adresu powyżej — nie posiada on brandingu, więc można go bezpiecznie udostępniać klientom.

Następne kroki

Dostęp do API — wygeneruj lub zresetuj klucz używany przez to połączenie.
Webhooki — odpowiednik tego połączenia MCP typu pull, działający w modelu push.

Połącz asystentów AI (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor i inni klienci MCP #

API Claude (wbudowanie we własną aplikację) #

Co możesz zrobić #

Pytania o konta Twoich klientów (agencje) #

Udostępnianie asystentowi dokumentacji pomocy #

Znajdowanie lub generowanie klucza API #

Rozwiązywanie problemów #

Następne kroki #