MCP poslužitelju daješ prave alate tako da opišeš HTTP krajnje točke koje već imaš — URL, parametre, gdje idu vjerodajnice — i povežeš ih s poslužiteljem. Na SuperCognitu svaki HTTP alat koji izradiš za agenta postaje MCP alat koji se može pozvati u trenutku objave: bez SDK-a, bez koda protokola, bez zasebne implementacije. Ako tvoj CRM i kalendar imaju API-je, a imaju, mogu biti alati.
Znanje odgovara; alati djeluju
Baza znanja čini asistenta dobrim u pitanjima: kakva su pravila povrata, što uključuje premium razina. Alati ga čine korisnim za dio nakon pitanja — pronađi račun ovog kupca, provjeri dostupnost u četvrtak, zabilježi zahtjev. Većina stvarnih tijekova rada treba obje polovice, a većina MCP poslužitelja isporučuje samo prvu, jer je druga dosad zahtijevala pisanje i hostanje poslužitelja.
Neglamurozni uvid HTTP alata jest da druga polovica uglavnom već postoji. Tvoj CRM ima API. Tvoj kalendar ima API. Interna usluga koju je netko izradio 2019. ima API, nedokumentiran, ali funkcionalan. Alat je opisani omotač oko jedne krajnje točke jednog od njih.
Opis je sučelje
Model nikad ne vidi tvoj kod. Vidi naziv alata, njegov opis i parametre i samo na temelju toga odlučuje kada će pozvati alat i s čime. „Pronađi kupca po adresi e-pošte; vraća njegov plan, datum obnove i otvorene prijave” bit će pozvan ispravno. „CRM integracija” bit će pozvana pogrešno, ili stalno, ili oboje. Pisanje opisa alata najbliže je programiranju što ovaj tijek rada ima, a radi se u prozi.
Jedna krajnja točka po alatu
Alat treba raditi jedan posao. Pronađi kontakt po e-pošti. Navedi slobodne termine za zadani tjedan. Izradi nacrt računa. Uski alati pozivaju se ispravno; alat za sve tjera model da nagađa na koje si njegovo raspoloženje mislio.
Opiši ga čitatelju koji ne vidi kod
Reci što alat radi, što znači svaki parametar i što se vraća. Navedi formate i jedinice. Ako je parametar adresa e-pošte, reci to — opis je jedina dokumentacija koju model dobiva.
Poveži, objavi, gotovo
Poveži alat s postavkom i objavi. Sada je izložen kao MCP alat s tipiziranom shemom koju razumije svaki klijent — a može ga pozvati i chat agent iz iste postavke. Vjerodajnice ostaju na strani poslužitelja, u konfiguraciji alata; nikad ne putuju do klijenta.
Testiraj ondje gdje tvoj tim živi
Spoji poslužitelj u Claudeu ili bilo kojem MCP klijentu, pitaj nešto što zahtijeva alat i prati poziv. Nejasan opis otkrije se unutar tri pitanja. Popravi prozu, ne krajnju točku.
Pravila dizajna koja te kasnije spašavaju
- Najmanje ovlasti: ako alat samo čita, stavi iza njega API ključ samo za čitanje. Alat ne može premašiti vjerodajnicu koju nosi.
- Vraćaj ono što treba, a ne cijeli zapis — pretrazi kupca ne treba svako polje koje tvoj CRM pohranjuje.
- Neka pisanja budu mala i promišljena: alat koji rezervira termin u kalendaru sigurniji je od onoga koji može i brisati događaje.
- Radije nekoliko uskih alata nego jedan pametan; model ih bolje kombinira nego što dešifrira zastavice.
Što ne izlagati
Koristan test: bi li tu mogućnost dao novom zaposleniku prvog dana, bez nadzora? Pristup poslužitelju ide kroz OAuth 2.1 s identitetom po korisničkom mjestu, a svaki je radni prostor izoliran, pa je radijus štete ograničen — ali najjeftiniji sigurnosni mehanizam jest da opasnu krajnju točku uopće ne povežeš. Brisanje, skupni izvoz i sve nepovratno može pričekati dok alati samo za čitanje ne dokažu svoju vrijednost.
Počni s dva alata samo za čitanje: pretragom CRM-a i dostupnošću u kalendaru. Taj par pretvara poslužitelj znanja u nešto što u jednoj razmjeni odgovara na „možemo li se naći u četvrtak i je li ovaj kupac na premium planu” — a isporučuje se za jedno poslijepodne.