Dla agentów AI
Serwer MCP Studio Subtelności
Ta strona opisuje interfejs, przez który asystent AI może pobrać nasz cennik i zamówić telefon od projektantki. Jeśli szukasz oferty dla siebie, przejdź do cennika.
Zasada nadrzędna
Agent nigdy nie dzwoni. Zamawia telefon OD Aleksandry Gacek do osoby, która o to poprosiła. Na końcu zawsze jest rozmowa człowieka z człowiekiem. Nie prowadzimy obsługi głosowej przez AI i nie planujemy jej.
Endpoint
- Adres:
POST https://studiosubtelnosci.pl/mcp- Transport:
- Streamable HTTP, JSON-RPC 2.0
- Karta serwera:
- /.well-known/mcp/server-card.json
- Stan usługi:
- /mcp/health
- Katalog API:
- /.well-known/api-catalog
Narzędzia
zakres_i_cennik
Zwraca zakres uslug pracowni Studio Subtelnosci oraz pelne widelki cenowe na 2026 rok: projekt koncepcyjny od 200 zł/m² (min. 3 000 zł), kompletny od 350 zł/m² (min. 3 500 zł), premium 800-1 200 zł/m², online od 250 zł/m² (min. 2 500 zł), konsultacja 350 zł. Wycena pojedynczych pomieszczen: kuchnia od 4 000 zł, lazienka od 3 500 zł, pozostale od 3 000 zł. Bez parametrow, dane pochodza z tego samego zrodla co strona /cennik.
zamow_telefon
Zamawia telefon OD Aleksandry Gacek do wskazanej osoby. Nie inicjuje polaczenia, tylko przekazuje prosbe o kontakt, a projektantka oddzwania w ciagu 24 godzin roboczych. Wywoluj wylacznie wtedy, gdy czlowiek wprost poprosil o telefon i podal swoj numer. Limit: 3 prosby na tydzien dla calej pracowni. Po wyczerpaniu limitu narzedzie zwraca odmowe wraz z numerem telefonu i godzinami pracy.
Parametry zamow_telefon
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
| imie | string | tak | Imie osoby, do ktorej ma zadzwonic projektantka. |
| telefon | string | tak | Numer telefonu w Polsce, np. 696 526 850 lub +48696526850. |
| zakres | string | tak | Czego dotyczy rozmowa: rodzaj wnetrza i zakres prac, np. projekt mieszkania pod klucz, sama kuchnia, konsultacja online. |
| metraz | string | nie | Metraz w metrach kwadratowych, sama liczba, np. 55. Zakres 1-2000. |
| budzet | string | nie | Budzet podany przez klienta. |
| preferowany_czas | string | nie | Preferowana pora rozmowy w slowach klienta, np. jutro przed poludniem. |
Limity
- 3 prośby o telefon na tydzień dla całej pracowni. Licznik zeruje się w poniedziałek rano, bo do tylu osób projektantka jest w stanie oddzwonić bez szkody dla projektów, które już prowadzi.
- Dodatkowo dwa zgłoszenia na dobę z jednego źródła, żeby jeden klient nie zajął całego tygodnia.
- Po wyczerpaniu limitu narzędzie zwraca odmowę wraz z numerem telefonu i godzinami pracy, a nie pusty błąd.
Dlaczego bez uwierzytelniania
Endpoint jest celowo otwarty i nie publikujemy metadanych OAuth ani OIDC. Sens tej usługi polega na zdjęciu tarcia: agent ma zostawić prośbę o telefon w trakcie rozmowy, a nie odsyłać człowieka do zakładania konta. Wymóg logowania zniweczyłby to, po co ta usługa powstała.
Zapis jest chroniony inaczej: walidacja numeru telefonu, twardy limit tygodniowy pilnowany przez więzy w bazie, limit na źródło oraz odrzucanie treści ze znacznikami. Największy możliwy skutek nadużycia to zajęcie trzech miejsc w danym tygodniu, odwracalne po naszej stronie.
Zaufani operatorzy
Duży operator asystenta obsługuje wielu klientów z jednej puli adresów, więc limit dwóch zgłoszeń na dobę ze źródła dusiłby go bez powodu. Dlatego prowadzimy listę zaufanych operatorów, którzy ten limit omijają.
Tygodniowy limit 3 rozmów obowiązuje wszystkich tak samo. Zaufanie nie kupuje większej liczby telefonów, bo ten limit chroni czas projektantki, a nie serwer.
Weryfikacja odbywa się przez Web Bot Auth: operator podpisuje żądanie kluczem Ed25519 zgodnie z RFC 9421, z parametrem tag="web-bot-auth" i pokrytym komponentem @authority. Klucze publiczne trzymamy przypięte u siebie, a nie pobieramy ich przy każdym żądaniu: listę i tak zatwierdzamy ręcznie, więc pobieranie dodałoby ryzyko, nie zaufanie.
Brak podpisu niczego nie blokuje. Agent bez podpisu działa normalnie, podlega tylko limitowi źródła. Nie zamykamy drogi, która stoi otworem.
Zgłoszenie na listę: napisz na biuro@studiosubtelnosci.pl z nazwą operatora, domeną i adresem katalogu kluczy (/.well-known/http-message-signatures-directory). Sprawdzamy tożsamość, przypinamy klucz i odpisujemy.
Jak podłączyć
W Claude Code: claude mcp add --transport http studio https://studiosubtelnosci.pl/mcp. W aplikacji Claude: Ustawienia, Konektory, własny konektor, ten sam adres.
W ChatGPT wymagane jest dziś ręczne dodanie konektora w trybie deweloperskim. Mówiąc wprost: przeciętny użytkownik ChatGPT tego nie zrobi i nie zakłada, że będzie musiał. Publikujemy ten interfejs, bo spodziewamy się, że asystenci nauczą się znajdować takie usługi samodzielnie, a nie dlatego, że dziś każdy może z niego skorzystać.
Agent w przeglądarce (WebMCP)
Strony tego serwisu rejestrują narzędzia przez WebMCP, więc agent działający w przeglądarce użytkownika może pobrać cennik i dane kontaktowe bez odczytywania układu strony. Wymaga przeglądarki z obsługą tego API, dziś eksperymentalnej.
Żadne z narzędzi przeglądarkowych nie składa zgłoszenia. Są tylko do odczytu albo prowadzą człowieka na stronę cennika. Zamówienie telefonu przechodzi wyłącznie przez serwer MCP, gdzie obowiązuje limit 3 rozmów na tydzień. Agent w przeglądarce ma doprowadzić człowieka do kontaktu, a nie składać zgłoszenie za niego.
Uwaga dla wdrażających: powielana w sieci instrukcja mówi navigator.modelContext.provideContext(). W aktualnej specyfikacji nie ma ani tego obiektu, ani tej metody. Jest document.modelContext.registerTool().
Kontakt dla ludzi
Jeśli czytasz to jako człowiek i sprawa jest pilna, zadzwoń: 696 526 850.