# API և MCP — բիզնես համակարգերի և ԱԲ օգնականների միացում

> Ընկերության API բանալիներ, անձնական թոքեններ, Claude-ի, ChatGPT-ի և Cursor-ի միացում jeCheck-ին MCP-ով, կանչերի մատյան և անվտանգություն։

Источник: https://jecheck.io/hy/docs/account/api-mcp

**API և MCP** բաժինը jeCheck-ի տվյալները բացում է այլ համակարգերի և ԱԲ օգնականների համար՝ հաշվապահական համակարգը կարող է ստանալ ստուգումները և ստեղծել առաջադրանքներ, BI-ն՝ կառուցել հաշվետվություններ, իսկ Claude-ը կամ ChatGPT-ն՝ պատասխանել ձեր ցանցի մասին հարցերին և պատրաստել վերլուծություններ։ Ամեն ինչ աշխատում է նույն իրավունքներով, ինչ կաբինետում՝ բանալին կամ օգնականը տեսնում է միայն թույլատրվածը։

Բաժինը բացվում է **Կառավարում → API և MCP** ցանկից կամ պրոֆիլի ցանկից (սեղմեք ձեր անվան վրա կողային ցանկի ներքևում)։ API-ն և MCP-ն հասանելի են **Enterprise** սակագնով։

Ծրագրավորողների համար տեխնիկական փաստաթղթերը (անգլերեն)՝ բոլոր մեթոդները, հարցումների և պատասխանների օրինակները, սխալները, [jecheck.io/developers](https://jecheck.io/developers) պորտալում են։

## Ինչ կարելի է միացնել

- **Հաշվապահական և կադրային համակարգեր**՝ ստուգումների, տաբելի և աշխատավարձի արտահանում, աշխատակիցների և կետերի համաժամացում, առաջադրանքների ստեղծում։
- **BI (Power BI, Looker, Metabase)**՝ աուդիտներ, խախտումներ, կանոնակարգերի կատարում և HACCP տվյալներ ձեր հաշվետվությունների համար։
- **Բոտեր և պորտալներ**՝ հրահանգների ցուցադրում, հայտերի ընդունում, առաջադրանքների հիշեցում։
- **ԱԲ օգնականներ (Claude, ChatGPT, Cursor և այլն)**՝ MCP-ով օգնականը ինքն է գտնում տվյալները և կարող է առաջադրանքներ ստեղծել ձեր անունից։

## Ընկերության բանալիներ

Ընկերության բանալին նախատեսված է այն ինտեգրացիաների համար, որոնք աշխատում են առանց կոնկրետ մարդու։ Այն տրամադրում է **Ընկերության API բանալիներ** իրավունքով աշխատակիցը (ադմինիստրատորն ունի)։

1. Բացեք **API և MCP → Ընկերության բանալիներ** և սեղմեք **Նոր բանալի**։
2. Բանալին անվանեք այն համակարգով, որը կօգտագործի այն, օրինակ՝ «1C» կամ «Power BI»։
3. Ընտրեք **Մուտքը**՝ **Միայն կարդալ** կամ **Կարդալ և գրել**։
4. Նշեք **Բանալու դերերը**՝ բանալին կստանա հենց այդ դերերի իրավունքները։ Կարող եք տրամադրել միայն այն դերերը, որոնց բոլոր իրավունքները ունեք ինքներդ։
5. Ընտրեք **Կետերը**՝ բանալին կտեսնի միայն այդ կետերի տվյալները (կամ բոլորը, ներառյալ նորերը)։
6. Անհրաժեշտության դեպքում նշեք գործողության ժամկետը և սեղմեք **Ստեղծել**։
7. Պատճենեք թոքենը՝ այն ցուցադրվում է **միայն մեկ անգամ**։ Փոխանցեք այն ինտեգրացիայի մշակողին անվտանգ եղանակով։

> Բանալին աշխատում է «API: անուն» ծառայողական օգտատիրոջ անունից։ Այն չի կարող մուտք գործել կաբինետ կամ հավելված, իսկ այն ամենը, ինչ ինտեգրացիան ստեղծում կամ փոխում է, պատմության մեջ երևում է այդ անունով։

**Լիարժեք մուտք** (ինչպես ադմինիստրատորը) կարող է տրամադրել միայն ադմինիստրատորը։ Օգտագործեք այն միայն այն դեպքում, երբ ինտեգրացիային իսկապես անհրաժեշտ են բոլոր բաժինները։

Բանալին կարելի է **Փոխել**՝ փոխել անունը, դերերը, կետերը և մուտքը առանց թոքենը փոխարինելու, կամ **Չեղարկել**՝ ինտեգրացիան անմիջապես կդադարի աշխատել։

## Անձնական թոքեններ

Անձնական թոքենն աշխատում է **ձեր** իրավունքներով և հարմար է սկրիպտների, API-ի փորձարկման և մշակողի ԱԲ գործիքների համար (Cursor, Claude Code, VS Code)։ Ստեղծեք այն **Իմ թոքենները** ներդիրում, եթե ունեք **Անձնական API թոքեններ և ԱԲ հավելվածներ** իրավունքը։ Մի փոխանցեք անձնական թոքենն այլ մարդկանց։

## ԱԲ օգնականի միացում (MCP)

MCP-ն բաց արձանագրություն է, որով ԱԲ օգնականները միանում են ծառայություններին։ **ԱԲ հավելվածներ (MCP)** ներդիրում ցույց են տրված սերվերի հասցեն և քայլ առ քայլ հրահանգը։

**Claude-ը և ChatGPT-ն** միանում են առանց թոքենի.

1. Պատճենեք **Սերվերի հասցեն**։
2. Claude-ում՝ **Կարգավորումներ → Կոնեկտորներ → Ավելացնել սեփական կոնեկտոր**։ ChatGPT-ում՝ **Կարգավորումներ → Հավելվածներ և կոնեկտորներ → Ստեղծել**։
3. Տեղադրեք հասցեն, սեղմեք **Միացնել**, մուտք գործեք jeCheck և թույլատրեք մուտքը։ **Թույլատրել փոփոխությունները** նշումը կարող եք հանել՝ այդ դեպքում օգնականը միայն կկարդա։

**Cursor, VS Code, Claude Code** միանում են անձնական թոքենով՝ պատճենելու պատրաստ կարգավորումները նույն ներդիրում են։

Օգնականին հարցերի օրինակներ.

- «Որ հինգ կետերն են այս ամիս ամենավատն անցել խոհանոցի աուդիտը և որ խախտումներն են կրկնվում»
- «Որ առաջադրանքներն են ուշացած Դոստիկ կետում։ Խմբավորիր ըստ պատասխանատուների»
- «Այսօր կա՞ն բացթողումներ HACCP ջերմաստիճանի մատյաններում»
- «Ով է հիմա հերթափոխում կենտրոնական խոհանոցում»

Միացված հավելվածները երևում են **Միացված հավելվածներ** ցուցակում. **Անջատել** կոճակը անմիջապես փակում է նրանց մուտքը։

## Կանչերի մատյան

**Կանչերի մատյան** ներդիրում API-ի և MCP-ի վերջին 100 հարցումներն են՝ ժամանակ, բանալի, գործողություն, պատասխանի կոդ և IP։ Ադմինիստրատորը և «Ընկերության API բանալիներ» իրավունք ունեցողները տեսնում են ընկերության բանալիների կանչերը, յուրաքանչյուր աշխատակից՝ իր թոքենների և հավելվածների կանչերը։ Մատյանը պահվում է 30 օր։ Բանալիների տրամադրումն ու չեղարկումը գրանցվում են «Իրավունքներ և դերեր» բաժնի մուտքի մատյանում։

## Անվտանգություն

- Յուրաքանչյուր համակարգի համար ստեղծեք առանձին բանալի նվազագույն դերերով և կետերով՝ այն ավելի հեշտ է սահմանափակել և չեղարկել։
- Եթե ինտեգրացիան միայն կարդում է տվյալները, տվեք **Միայն կարդալ**։
- Ժամանակավոր միացումների համար նշեք գործողության ժամկետը։
- Չեղարկեք չօգտագործվող բանալիները։ Եթե թոքենը կարող էր հայտնվել կողմնակի անձանց մոտ, անմիջապես չեղարկեք այն և ստեղծեք նորը։

## Հաճախ տրվող հարցեր

### Ինչու են հարցումները վերադարձնում plan_required սխալը

API-ն և MCP-ն մտնում են Enterprise սակագնի մեջ։ Բանալիները կարելի է ստեղծել նախապես, բայց հարցումները կմերժվեն, մինչև ընկերությունը չանցնի Enterprise-ի։

### Բանալին չի տեսնում տվյալների մի մասը

Բանալին տեսնում է միայն իր դերերի և կետերի տվյալները՝ ինչպես նման իրավունքներով աշխատակիցը կաբինետում։ Ստուգեք բանալու դերերն ու կետերը կամ դերերի իրավունքները «Իրավունքներ և դերեր» բաժնում։

### Աշխատու՞մ է հրահանգների բոտի հին բանալին

Այո։ Գիտելիքների բազայի բոտի համար նախկինում տրամադրված բանալիները շարունակում են աշխատել հրահանգների հետ։ Այլ բաժինների համար ստեղծեք նոր բանալի։