ciunkos.com/Konektor MCP z OpenAPI

Darmowe narzędzie

Twoje API jako konektor do Claude i ChatGPT

Twój zespół już płaci za Claude albo ChatGPT. Następne pytanie: jak pozwolić mu pracować z Waszym systemem, z zamówieniami, klientami, fakturami, ERP-em. Wklej specyfikację OpenAPI i dostań propozycję wąskich narzędzi MCP, z oznaczonymi nieodwracalnymi, oraz szkielet serwera na start.

Jak powstają narzędzia

Każda operacja to jedno narzędzie z nazwą dozwoloną przez specyfikację MCP (litery, cyfry, podkreślenie, łącznik i kropka). Operacje GET są oznaczone jako tylko do odczytu. DELETE i operacje dotyczące płatności, zwrotów, anulowania albo przelewów są oznaczone jako nieodwracalne i domyślnie odznaczone. Schemat wejścia powstaje z parametrów ścieżki i zapytania oraz z ciała JSON.

Czym jest szkielet

Punktem startowym dla oficjalnego SDK w TypeScript: jedno wywołanie registerTool na wybrane narzędzie, schemat wejścia w zod i fetch do Twojego API z tokenem ze zmiennej środowiskowej. Zanim zaczną z niego korzystać ludzie, potrzebuje logowania per użytkownik, limitów, logów i testów. Tę część buduję ja.

Czego nie robi

Nie woła Twojego API, nie zapisuje specyfikacji i nie ocenia API. Wszystko dzieje się w tej karcie.

Pytania

Co to jest konektor MCP?

Serwer MCP, który udostępnia narzędzia asystentom AI, takim jak Claude i ChatGPT. Zespół dodaje go raz, a asystent może potem sprawdzić zamówienie albo przygotować szkic faktury w Waszym systemie, pytając przed każdą nieodwracalną zmianą.

Czemu nie wystawić każdego endpointu?

Asystenci lepiej wybierają z krótkiej listy dobrze opisanych narzędzi. Zacznij od kilku pytań, które zespół zadaje codziennie, potem dokładaj.

Czy moja specyfikacja wychodzi z przeglądarki?

Nie. Parsowanie i generowanie kodu działają na tej stronie. Analityka zapisuje tylko, ile operacji każdego rodzaju miała specyfikacja.

Czy zbudujesz to i uruchomisz dla nas?

Tak: konektor na Waszym istniejącym logowaniu, wdrożony dla zespołu, z użyciem mierzonym per osoba. Konfigurator pokaże cenę i termin.

Źródła

  1. Model Context Protocol specification 2025-11-25, Tools (tool definition, names, human in the loop)
  2. Model Context Protocol TypeScript SDK (v2: @modelcontextprotocol/server, registerTool, zod)
  3. js-yaml 4.1.0, MIT license (YAML parsing in the browser)

Chcesz swój system w Claude i ChatGPT?

Buduję konektor na Waszym istniejącym logowaniu, z wąskimi narzędziami, które pytają przed każdą nieodwracalną zmianą, wdrażam go dla zespołu i mierzę, kto z niego korzysta. Potem nowe narzędzia, w miarę jak rosną procesy.

Przemysław Zalewski

Jak pracuję

Przemysław Zalewski · 15+ lat wydawania oprogramowania

„a true bias for action” CTO klienta, publiczna rekomendacja na LinkedInie

Wszystkie zasady i poziomy ryzyka →