Back to blog

Najlepszy AI companion dla Bitrix CMS: Połącz Mii przez MCP

it • 7/7/2026

Zamień swoją witrynę w Bitrix w przestrzeń do rozmów. Ten poradnik pokazuje, jak połączyć Mia Handles z 1C-Bitrix za pomocą modułu hiweb.site_mcp — instalacja, konfiguracja autoryzacji bearer i zarządzanie treścią z poziomu Telegrama.

Najlepszy AI companion dla Bitrix CMS: Połącz Mii przez MCP

Najlepszy AI companion dla Bitrix CMS: Połącz Mię przez MCP

Menedżer witryn Bitrix zasila miliony witryn firmowych na całym świecie — a dzięki Model Context Protocol (MCP) rozmawia teraz bezpośrednio z Mią, twoim osobistym asystentem AI. W tym poradniku przeprowadzimy cię przez pełną konfigurację: od zainstalowania oficjalnego modułu MCP po połączenie go z twoją rozmową z Mią.

Po połączeniu możesz poprosić Mię o zarządzanie wiadomościami, iblockami, użytkownikami, zamówieniami i więcej — wszystko z jednej rozmowy na Telegramie. Bez kart przeglądarki, bez paneli administracyjnych, bez przełączania kontekstu.

Co to jest MCP i dlaczego warto się tym zainteresować?

Model Context Protocol to otwarty standard, który pozwala agentom AI komunikować się z zewnętrznymi usługami za pomocą uporządkowanego, bezpiecznego interfejsu.

Serwer MCP udostępnia możliwości systemu. Klient MCP (Mia) łączy się z tym serwerem i uruchamia te możliwości w twoim imieniu.

Dla właścicieli stron Bitrix oznacza to, że możesz robić takie rzeczy jak:

  • Poprosić Mię o publikowanie wiadomości lub aktualizowanie wpisów iblock
  • Wyszukiwać zamówienia, klientów lub produkty według kryteriów
  • Generować raporty ze sprzedaży, ruchu lub wyników treści
  • Tworzyć użytkowników, przypisywać role lub zarządzać uprawnieniami
  • Pobierać analitykę lub wskaźniki wydajności

Wszystko z jednej rozmowy na Telegramie.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

  • Witrynę 1C-Bitrix (z licencją, z włączoną instalacją modułów)
  • Dostęp administracyjny do instalacji modułów i konfiguracji ustawień
  • Konto Mia Handles z co najmniej planem Standard (połączenia MCP wymagają dostępu do API)
  • Certyfikat SSL na twojej stronie Bitrix (HTTPS jest wymagany dla endpointu MCP)

Krok 1 — Zainstaluj moduł hiweb.site_mcp

Zalecany moduł to hiweb.site_mcp z Bitrix Marketplace. Zapewnia oficjalną implementację serwera MCP dla Bitrix.

Link do marketplace: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Uwaga: Strona marketplace jest obecnie w budowie, ale wkrótce zostanie opublikowana. Jeśli już masz moduł, przejdź do Kroku 2.

W panelu administracyjnym Bitrix:

  1. Przejdź do Ustawienia → Marketplace
  2. Wyszukaj hiweb.site_mcp lub użyj bezpośredniego linku powyżej
  3. Zainstaluj i aktywuj moduł
  4. Po aktywacji przejdź do Ustawienia → Ustawienia witryny → MCP Server

Tam znajdziesz:

  • Endpoint URL — publiczny adres dla endpointu MCP (zwykle https://twojadomena.com/api/mcp/)
  • Authentication — konfiguracja tokenu bearer
  • Tools to expose — przełączniki, które możliwości Bitrix Mia może mieć dostęp (iblocks, news, users, orders, analytics itd.)

Krok 2 — Wygeneruj token Bearer

Moduł Bitrix MCP używa uwierzytelniania Bearer token do bezpiecznego dostępu do API.

  1. Przejdź do Ustawienia → Ustawienia witryny → MCP Server
  2. Kliknij Generate Token lub Create New Token
  3. Nadaj mu nazwę, na przykład Mia MCP Integration
  4. Ustaw datę ważności tokenu (zalecane: brak wygaśnięcia do użycia w produkcji)
  5. Skopiuj wygenerowany token — zobaczysz go tylko raz

Ten token staje się poświadczeniem, którego Mia używa do połączenia z twoją witryną Bitrix.

Krok 3 — Udostępnij endpoint w bezpieczny sposób

Endpoint MCP powinien być dostępny tylko dla usług, którym ufasz. Typowe opcje:

  • Bearer token auth — każda prośba musi zawierać nagłówek Authorization z tokenem bearer
  • IP allowlist — ogranicz ścieżkę MCP do zakresu adresów IP backendu Mii
  • Prywatna sieć / VPC — dla konfiguracji firmowych

Jeśli twoja strona Bitrix jest za Cloudflare lub innym WAF-em, upewnij się, że ścieżka MCP jest dozwolona metodami POST. Najpierw przetestuj endpoint za pomocą curl (zobacz Krok 5), zanim połączysz Mię.

Krok 4 — Połącz serwer Bitrix w Mia Handles

Teraz czas na fajną część. W twojej rozmowie z Mią:

  1. Otwórz Mia miniapp (kliknij zdjęcie profilowe lub użyj menu)
  2. Przejdź do Settings → Tools → MCP Servers → Add (lub edytuj istniejący serwer)
  3. Wypełnij formularz połączenia:
Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (wklej wygenerowany bearer token)

Ważne: Wybierz JSON POST (stateless) jako typ transportu. NIE używaj Streamable HTTP ani SSE — moduł Bitrix MCP obsługuje tylko żądania POST JSON-RPC.

  1. Kliknij Connect. Mia zweryfikuje endpoint, wypisze dostępne narzędzia i doda serwer do twojej rozmowy.

Krok 5 — Przetestuj połączenie

Po połączeniu spróbuj prostego polecenia w rozmowie z Mią:

"List the last 5 news items on my Bitrix site"

Mia powinna zwrócić podsumowanie pobrane bezpośrednio z twojej witryny. Jeśli pojawi się błąd, sprawdź:

  • Ważność tokenu bearer i jego datę wygaśnięcia
  • Czy moduł MCP jest aktywny i czy narzędzia są włączone
  • Czy URL endpointu jest osiągalny z backendu Mii (firewall, certyfikat SSL)
  • Czy typ transportu jest ustawiony na JSON POST (stateless)

Możesz też przetestować ręcznie za pomocą curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://example.com/hiweb-site-mcp/"

Powinieneś dostać z powrotem listę narzędzi w formacie JSON — to znaczy, że serwer działa.

Krok 6 — Co możesz robić po konfiguracji

Po połączeniu Mia staje się twoim współpilotem dla Bitrix. Oto najczęstsze rzeczy, które możesz robić:

  • Operacje na treści — tworzenie, aktualizowanie lub publikowanie artykułów z newsami oraz wpisów iblock
  • Zarządzanie multimediami — lista, przesyłanie lub zastępowanie obrazów w plikach
  • Zarządzanie użytkownikami — tworzenie kont, resetowanie haseł, przypisywanie ról
  • Zamówienia i CRM — wyszukiwanie zamówień, klientów, ofert lub leadów
  • Analityka — pobieranie raportów o ruchu, wskaźników konwersji lub podsumowań sprzedaży
  • Zaplanuje publikacje — kolejkowanie treści na przyszłe daty przez kalendarz Mii

A ponieważ Mia zna już twój kalendarz, zadania i pliki, może koordynować pracę w Bitrix razem z resztą twojego dnia — na przykład:

"Utwórz wpis z newsami o premierze produktu, którą ci wysłałem, zaplanuj go na środę o 14:00 i dodaj zadanie dla zespołu marketingowego, żeby go przejrzał."

Mia zajmie się wszystkim w jednym ruchu.

Rozwiązywanie problemów

Objaw Prawdopodobna przyczyna Napraw
"Connection failed" Endpoint zablokowany lub zły URL Sprawdź reguły firewalla i certyfikat SSL
"No tools available" Moduł wyłączony lub nie wybrano narzędzi Włącz ponownie i wybierz co najmniej jedno narzędzie
"Unauthorized" Nieprawidłowy bearer token Wygeneruj ponownie w ustawieniach MCP i zaktualizuj w Mii
"HTTP 404" Zła ścieżka endpointu Zweryfikuj skonfigurowany endpoint URL modułu
"Transport error" Zły typ transportu Użyj JSON POST (stateless), nie SSE ani Streamable
Powolne odpowiedzi Włączono zbyt wiele narzędzi Wyłącz nieużywane narzędzia, włącz paginację

WordPress i Drupal działają tak samo

Jeśli uruchamiasz też stronę WordPress lub Drupal, obowiązuje ten sam schemat. Każde CMS ma własny adapter MCP, ale workflow połączenia w Mii jest identyczny — zainstaluj moduł, udostępnij endpoint, wklej poświadczenia do Mii. Możesz nawet połączyć wszystkie trzy platformy z tym samym czatem Mii, a ona będzie zwracać się do każdej po imieniu.

Pozostałe poradniki zobacz:

Na koniec

Połączenie Bitrix z Mią przez MCP zamienia twoje CMS z samodzielnego panelu w rozmowny rozszerzenie twojego codziennego workflow. Gdy tylko będzie skonfigurowane, będzie po prostu działać — cicho, w tle, zawsze wtedy, gdy będziesz tego potrzebować.

Jeśli masz pytania lub chcesz pomocy przy konfiguracji, po prostu zapytaj Mię bezpośrednio w czacie. Ona już zna protokół.