Przejdź do treści
DOTWICK

Serwer MCP

Czym jest

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentowi AI wywoływać narzędzia w innej usłudze. Dotwick prowadzi serwer MCP, aby asystent mógł wyświetlać Twoje kody, tworzyć je i zmieniać, tagować oraz czytać liczby Twoich skanów.

Serwer to cienka warstwa nad tym API. Każde z jego 11 narzędzi wywołuje jedną trasę API z zakresem tej trasy, pod tymi samymi limitami zapytań, więc asystent może zrobić to, co jego klucz zrobiłby ręcznie, i nic więcej. Nic nie usuwa: usuwanie kodów, folderów i tagów zostaje w aplikacji i w REST API, więc żaden prompt nie zepsuje wydrukowanego kodu.

Zanim zaczniesz

MCP jest w cenie dostępu do API (Pro, Business i Enterprise). W aplikacji otwórz Settings → API i utwórz klucz z zakresami potrzebnymi asystentowi: zakresy odczytu wystarczą do pytań o skany, a codes:write, folders:write lub tags:write pozwalają mu zmieniać rzeczy.

Asystent widzi tylko narzędzia, na które pozwala jego klucz, więc klucz tylko do odczytu nigdy nie wyświetli create_code. Każde wywołanie narzędzia liczy się jako jedno żądanie API względem limitu zapytań i miesięcznej sumy klucza; wyświetlenie listy narzędzi nie.

Połącz go

Serwer mówi Streamable HTTP pod adresem https://api.dotwick.com/mcp. Wyślij klucz jako token bearer w nagłówku Authorization.

przykładDodaj serwer
claude mcp add --transport http dotwick https://api.dotwick.com/mcp \  --header "Authorization: Bearer $DOTWICK_API_KEY"

Claude, ChatGPT i inni klienci

Claude Code dodaje serwer powyższym poleceniem. Klienci czytający plik konfiguracji MCP, jak Cursor i VS Code, biorą blok JSON: trzymaj klucz w zmiennej środowiskowej i odwołuj się do niej, nigdy nie wpisuj go do pliku.

ChatGPT i inne aplikacje, które dodają zdalny serwer MCP przez jego URL: wpisz URL serwera i wyślij klucz jako token bearer tam, gdzie aplikacja prosi o klucz API lub nagłówek. Aplikacja, która potrafi logować się tylko przez OAuth, nie może jeszcze się połączyć. OAuth jest w planach; dziś do serwera dociera się kluczami API.

Narzędzia

Każde narzędzie odpowiada jednej trasie API i wymaga zakresu tej trasy. Narzędzia listujące zwracają do 50 elementów i kursor do następnej strony.

list_codes
Lista kodów QR obszaru roboczego, od najnowszych. Filtruj według folderu, tagów, typu, statusu lub wyszukaj w nazwie i krótkim linku.codes:read · GET /v1/codes
get_code
Jeden kod QR z adresem docelowym, regułami, tagami i łączną liczbą skanów.codes:read · GET /v1/codes/{id}
create_code
Utwórz kod QR otwierający stronę internetową. Domyślnie dynamiczny (adres można zmienić po wydrukowaniu). Opcjonalnie folder, tagi i parametry UTM.codes:write · POST /v1/codes
update_code
Zmień nazwę, docelowy adres URL, folder, tagi lub datę wygaśnięcia kodu albo wstrzymaj go i wznów.codes:write · PATCH /v1/codes/{id}
list_folders
Foldery obszaru roboczego.folders:read · GET /v1/folders
create_folder
Utwórz folder, także wewnątrz innego.folders:write · POST /v1/folders
list_tags
Tagi obszaru roboczego i liczba kodów z każdym tagiem.tags:read · GET /v1/tags
create_tag
Utwórz tag z nazwą i kolorem.tags:write · POST /v1/tags
tag_codes
Dodaj lub usuń tagi w maksymalnie 500 kodach naraz.codes:write · POST /v1/codes/tags
analytics_summary
Łączna i unikalna liczba skanów w okresie: obszar roboczy, jeden kod, folder lub tag.analytics:read · GET /v1/analytics/summary
analytics_breakdown
Najczęstsze kraje, miasta, urządzenia, przeglądarki, kody lub warianty A/B w okresie.analytics:read · GET /v1/analytics/breakdown

Limity i bezpieczeństwo

  • Klucz zachowuje swoje ograniczenie folderów, zakresy IP i limity zapytań: przez MCP widzi tylko to, co widzi przez REST API.
  • Przez MCP nic nie można usunąć.
  • Asystent może się mylić. Poproś go, by przed zapisem powiedział, co zamierza zmienić, i sprawdź wynik w aplikacji.