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

<span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span>. Pytaj prostym językiem
(„wymień moje aktywne kampanie”, „dodaj ten lead”, „ile kosztowało mnie AI w tym tygodniu?”),
a asystent wywoła API <span data-t="appName">DM Champ</span> za Ciebie.

Jest to to samo API w wersji v1, które zostało opisane w [sekcji API](../api/getting-started.md), 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 <span data-t="appName">DM Champ</span> (wysyłany jako nagłówek `X-API-Key`)
- **Wymagania:** plan z dostępem do API. [Utwórz klucz API →](api-access.md#generating-your-api-key)

> 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

```bash
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:

```json
{
  "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:

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

Zrestartuj Claude Desktop. Narzędzia <span data-t="appName">DM Champ</span> 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 <span data-t="appName">DM Champ</span>

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 <span data-t="appName">DM Champ</span> bez oddzielnego
klienta:

```json
{
  "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](../agency/api-for-agencies.md), 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.dmchamp.com/llms.txt` (indeks wszystkich stron pomocy z linkiem do wersji Markdown każdej z nich) lub `https://docs.dmchamp.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](../api/getting-started.md#reading-these-docs-as-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](api-access.md#generating-your-api-key), 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](api-access.md) — wygeneruj lub zresetuj klucz używany przez to połączenie.
- [Webhooki](webhooks.md) — odpowiednik tego połączenia MCP typu pull, działający w modelu push.