DOC-V-дегі MCP сервисі: қызметкердің ЖИ-агенті құжат айналымымен жұмыс істейді

ЖИ-агенттер — Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI — талдаушылардың, заңгерлердің, инженерлер мен басшылардың компьютерлерінде қазірдің өзінде тұр. Олар файлдарды оқиды, код жазады, кестелерді жинақтайды. Бірақ ұйымның құжат айналымы оларға көрінбейді: агенттен келісудегі шарттар туралы сұрау үшін журналды Excel-ге түсіріп, деректерді чатқа көшіруге тура келеді.

DOC-V 8.5.18 нұсқасынан бастап платформада MCP сервисі бар — кіріктірілген Model Context Protocol сервері. Ол арқылы қызметкердің агенті DOC-V-ге өзі жүгінеді: журналдарды ашады, құжаттарды іріктеп оқиды, файлдар бойынша іздейді, қорытындыларды есептейді, ал әкімші рұқсат етсе — өрістерді толтырып, құжаттар құрады. Барлығы — осы қызметкердің құқықтарымен және DOC-V журналдарына жазылады.

🔌 MCP деген не — қарапайым тілмен

Model Context Protocol (MCP) — ЖИ-агенттер сыртқы жүйелерге қосылатын ашық стандарт. Жүйе өз құралдарын сипаттайды: «құжаттарды табу», «файлды оқу», «қорытындыны есептеу». Адамның сұрағына жауап беру үшін қай құралды шақыруды агент өзі шешеді. Бұрын әр «агент — жүйе» жұбы үшін жеке коннектор жазылатын. Енді жүйе MCP-ны қолдаса, ал агент MCP клиенті болса жеткілікті: ол оған кез келген басқа MCP серверіне қосылғандай қосылады.

Ұйым үшін бұл қарапайым нәрсені білдіреді: қызметкер үйреншікті агентінде жұмысын жалғастырады, ал DOC-V агентке қолжетімді дереккөздердің біріне айналады — жергілікті файлдармен, поштамен, таск-трекермен немесе репозиториймен қатар, егер оларда да MCP сервері болса.

🧩 MCP сервисі, ЖИ-көмекші және REST API: қайсысы не үшін

DOC-V-де пайдаланушыларға арналған ЖИ-көмекші, баптауға арналған ЖИ-әкімші және интеграцияларға арналған REST API бар. MCP сервисі оларды алмастырмайды, басқа міндетті шешеді:

Егер міндет қайталанып, әрдайым бірдей нәтиже беруі тиіс болса — бұл REST API немесе маршруттағы әрекет. Егер сұрақ әр жолы жаңа болса, ал жауапты бірнеше жерден жинау керек болса — бұл агенттің жұмысы.

💼 Ұйым MCP сервисін қалай қолдана алады

Төменде — сервис қазірдің өзінде қолдайтын сценарийлер. Журналдар, өрістер мен сандар шартты: әр ұйымда олар өзгеше, ал агент оларды журналдар құрылымынан және әкімшінің түсіндірмесінен өзі біледі.

1. Басшы: «бізде не тұрып қалды»

«Қай шарттар бес күннен астам келісуде тұр? Орындаушылар бойынша топтастырып, жалпы сомасын есепте»

Агент шарттар журналын ашады, құжаттарды бағандар бойынша — интерфейстегі сүзгі сияқты — іріктейді, орындаушыларды қарап, «Сома» бағаны бойынша қорытындыны есептейді. Жауап — чаттағы кесте, оны бірден хатқа немесе есепке қоюға болады. Мұндай кілтті тек оқуға беру жеткілікті.

2. Заңгер: шарттар мәтіні бойынша іздеу

«Биылғы жеткізу шарттарынан күніне 0,1%-дан жоғары тұрақсыздық айыбы туралы талаптарды тауып, кестеге жина: контрагент, тармақ, мөлшерлеме»

Агент бір жылдағы жеткізу шарттарын іріктейді, олардың тіркемелерінің мәтінін оқиды, әр шарттың файлдары бойынша іздейді және табылған тармақтарды жазып алады. Векторлау қосулы болса, мағына бойынша іздеу де қолжетімді — мәтінде «өсімпұл» деп жазылса, ал сұрақ «тұрақсыздық айыбы» туралы болса. Нәтижені тексерген жөн: агент оқуға кететін сағаттарды үнемдейді, бірақ қорытынды заңгерде қалады.

3. Кеңсе: кіріс хаттарды алғашқы өңдеу

Әкімші «Кіріс хат» түрі үшін «Өңдеу» операциясын баптайды: «Қысқаша мазмұны» (Мәтін) және «Тақырыбы» (Тізім) өрістері, тек «Тіркеу» нүктесінде. Агент жаңа хаттардың тіркемелерін оқиды, осы екі өрісті толтырады — болды: құжатты әрі қарай адам жүргізеді. Агент хатты басқа нүктеде түзете алмайды және басқа өрістерге тиісе алмайды, ал құжаттың жұмыс барысында «MCP операциясымен өзгерту» жазбасы қалады.

4. Сатып алулар: жіберілген кестеден өтінімдер

«Міне, цехтың қарашаға қажеттілік кестесі. Әр жол бойынша өтінім құр, позицияларды номенклатура анықтамалығымен сәйкестендір»

Кестені агент қызметкердің компьютерінде оқиды, позицияларды анықтамалыққа сілтеме өрісінің мән нұсқалары арқылы табады, ал өтінімдерді «Номенклатура», «Саны», «Мерзімі» параметрлерімен «Құру» операциясы арқылы құрады. Құжат пішін арқылы құрылғандай құрылады: егер оны өткізу мүмкін болмаса, ол жойылады. Құрмас бұрын агент мұндай өтінімдердің бар-жоғын тексеріп, қызметкерге растауға тізім көрсете алады.

5. Еңбекті қорғау: наряд-рұқсаттар бойынша таңғы жиынтық

Наряд-рұқсаттар бойынша агент бірнеше журналдан жиынтық жинайды: ашық нарядтар, мерзімі аяқталып жатқан нарядтар, қолтаңбалары жетіспейтін рұқсаттар — учаскелер бойынша санымен. Тек оқу, бірақ бес журналды аралаудың орнына — бір жауап.

6. Жүйелер арасындағы салыстыру

Агент бір диалогта бірнеше дереккөзбен жұмыс істейді. Қызметкер оған есеп жүйесінен төлемдер көшірмесін береді, ал агент оны DOC-V-дегі шоттармен салыстырады: «Төлем» нүктесіндегі қай шоттар төленіп қойған, қай төлемдер өз шотын таппаған. Егер басқа жүйеде — таск-трекерде, поштада, білім қоймасында — өз MCP сервері болса, агент оған да қосылады, ал жүйелер арасындағы байланыс бөлек интеграциясыз, тікелей әңгіме барысында құрылады.

7. Кесте бойынша тұрақты есеп

Командалық жолы бар агенттер адамсыз жұмыс істей алады: оларды кесте бойынша — Cron немесе Windows тапсырмалар жоспарлаушысымен — іске қосады. Әр дүйсенбі сайын агент мерзімі өткен тапсырмалар бойынша жиынтық жинап, DOC-V-де «Апталық есеп» құжатын «Құру» операциясымен «Нүктені орындау» арқылы құрады — және есеп маршрут бойынша басшыға жіберіледі. Мұндай агентке — бөлек кілт, бөлек есептік жазба және тек бір жазу операциясы.

8. АТ: интеграциялар және деректерді тексеру

REST API арқылы интеграция жазатын бағдарламашы код редакторындағы агентті DOC-V-нің сынақ серверіне қосады. Агент журналдар құрылымын, құжаттардың өрістері мен пішіндерін өзі қарайды, сұраудың не қайтарғанын нақты деректерде тексереді және құжаттың неге іріктеуге түспегенін табады. Кілт сынақ серверіне, тек оқу.

🛡️ Қауіпсіздік: агент — тағы бір қызметкер

Сервистің басты қағидаты: агент адамнан артық құқық алмайды. Әр сұрау кілт пайдаланушысының — кілт байланған қызметкердің немесе сервистің ортақ пайдаланушысының атынан орындалады.

• Көрінуі пайдаланушыдағыдай. Тек оған қолжетімді журналдар, құжаттар, өрістер мен файлдар; құжаттан — қарау пішінінің өрістері, журналдан — бағандар. Бұғатталған, жойылған пайдаланушы немесе қонақ бас тарту алады.
• Құпиялар шықпайды. «Құпиясөз» өрістері ***** маскасымен келеді. Шифрланған файлдардың мазмұны агентке әдепкі бойынша берілмейді — бұл бөлек ауыстырғыш.
• Құралдар өшіріледі. Кез келген оқу құралын жалаушаны алып тастау арқылы өшіруге болады: мысалы, агентке журналдар мен құжаттарды қалдырып, файлдарды бермеу.
• Жазу — бәрі немесе ештеңе. Операция пайдаланушының құқықтарымен орындалады: егер оның кем дегенде бір өрісі түзетуге жабық болса, ештеңе жазылмайды. Құжат көрінетін, жойылмаған және мұрағатта емес болуы тиіс.
• Кілт — құпиясөз сияқты. Кілт — кілт құжатындағы «Құпиясөз» өрісінің мәні, ұзындығы 32 таңбадан кем емес. Ол тек Authorization: Bearer тақырыбында беріледі, мекенжайда емес. Кілтті кері қайтарып алу — оның құжатын жою, соның ішінде «Бақылау» әрекетімен.
• Желі және жүктеме. HTTPS болмаса, сервис сұрауларды тек сервердің жергілікті мекенжайынан және сенімді проксиден қабылдайды. Рұқсат етілген IP-мекенжайлар тізімін, минутына шақырулар мен бір мезгілдегі шақырулар шегін, сондай-ақ жауаптың шекті көлемін беруге болады. Қате кілтпен жиі сұрау келетін мекенжай бұғатталады.
• Бәрі көрінеді. Қосылулар, бас тартулар мен операциялар — «Белсенділікте», дұрыс кілтпен қабылданбаған сұраулар — әкімшінің бастапқы бетіндегі «Оқиғаларда», аргументтері бар әр шақыру — ЖИ-көмекшіге жүгіну журналында.

Деректер қайда кетеді

Бұл туралы ашық айту маңызды. DOC-V деректерді қызметкер компьютеріндегі MCP клиентіне береді, ал клиент оларды өз тілдік моделіне жібереді. Егер модель бұлттық болса, агент оқығанның бәрі оның жеткізушісіне соның шарттарымен түседі. Сондықтан:

• кілттерді тар құқықтары бар есептік жазбалардан беріңіз — тек қажетті журналдарға;
• қажет емес құралдарды өшіріңіз — ең алдымен файлдарды, егер міндет өрістер бойынша шешілсе;
• құпия деректер үшін өз желіңіздің ішіндегі жергілікті модельмен жұмыс істейтін клиентті пайдаланыңыз — сонда құжаттар ұйымнан шықпайды.

Тағы бір нәрсе: агент бөгде мәтіндерді — хаттарды, шарттарды, тіркемелерді — оқиды, ал оларда агентке нұсқау беруге тырысатын мәтін болуы мүмкін. DOC-V құжаттардың мазмұнын командалар ретінде емес, деректер ретінде береді, ал жазу әкімшінің операцияларымен шектелген. Бұл тәуекелді азайтады, бірақ толық жоймайды, сондықтан мұнда ең аз құқықтар қағидаты басты.

🛠️ Қалай қосуға болады

DOC-V әкімшісі

1. Кілттерге арналған құжат түрі, мысалы «MCP кілті»: «Құпиясөз» түріндегі өріс (хештеу немесе шифрлау), сипаттама — кілт кімге және не үшін берілді, қажет болса, агент атынан жұмыс істейтін қызметкерге сілтеме.
2. Кілт құжаты: «Құпиясөз» өрісінде — 32 таңбадан кем емес кездейсоқ жол, мысалы openssl rand -hex 32 командасының нәтижесі. Сақтағаннан кейін мән енді еш жерде көрсетілмейді — оны агентті қосатын адамға бірден беріңіз.
3. Сервис: «Әкімшілендіру» → «Сервистер» → «MCP сервисі» → «Баптау» → «Жаңа сервис». Мекенжай, кілттердің түрі мен өрісі, қажетті құралдар, шектер, IP-мекенжайлар және агентке арналған түсіндірме.
4. Жазу операциялары — агент бір нәрсені өзгертуі тиіс болса: құжат түрі, өрістер мен олардың параметрлері, маршрут нүктелері және орындалғаннан кейін не істеу керектігі.
5. Қызметкерге сервис терезесіндегі «Агентке арналған мекенжайды» (https://сіздің-сервер/mcp/сервис-мекенжайы) және кілтті беріңіз.

Барлық баптаулармен қадам-қадаммен — «Сервис MCP» құжаттама мақаласында (орыс тілінде).

Қызметкер: клиентті баптау

Клиентке екі мән керек: мекенжай және кілт. Кілтті баптаулар файлында емес, орта айнымалысында ұстаған дұрыс, әсіресе файл репозиторийде жатса. Төмендегі мысалдарда кілт DOCV_MCP_KEY айнымалысында.

Claude Code — бір командамен:

claude mcp add --transport http docv https://сіздің-сервер/mcp/сервис-мекенжайы \
  --header "Authorization: Bearer $DOCV_MCP_KEY"

Codex CLI — ~/.codex/config.toml файлында:

[mcp_servers.docv]
url = "https://сіздің-сервер/mcp/сервис-мекенжайы"
bearer_token_env_var = "DOCV_MCP_KEY"

Cursor — ~/.cursor/mcp.json немесе жобаның .cursor/mcp.json файлында:

{
  "mcpServers": {
    "docv": {
      "url": "https://сіздің-сервер/mcp/сервис-мекенжайы",
      "headers": { "Authorization": "Bearer ${env:DOCV_MCP_KEY}" }
    }
  }
}

GitHub Copilot бар VS Code — .vscode/mcp.json файлында; кілтті VS Code алғаш іске қосқанда сұрап, өзінде сақтайды:

{
  "inputs": [
    { "type": "promptString", "id": "docv-key", "description": "DOC-V MCP кілті", "password": true }
  ],
  "servers": {
    "docv": {
      "type": "http",
      "url": "https://сіздің-сервер/mcp/сервис-мекенжайы",
      "headers": { "Authorization": "Bearer ${input:docv-key}" }
    }
  }
}

Gemini CLI — бір командамен:

gemini mcp add --transport http --header "Authorization: Bearer $DOCV_MCP_KEY" \
  docv https://сіздің-сервер/mcp/сервис-мекенжайы

Басқа клиенттер де дәл солай қосылады, егер олардың баптауларында MCP сервер мекенжайын (HTTP транспорты) және Authorization тақырыбын көрсетуге болса. Қосылғаннан кейін агент DOC-V құралдарын және әкімшінің түсіндірмесін көреді — бірден сұрауға болады: «Саған DOC-V-нің қай журналдары қолжетімді?»

⚖️ Шектеулер туралы ашық

• OAuth жоқ. MCP серверлеріне тек OAuth арқылы қосылатын веб-коннекторлар (мысалы, чат-боттардың веб-нұсқаларында) DOC-V-ге әзірге қосылмайды. Кілтті тақырыпта бере алатын клиент керек.
• Агент батырмаларды баспайды. Ол құжат пен журналда қандай батырмалар бар екенін көреді, бірақ құжатты маршрут бойынша тек әкімші баптаған операциямен («Нүктеге ауыстыру» немесе «Нүктені орындау») жылжытады.
• Жазу операциялары — негізгі өріс түрлері үшін: Жол, Мәтін, Сан, Күні мен уақыты, Өз тармақтары бар тізім, Бір түрдегі құжаттарға сілтеме.
• Мағына бойынша іздеу DOC-V-де векторлау қосулы болғанда ғана жұмыс істейді. Ұзын жауаптар әкімші белгілеген шек бойынша қысқартылады.
• Жауаптың сапасы агенттің моделіне байланысты. Агент есептеуде қателесуі немесе сұрақты дұрыс түсінбеуі мүмкін — маңызды қорытындыларды құжаттарға сілтемелер бойынша тексеріңіз.
• 8.5.18 немесе жаңарақ нұсқа керек, сондай-ақ DOC-V серверінде HTTPS: онсыз сервис тек сервердің өзінен және сенімді проксиден келген сұрауларға жауап береді.

💰 Құны қанша

DOC-V 8.5 нұсқаларында MCP сервисі тегін: оған лицензиялық кілтте модуль қажет емес, ал шақырулар, кілттер немесе агенттер саны үшін төлем жоқ. Агент моделін ұйым өз жеткізушісіне соның тарифтері бойынша төлейді — немесе жергілікті модельді пайдаланады. Шарттар туралы толығырақ — бағалар бетінде.

🚀 Қорытынды

MCP сервисі тағы бір жүйені енгізуді талап етпейді: қызметкерлер өз агенттерінде қалады, ал DOC-V олар үшін тағы бір дереккөзге айналады — адамдағыдай құқықтармен және әр қадамы жазылып отырады. Тек оқуға арналған бір кілттен және бір журналдан бастауға болады, ал жазу операцияларын агенттің қай жерде шынымен уақыт үнемдейтіні түсінікті бола келе қосуға болады.