Prawdziwe narzędzia dajesz serwerowi MCP, opisując punkty końcowe HTTP, które już masz — URL, parametry, miejsce na dane uwierzytelniające — i podłączając je do serwera. W SuperCognit każde narzędzie HTTP zbudowane dla agenta staje się wywoływalnym narzędziem MCP w chwili publikacji: bez SDK, bez kodu protokołu, bez osobnego wdrożenia. Jeśli twój CRM i kalendarz mają API — a mają — mogą być narzędziami.
Wiedza odpowiada, narzędzia działają
Baza wiedzy sprawia, że asystent dobrze radzi sobie z pytaniami: jakie są zasady zwrotów, co obejmuje plan premium. Narzędzia czynią go użytecznym w tym, co następuje po pytaniu — sprawdź konto tego klienta, zobacz dostępność w czwartek, zapisz zgłoszenie. Większość rzeczywistych procesów potrzebuje obu połówek, a większość serwerów MCP ma tylko pierwszą, bo druga historycznie wymagała napisania i hostowania serwera.
Mało efektowna prawda o narzędziach HTTP jest taka, że druga połowa w większości już istnieje. Twój CRM ma API. Twój kalendarz ma API. Wewnętrzna usługa, którą ktoś zbudował w 2019 roku, ma API, nieudokumentowane, ale działające. Narzędzie to opisana nakładka na jeden punkt końcowy jednego z nich.
Opis jest interfejsem
Model nigdy nie widzi twojego kodu. Widzi nazwę narzędzia, jego opis i parametry, i tylko na ich podstawie decyduje, kiedy wywołać narzędzie i z czym. „Wyszukaj klienta po adresie e-mail; zwraca jego plan, datę odnowienia i otwarte zgłoszenia” zostanie wywołane poprawnie. „Integracja CRM” zostanie wywołana błędnie albo bez przerwy, albo jedno i drugie. Pisanie opisów narzędzi to w tym procesie najbliższy odpowiednik programowania — i robi się je prozą.
Jeden punkt końcowy na narzędzie
Narzędzie powinno wykonywać jedno zadanie. Wyszukaj kontakt po e-mailu. Pokaż wolne terminy w danym tygodniu. Utwórz szkic faktury. Wąskie narzędzia są wywoływane poprawnie; narzędzie od wszystkiego zmusza model do zgadywania, o który z jego trybów ci chodziło.
Opisz je dla czytelnika, który nie widzi kodu
Napisz, co narzędzie robi, co oznacza każdy parametr i co wraca. Podaj formaty i jednostki. Jeśli parametr to adres e-mail, powiedz to — opis jest jedyną dokumentacją, jaką dostaje model.
Podłącz, opublikuj, gotowe
Podłącz narzędzie do konfiguracji i opublikuj. Jest teraz udostępnione jako narzędzie MCP z typowanym schematem, który rozumie każdy klient — a agent czatu z tej samej konfiguracji też może je wywołać. Dane uwierzytelniające zostają po stronie serwera, w konfiguracji narzędzia; nigdy nie trafiają do klienta.
Testuj tam, gdzie pracuje twój zespół
Podłącz serwer w Claude lub dowolnym kliencie MCP, zadaj pytanie wymagające narzędzia i obserwuj wywołanie. Niejasny opis zdradzi się w ciągu trzech pytań. Poprawiaj prozę, nie punkt końcowy.
Zasady projektowe, które oszczędzą ci kłopotów
- Minimalne uprawnienia: jeśli narzędzie tylko czyta, daj mu klucz API tylko do odczytu. Narzędzie nie może przekroczyć uprawnień danych, które ma.
- Zwracaj to, co potrzebne, a nie cały rekord — wyszukiwanie klienta nie musi przesyłać każdego pola, które przechowuje twój CRM.
- Zapisy niech będą małe i przemyślane: narzędzie, które tworzy wstępną rezerwację w kalendarzu, jest bezpieczniejsze niż takie, które może też usuwać wydarzenia.
- Wybieraj kilka wąskich narzędzi zamiast jednego sprytnego; model lepiej je łączy, niż rozszyfrowuje flagi.
Czego nie udostępniać
Przydatny test: czy dałbyś tę możliwość nowemu pracownikowi pierwszego dnia, bez nadzoru? Dostęp do serwera działa przez OAuth 2.1 z tożsamością na stanowisko, a każda przestrzeń robocza jest odizolowana, więc zasięg ewentualnych szkód jest ograniczony — ale najtańszym zabezpieczeniem jest niepodłączanie niebezpiecznego punktu końcowego w ogóle. Usuwanie, masowy eksport i wszystko, czego nie da się cofnąć, może poczekać, aż narzędzia tylko do odczytu udowodnią swoją wartość.
Zacznij od dwóch narzędzi tylko do odczytu: wyszukiwania w CRM i dostępności w kalendarzu. Ta para zamienia serwer wiedzy w coś, co odpowiada na pytanie „czy możemy się spotkać w czwartek i czy ten klient ma plan premium” w jednej wymianie — i da się to wdrożyć w jedno popołudnie.