Dla agentow AI
Serwer MCP Studio Subtelnosci
Ta strona opisuje interfejs, przez ktory asystent AI moze pobrac nasz cennik i zamowic telefon od projektantki. Jesli szukasz oferty dla siebie, przejdz do cennika.
Zasada nadrzedna
Agent nigdy nie dzwoni. Zamawia telefon OD Aleksandry Gacek do osoby, ktora o to poprosila. Na koncu zawsze jest rozmowa czlowieka z czlowiekiem. Nie prowadzimy obslugi glosowej 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 uslugi:
- /mcp/health
- Katalog API:
- /.well-known/api-catalog
Narzedzia
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. 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 prosby o telefon na tydzien dla calej pracowni. Licznik zeruje sie w poniedzialek rano, bo tyle rozmow projektantka jest w stanie oddzwonic bez szkody dla projektow, ktore juz prowadzi.
- Dodatkowo dwa zgloszenia na dobe z jednego zrodla, zeby jeden klient nie zajal calego tygodnia.
- Po wyczerpaniu limitu narzedzie zwraca odmowe wraz z numerem telefonu i godzinami pracy, a nie pusty blad.
Dlaczego bez uwierzytelniania
Endpoint jest celowo otwarty i nie publikujemy metadanych OAuth ani OIDC. Sens tej uslugi polega na zdjeciu tarcia: agent ma zostawic prosbe o telefon w trakcie rozmowy, a nie odsylac czlowieka do zakladania konta. Wymog logowania zniweczylby to, po co ta usluga powstala.
Zapis jest chroniony inaczej: walidacja numeru telefonu, twardy limit tygodniowy pilnowany przez wiazy w bazie, limit na zrodlo oraz odrzucanie tresci ze znacznikami. Najwiekszy mozliwy skutek naduzycia to zajecie trzech miejsc w danym tygodniu, odwracalne po naszej stronie.
Zaufani operatorzy
Duzy operator asystenta obsluguje wielu klientow z jednej puli adresow, wiec limit dwoch zgloszen na dobe ze zrodla dusilby go bez powodu. Dlatego prowadzimy liste zaufanych operatorow, ktorzy ten limit omijaja.
Tygodniowy limit 3 rozmow obowiazuje wszystkich tak samo.Zaufanie nie kupuje wiekszej liczby telefonow, bo ten limit chroni czas projektantki, a nie serwer.
Weryfikacja odbywa sie przez Web Bot Auth: operator podpisuje zadanie kluczem Ed25519 zgodnie z RFC 9421, z parametrem tag="web-bot-auth"i pokrytym komponentem @authority. Klucze publiczne trzymamy przypiete u siebie, a nie pobieramy ich przy kazdym zadaniu: liste i tak zatwierdzamy recznie, wiec pobieranie dodaloby ryzyko, nie zaufanie.
Brak podpisu niczego nie blokuje. Agent bez podpisu dziala normalnie, podlega tylko limitowi zrodla. Nie zamykamy drogi, ktora stoi otworem.
Zgloszenie na liste: napisz nabiuro@studiosubtelnosci.plz nazwa operatora, domena i adresem katalogu kluczy (/.well-known/http-message-signatures-directory). Sprawdzamy tozsamosc, przypinamy klucz i odpisujemy.
Jak podlaczyc
W Claude Code: claude mcp add --transport http studio https://studiosubtelnosci.pl/mcp. W aplikacji Claude: Ustawienia, Konektory, wlasny konektor, ten sam adres.
W ChatGPT wymagane jest dzis reczne dodanie konektora w trybie deweloperskim. Mowiac wprost: przecietny uzytkownik ChatGPT tego nie zrobi i nie zaklada, ze bedzie musial. Publikujemy ten interfejs, bo spodziewamy sie, ze asystenci naucza sie znajdowac takie uslugi samodzielnie, a nie dlatego, ze dzis kazdy moze z niego skorzystac.
Agent w przegladarce (WebMCP)
Strony tego serwisu rejestruja narzedzia przez WebMCP, wiec agent dzialajacy w przegladarce uzytkownika moze pobrac cennik i dane kontaktowe bez odczytywania ukladu strony. Wymaga przegladarki z obsluga tego API, dzis eksperymentalnej.
Zadne z narzedzi przegladarkowych nie sklada zgloszenia.Sa tylko do odczytu albo prowadza czlowieka na strone cennika. Zamowienie telefonu przechodzi wylacznie przez serwer MCP, gdzie obowiazuje limit3 rozmow na tydzien. Agent w przegladarce ma doprowadzic czlowieka do kontaktu, a nie skladac zgloszenie za niego.
Uwaga dla wdrazajacych: powielana w sieci instrukcja mowinavigator.modelContext.provideContext(). W aktualnej specyfikacji nie ma ani tego obiektu, ani tej metody. Jestdocument.modelContext.registerTool().
Kontakt dla ludzi
Jesli czytasz to jako czlowiek i sprawa jest pilna, zadzwon:696 526 850.