Негізгі мазмұнға өту
DocumentationAPI ReferenceVideo Tutorials

MCP серверлері

MCP — Model Context Protocol (Үлгі контекст протоколы) — бұл AI көмекшілеріне сыртқы құралдарды табуға және шақыруға мүмкіндік беретін ашық стандарт. Егер сіз MCP үйлесімді серверді (өзіңіздің немесе көптеген қоғамдастық серверлерінің бірін) пайдалансаңыз, оны Hanc.AI-ға қосуға болады, сонда сіздің агенттеріңіз қоңырау басталған сәтте сервердің құралдарын алады.

Қосылғаннан кейін агент бұл құралдарды әңгімелесу барысында шақыра алады — нақты деректерді алу, есептеулер жүргізу, серверлік процестерді іске қосу — дәл кірістірілген Calendar, HubSpot немесе API Tool интеграциялары сияқты.

Барлық тарифтерде қолжетімді

MCP серверлері барлық тарифтерде, оның ішінде Free тарифінде де қолжетімді. Сервер үшін бөлек ақы жоқ — сіз тек агент құралдарды шақырғанда қолданылатын қоңырау минуттары үшін төлейсіз.

MCP-ті қашан пайдалану керек​

СценарийНеліктен MCP қолайлы
Сіз әлдеқашан ішкі құрал серверін пайдаланасызБір қосылым, барлық құралдар әр агентке қолжетімді
Сіз агенттер арасында құралдарды бөлісіп пайдаланғыңыз келедіБір рет қосыңыз, қалаған агенттерге қосыңыз
Сіз қоғамдастық MCP серверлерін пайдаланасызТанымал ашық бастапқы MCP серверлерін теңшелетін кодсыз қосыңыз
Сіздің құрал жиынтығыңыз жиі өзгередіАгент әр қоңырауда құралдарды қайта табады — сервер жағында құралдарды қосуға/жоюға болады, бақылау тақтасын өзгерту керек емес

Егер сізде жалғыз бір реттік endpoint болса, API Tool қарапайымырақ. Егер сізде байланысты құралдар жиынтығы болса немесе сіз MCP серверін қолдап тұрсаңыз, бұл дұрыс интеграция.

MCP серверін қосу​

1. Integrations бетін ашыңыз​

Бақылау тақтасының бүйір тақтасында Integration бөліміне өтіңіз. MCP servers бөліміне айналдырыңыз.

2. "Connect MCP server" батырмасын басыңыз​

Терезе ашылады. Толтырыңыз:

ӨрісСипаттама
LabelБұл қосылымның қысқа атауы (мысалы, "Sales Tools", "Internal CRM"). Белгі агенттің құрал таңдағышында көрсетіледі және AI-ға ұсынылатын құрал атауларының префиксі болады, сондықтан қысқа әрі мағыналы ұстаңыз.
URLСіздің MCP серверіңіздің HTTPS URL мекенжайы. Жалпыға қолжетімді мекенжай болуы керек — http:// және жеке/ішкі мекенжайлар қабылданбайды.
AuthenticationСерверіңіз ашық болса — None, ал Authorization: Bearer … тақырыбын күтсе — Bearer token.
Token(Тек Bearer үшін) Сіздің авторизация токеніңіз. Шифрланған түрде сақталады — оны тек сіздің платформа есептік жазбаңыз пайдалану үшін шифрлай алады.

Save батырмасын басыңыз. Hanc.AI URL пішімін тексереді және қосылымды сақтайды. Қосылым енді сіздің жұмыс кеңістігіңіздегі әр агентке қолжетімді.

Белгілер маңызды

Әр MCP серверінің құрал атаулары қосылым белгісімен префикстеледі, сондықтан "Shop API" ретінде қосылған lookup_order құралы бар MCP сервері агентке Shop_API_lookup_order ретінде көрінеді. Бұл сізде ұқсас аталған құралдары бар бірнеше MCP серверлерін қосқанда қақтығыстарды болдырмайды.

3. Өзгерту, өшіру немесе жою​

MCP серверлерінің тізімінде сіз қосқан әр қосылымның белгісі, URL мекенжайы, авторизация түрі және күйі көрсетіледі. Жолдағы әрекеттерді пайдаланыңыз:

  • Edit — белгіні, URL мекенжайын, авторизация түрін немесе токенді өзгерту
  • Delete — қосылымды толығымен жою

Қосылымды жою оны қосып алған әр агент үшін оны өшіреді — бұл агенттер келесі қоңырауда оның құралдарына қолжетімділікті жоғалтады.

MCP құралдарын агентке қосу​

Сіздің жұмыс кеңістігіңіздегі қосылым агенттеріңізге қолжетімді — бірақ әр агент сіздің қосылымдарыңыздан қайсысын ашатынын жеке шешеді. Бұл сізге әртүрлі MCP серверлерінен тартатын бөлек Sales және Support агенттерін иеленуге мүмкіндік береді.

1. Агенттің Actions қойындысын ашыңыз​

Агентті таңдаңыз. Actions қойындысын ашыңыз. Add Action батырмасын басыңыз.

2. Live-call тобынан "MCP servers" таңдаңыз​

Ашылмалы тізімде үш топ бар: Pre fetch, Live call, Post call. Live-call тобынан іздеңіз — MCP серверлері сонда орналасқан, өйткені агент MCP құралдарын әңгіме барысында шақырады, бұрын немесе кейін емес.

3. Қандай қосылымдарды қосуды ауыстырыңыз​

Терезеде сіздің жұмыс кеңістігіңіздегі әр MCP қосылымы тізімде көрсетіледі, әрқайсысында қосу/өшіру қосқышы бар. Бұл агент пайдалануы керек қосылымдарды қосыңыз. Сондай-ақ "When to use it" өрісінде қысқа нұсқаулық жазуға болады — бұл агент әңгіме барысында осы құралдарға қашан жүгінуді шешу үшін оқиды.

Save батырмасын басыңыз. Енді агентте әр қосылған MCP қосылымының құралдарына қолжетімділік бар.

Араластыру және сәйкестендіру

Сізде бір MCP қосылымы бес агентте қосылып, екіншісі тек бір агентте қосылуы мүмкін — әр агенттің өзінің MCP серверлері құралы және өзінің қосқыштар жиынтығы бар.

Қоңырау уақытында бұл қалай жұмыс істейді​

Қоңырау басталғанда, агент әр қосылған MCP серверіне қосылып, "сіз қандай құралдарды ұсынасыз?" деп сұрайды. Сервер қайтарған нәрсе AI-ға әңгіме барысында шақыра алатын құрал ретінде ашылады.

Білуге тиісті бірнеше нәрсе:

  • Құралдар қоңырау басында табылады. Егер сіз MCP серверіңізге құралдар қоссаңыз немесе жойсаңыз, өзгеріс келесі қоңырауда көрінеді — Hanc.AI-да ештеңе жаңартудың қажеті жоқ.
  • Құрал атаулары префикстеледі қосылым белгісімен (мысалы, "Shop API" + search_products құралы → Shop_API_search_products). Кірістірілген агент құралдары мен басқа MCP құралдары қақтығыспайды.
  • Құрал сипаттамалары мен параметр сұлбалары сіздің MCP серверіңізден келеді. Сонда жақсы сипаттамалар жазыңыз — AI құралды қашан және қалай шақыруды шешу үшін соны пайдаланады.
  • Қателер агентке қайтарылады. Егер құрал шақыруы сәтсіз болса, агент қате хабарламасын көреді және қайталауды, кешірім сұрауды немесе басқа құралды сынауды шеше алады.

Сіздің MCP серверіңізге қойылатын талаптар​

Hanc.AI-мен жұмыс істеу үшін сіздің серверіңізге қажет:

ТалапМәліметтер
HTTPSҚарапайым http:// қабылданбайды. Нақты TLS сертификатын пайдаланыңыз.
Жалпы URLURL жалпы мекенжайға шешілуі керек — Hanc.AI жеке желідегі немесе localhost-тегі серверлерге жете алмайды.
MCP Streamable HTTP transportБір endpoint арқылы ағымдағы MCP HTTP transport. SSE-only және stdio транспорттары бұл интеграцияда қолдау таппайды.
Bearer авторизация (міндетті емес)Егер сіздің серверіңіз авторизацияны талап етсе, ол стандартты Authorization: Bearer <token> тақырыбын қабылдауы керек.

Егер сіз өзіңіздің серверіңізді брандмауэрдің артында хосттасаңыз, оны жалпы HTTPS endpoint-і бар туннель немесе кері прокси арқылы ашыңыз.

Қауіпсіздік және құпиялылық​

Сіздің bearer токендеріңіз демалуда шифрланған күйде сақталады. Тек Hanc.AI-дың қоңырау инфрақұрылымы оларды шифрсыздандыра алады және тек қоңырау басталып, агент сіздің серверіңізге қосылу қажет болған кезде ғана.

Құрал шақырулары агент → Hanc.AI → сіздің MCP серверіңіз → кері ағады. Біз құрал шақыру жүктемелерін журналдамаймыз. Сіздің серверіңіз өз жағынан тіркеуді өзіңіз таңдағанша ғана журналдайды.

Егер сіз токеніңізді өзгертсеңіз немесе айналдырсаңыз, бақылау тақтасында қосылымды өңдеңіз — жаңа мән келесі қоңырауда күшіне енеді.

Тариф бойынша қолжетімділік​

ТарифMCP серверлері
FreeҚолжетімді
Starter / Pro / Business / EnterpriseҚолжетімді

Әр қосылым үшін ақы алынбайды — сіз тек агент құралдарды шақыратын қоңырау минуттары үшін төлейсіз.

Ақаулықтарды жою​

"Қосылым сақталмайды"​

  • URL http:// емес, https:// арқылы басталатынына көз жеткізіңіз.
  • Хост жалпыға қолжетімді екенін тексеріңіз — localhost, 127.0.0.1 және ішкі мекенжайлар әдейі бұғатталған.
  • Орнатқан болсаңыз bearer токенін қайта тексеріңіз — артық бос орындар немесе тырнақшалар сақтауды бұзады.

"Агент құралдарды көрмейді"​

  • Агенттің Actions қойындысындағы MCP сервер жазбасында кемінде бір қосылым қосулы және жазба сақталғанын тексеріңіз.
  • Сіздің MCP серверіңіз tools/list сұрауына жауап беріп жатқанын және интерактивті авторизация ағынын талап етпейтінін тексеріңіз.
  • Қоңыраудың басында MCP қосылымынан хабарламаларды агенттің қоңырау журналынан іздеңіз.

"Құрал қоңырау ортасында сәтсіз болады"​

  • Агент сіздің серверіңіз қайтаратын кез келген қатені көреді. Серверіңіздің журналдарын тексеріңіз.
  • Ұзақ жұмыс істейтін құралдардың уақыты бітуі мүмкін — қонақ үнсіздікте отырмауы үшін MCP құралының орындалуын қоңырауға бірнеше секундтан төмен ұстаңыз.

"Серверімде құралдарды өзгерттім, бірақ агент әлі ескілерін пайдаланады"​

  • Құралдар әр қоңыраудың басында қайта табылады, қоңыраулар арасында кэштелмейді. Келесі жаңа қоңырау жаңартылған құралдар жиынтығын көреді. Жалғасып жатқан қоңыраулар басында берілген құралдарды сақтайды.

Қатысты​