Biscotti CMP | Serwer MCP dla asystentów i agentów AI

Dokumentacja serwera MCP

Pierwsze kroki

Przegląd

Serwer Biscotti CMP MCP umożliwia asystentom AI programową interakcję z Twoim kontem Biscotti CMP. Zarządzaj stronami internetowymi, banerami, skanami zgodności, analizami zgód, dokumentami prawnymi i nie tylko — wszystko to za pomocą poleceń w języku naturalnym w Twoim środowisku IDE.

Serwer MCP (Model Context Protocol) pełni rolę pomostu między asystentem AI a interfejsem API Biscotti CMP, udostępniając zestaw narzędzi, z których można korzystać bezpośrednio ze środowiska programistycznego.

Wymagania wstępne

Node.js w wersji 18 lub nowszej
Konto Biscotti CMP w ramach planu Agency lub LTD Agency
Klucz API ze strony „Ustawienia programisty”

Szybki start

Najszybszym sposobem na rozpoczęcie pracy jest skorzystanie z npx — nie wymaga instalacji:

bash

npx @biscotti-cmp/mcp-server

Uruchom za pomocą npx

Uruchom serwer MCP bezpośrednio, bez instalowania go globalnie. Jest to zalecane rozwiązanie dla większości użytkowników:

bash

npx @biscotti-cmp/mcp-server

Sukces

W przypadku korzystania z npxserwer jest pobierany i uruchamiany w locie. Konfiguracja środowiska IDE zajmie się tym automatycznie.

Instalacja globalna

Jeśli wolisz zainstalować serwer MCP globalnie w swoim systemie:

bash

npm install -g @biscotti-cmp/mcp-server

Po instalacji możesz uruchomić serwer bezpośrednio:

bash

biscotti-mcp

Sukces

Instalacja globalna jest przydatna, jeśli chcesz uzyskać szybszy czas uruchamiania lub musisz uruchomić serwer w środowiskach bez dostępu do Internetu.

Konfiguracja IDE

Claude Desktop

Aby korzystać z serwera Biscotti CMP MCP w programie Claude Desktop, dodaj poniższą konfigurację do pliku ustawień programu Claude Desktop.

Lokalizacja pliku konfiguracyjnego

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

Konfiguracja

Dodaj następujące wpisy do pliku konfiguracyjnego:

json

{"mcpServers": {"biscotti-cmp": {"command": "npx","args": ["-y", "@biscotti-cmp/mcp-server"],"env": {"BISCOTTI_API_KEY": "your-api-key-here"}}}}

Sukces

Zastąp your-api-key-here na swój rzeczywisty klucz API z strony Ustawienia programisty.

Po zapisaniu pliku konfiguracyjnego uruchom ponownie program Claude Desktop. Narzędzia Biscotti CMP pojawią się w menu narzędzi.

Kursor

Aby korzystać z serwera Biscotti CMP MCP w połączeniu z Cursor, dodaj poniższą konfigurację do ustawień Cursor MCP.

Lokalizacja pliku konfiguracyjnego

Poziom projektu: .cursor/mcp.json w katalogu głównym projektu
Globalny: ~/.cursor/mcp.json

Konfiguracja

json

{"mcpServers": {"biscotti-cmp": {"command": "npx","args": ["-y", "@biscotti-cmp/mcp-server"],"env": {"BISCOTTI_API_KEY": "your-api-key-here"}}}}

Sukces

Zastąp your-api-key-here na swój rzeczywisty klucz API z strony Ustawienia programisty.

Po zapisaniu program Cursor automatycznie wykryje serwer MCP i udostępni narzędzia w asystencie AI.

Witam

Aby korzystać z serwera Biscotti CMP MCP w połączeniu z Kiro, należy skonfigurować go w ustawieniach MCP.

Lokalizacja pliku konfiguracyjnego

Poziom projektu: .kiro/settings/mcp.json w katalogu głównym projektu
Ogólnie: ~/.kiro/settings/mcp.json

Konfiguracja

json

{"mcpServers": {"biscotti-cmp": {"command": "npx","args": ["-y", "@biscotti-cmp/mcp-server"],"env": {"BISCOTTI_API_KEY": "your-api-key-here"}}}}

Sukces

Zastąp your-api-key-here na swój rzeczywisty klucz API z strony Ustawienia programisty.

Kiro automatycznie wykryje konfigurację serwera MCP i udostępni narzędzia Biscotti CMP.

Inni klienci MCP

Serwer Biscotti CMP MCP jest kompatybilny z każdym klientem zgodnym ze standardem MCP. Należy zastosować następującą konfigurację ogólną:

Konfiguracja ogólna

json

{"mcpServers": {"biscotti-cmp": {"command": "npx","args": ["-y", "@biscotti-cmp/mcp-server"],"env": {"BISCOTTI_API_KEY": "your-api-key-here"}}}}

Jeśli Twój klient MCP korzysta z innego formatu konfiguracji, kluczowe parametry to:

Polecenie: npx
Argumenty: -y @biscotti-cmp/mcp-server
Zmienna środowiskowa: BISCOTTI_API_KEY ustaw na swój klucz API

Sukces

Dokładną lokalizację i format pliku konfiguracyjnego znajdziesz w dokumentacji klienta MCP.

Dostępne narzędzia

Zarządzanie stroną internetową

Narzędzia do zarządzania Twoimi witrynami w Biscotti CMP.

list_websites

Lista wszystkich witryn na Twoim koncie wraz z ich konfiguracją i statusem.

get_website

Pobierz szczegółowe informacje o konkretnej witrynie, w tym ustawienia, domeny i status skanowania.

create_website

Utwórz nową witrynę z domeną, nazwą i opcjami konfiguracji.

update_website

Zaktualizuj ustawienia witryny, takie jak nazwa, domena lub opcje konfiguracji.

get_install_script

Pobierz fragment kodu instalacyjnego JavaScript dla witryny, gotowy do wklejenia do kodu HTML.

Zarządzanie banerami

Narzędzia do tworzenia banerów dotyczących zgody i zarządzania nimi.

list_banners

Wyświetl listę wszystkich banerów zgody dla strony internetowej.

get_banner

Uzyskaj szczegółową konfigurację banera, w tym kolory, teksty i pozycjonowanie.

create_banner

Utwórz nowy baner zgody z konfigurowalnym wyglądem i ustawieniami zachowania.

update_banner

Zaktualizuj wygląd, teksty lub konfigurację zachowania istniejącego banera.

delete_banner

Usuń baner zgody.

get_banner_embed

Pobierz kod do umieszczenia dla konkretnego banera.

Skanowanie pod kątem zgodności

Narzędzia do skanowania witryn i sprawdzania statusu zgodności.

trigger_scan

Uruchom nowe skanowanie zgodności dla witryny, aby wykryć pliki cookie, elementy śledzące i usługi podmiotów trzecich.

list_scans

Lista skanów dla witryny, w tym wykryte pliki cookie i usługi.

generate_compliance_report

Generowanie raportu zgodności dla witryny.

Analiza zgód

Narzędzia dostępu do statystyk zgód i danych analitycznych.

get_consent_stats

Pobierz statystyki zgód, w tym współczynniki opt-in, dystrybucję zgód i trendy w czasie.

export_consent_logs

Eksport szczegółowych logów zgód na potrzeby audytu i raportowania zgodności. Użyj lookup_consent, aby wyszukać pojedynczy rekord zgody na podstawie jego identyfikatora zgody (Consent ID).

Dokumenty prawne

Narzędzia do zarządzania dokumentami prawnymi, takimi jak polityki prywatności, warunki korzystania z usług i strony z informacjami o wydawcy.

list_legal_documents

Wyświetl listę wszystkich dokumentów prawnych dla strony internetowej.

get_legal_document

Pobierz treść i konfigurację konkretnego dokumentu prawnego.

wygeneruj_dokument_prawny

Wygeneruj nowy dokument prawny na podstawie konfiguracji strony internetowej i jurysdykcji.

Usługi

Narzędzia do zarządzania wykrytymi usługami zewnętrznymi i ich kategoriami zgód.

list_services

Lista wszystkich wykrytych usług zewnętrznych dla witryny.

update_service_category

Aktualizacja kategorii zgody usługi lub konfiguracji blokowania.

Webhooki

Narzędzia do zarządzania integracjami webhooków dla powiadomień o zdarzeniach w czasie rzeczywistym.

list_webhooks

Lista wszystkich skonfigurowanych webhooków dla Twojego konta.

create_webhook

Tworzenie nowego punktu końcowego webhook do odbierania zdarzeń dotyczących zgody (consent.granted, consent.revoked).

delete_webhook

Usuń punkt końcowy webhooka.

test_webhook

Wyślij zdarzenie testowe do punktu końcowego webhooka, aby zweryfikować połączenie.

Agencja

Narzędzia do zarządzania kontem agencji i operacji na klientach.

list_agency_clients

Lista wszystkich kont klientów zarządzanych przez Twoją agencję.

get_agency_usage

Pobierz raport zużycia dla wszystkich kont klientów, w tym liczbę sesji i użycie funkcji.

create_agency_client

Utwórz nowe konto klienta w ramach swojej agencji.

Materiały i wskazówki

Zasoby MCP

Serwer Biscotti CMP MCP udostępnia następujące zasoby, z których asystenci AI mogą czerpać informacje kontekstowe:

biscotti://strony internetowe — Lista wszystkich stron internetowych na Twoim koncie
biscotti://website/{id} — Szczegółowa konfiguracja strony internetowej
biscotti://compliance/{id} — Aktualny stan zgodności witryny internetowej
biscotti://banners/{websiteId} — Wszystkie banery dla danej witryny

Zasoby dostarczają informacje tylko do odczytu, które pomagają asystentom AI zrozumieć aktualną konfigurację przed wprowadzeniem zmian.

Szablony komunikatów

Serwer MCP zawiera wbudowane szablony monitów dla typowych procesów:

Audyt zgodności

Przeprowadź pełny audyt zgodności strony internetowej, sprawdzając pliki cookie, konfigurację zgód oraz generując raport.

text

Uruchom audyt zgodności na mojej stronie internetowej example.com i zaproponuj ulepszenia.

Konfiguracja banera

Utwórz i skonfiguruj baner zgody, dostosowując jego wygląd i działanie zgodnie z własnymi preferencjami.

text

Utwórz baner zgody zgodny z GDPR dla mojej strony internetowej z ciemnym motywem i pozycją w lewym dolnym rogu.

Tworzenie dokumentów prawnych

Generuj dokumenty prawne na podstawie konfiguracji Twojej strony internetowej oraz jurysdykcji, której dotyczą.

text

Wygeneruj politykę prywatności dla mojej niemieckiej strony internetowej, która obejmuje Google Analytics i Facebook Pixel.

Uwierzytelnianie

Wymagania dotyczące klucza API

Serwer Biscotti CMP MCP wymaga klucza API do uwierzytelnienia w interfejsie API Biscotti CMP. Wszystkie żądania wysyłane przez serwer MCP są uwierzytelniane przy użyciu Twojego klucza API.

Jak działa uwierzytelnianie

Klucz API można wygenerować na stronie „Ustawienia programisty” w panelu administracyjnym Biscotti CMP.
Klucz API jest ustawiony jako BISCOTTI_API_KEY zmiennej środowiskowej w konfiguracji klienta MCP.
Serwer MCP dołącza ten klucz jako token typu „Bearer” do wszystkich żądań API.
Interfejs API Biscotti CMP weryfikuje klucz i zwraca dane dotyczące Twojego konta.

Ostrzeżenie

Nie ujawniaj swojego klucza API. Nie umieszczaj go w systemie kontroli wersji ani nie udostępniaj publicznie. W razie naruszenia bezpieczeństwa natychmiast zmień klucz na stronie „Ustawienia programisty”.

Uzyskanie klucza API

Aby uzyskać klucz API dla serwera MCP:

Zaloguj się do panelu Biscotti CMP pod adresem app.biscotti-cmp.com.
Przejdź do sekcji „Ustawienia programisty” na pasku bocznym.
Kliknij przycisk „Generuj nowy klucz” w zakładce „Klucze API”.
Nadaj kluczu opisową nazwę (np. „Serwer MCP – środowisko programistyczne”).
Opcjonalnie można ustawić datę wygaśnięcia klucza.
Natychmiast skopiuj wygenerowany klucz — zostanie on wyświetlony tylko raz.

Sukces

Klucze API są dostępne w planach Agency i LTD Agency. Jeśli nie widzisz strony „Ustawienia programisty”, konieczne może być przejście na wyższy plan.

Najlepsze praktyki w zakresie zarządzania kluczami

Należy używać oddzielnych kluczy API dla środowisk programistycznych i produkcyjnych.
Należy ustawić daty wygaśnięcia dla kluczy używanych tymczasowo.
Należy regularnie zmieniać klucze i unieważniać te, które nie są używane.
Skorzystaj z funkcji rotacji kluczy, aby wymieniać klucze bez przestojów.