# API და MCP — ბიზნეს-სისტემებისა და AI ასისტენტების დაკავშირება

> კომპანიის API გასაღებები, პირადი ტოკენები, Claude-ის, ChatGPT-ის და Cursor-ის დაკავშირება jeCheck-თან MCP-ით, გამოძახებების ჟურნალი და უსაფრთხოება.

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

განყოფილება **API და MCP** jeCheck-ის მონაცემებს უხსნის სხვა სისტემებსა და AI ასისტენტებს: ბუღალტრულ სისტემას შეუძლია შემოწმებების მიღება და ამოცანების შექმნა, BI-ს — ანგარიშების აგება, Claude-ს ან ChatGPT-ს კი — თქვენს ქსელზე კითხვებზე პასუხი და ანალიზის მომზადება. ყველაფერი მუშაობს იმავე უფლებებით, რაც კაბინეტში: გასაღები ან ასისტენტი ხედავს მხოლოდ ნებადართულს.

განყოფილება იხსნება მენიუდან **მართვა → API და MCP** ან პროფილის მენიუდან (დააჭირეთ თქვენს სახელს გვერდითი მენიუს ქვემოთ). API და MCP ხელმისაწვდომია **Enterprise** ტარიფზე.

ტექნიკური დოკუმენტაცია პროგრამისტებისთვის (ინგლისურად) — ყველა მეთოდი, მოთხოვნისა და პასუხის მაგალითები, შეცდომები — პორტალზეა [jecheck.io/developers](https://jecheck.io/developers).

## რისი დაკავშირება შეიძლება

- **ბუღალტრული და საკადრო სისტემები** — შემოწმებების, ტაბელისა და ხელფასის ექსპორტი, თანამშრომლებისა და ობიექტების სინქრონიზაცია, ამოცანების შექმნა.
- **BI (Power BI, Looker, Metabase)** — აუდიტები, დარღვევები, რეგლამენტების შესრულება და HACCP მონაცემები თქვენი ანგარიშებისთვის.
- **ბოტები და პორტალები** — ინსტრუქციების ჩვენება, განაცხადების მიღება, ამოცანების შეხსენება.
- **AI ასისტენტები (Claude, ChatGPT, Cursor და სხვ.)** — MCP-ით ასისტენტი თავად პოულობს მონაცემებს და შეუძლია ამოცანების შექმნა თქვენი სახელით.

## კომპანიის გასაღებები

კომპანიის გასაღები განკუთვნილია ინტეგრაციებისთვის, რომლებიც კონკრეტული ადამიანის გარეშე მუშაობს. მას გასცემს თანამშრომელი უფლებით **კომპანიის API გასაღებები** (ადმინისტრატორს აქვს).

1. გახსენით **API და MCP → კომპანიის გასაღებები** და დააჭირეთ **ახალი გასაღები**.
2. დაარქვით გასაღებს იმ სისტემის სახელი, რომელიც მას გამოიყენებს, მაგ. „1C“ ან „Power BI“.
3. აირჩიეთ **წვდომა**: **მხოლოდ კითხვა** ან **კითხვა და ჩაწერა**.
4. მონიშნეთ **გასაღების როლები** — გასაღები მიიღებს ზუსტად ამ როლების უფლებებს. შეგიძლიათ გასცეთ მხოლოდ ის როლები, რომელთა ყველა უფლებაც თავად გაქვთ.
5. აირჩიეთ **ობიექტები** — გასაღები დაინახავს მხოლოდ ამ ობიექტების მონაცემებს (ან ყველას, ახლების ჩათვლით).
6. საჭიროების შემთხვევაში მიუთითეთ მოქმედების ვადა და დააჭირეთ **შექმნა**.
7. დააკოპირეთ ტოკენი — ის ჩანს **მხოლოდ ერთხელ**. გადაეცით ინტეგრაციის დეველოპერს უსაფრთხოდ.

> გასაღები მუშაობს სერვისული მომხმარებლის „API: სახელი“ სახელით. მას არ შეუძლია კაბინეტსა და აპლიკაციაში შესვლა, ხოლო ყველაფერი, რასაც ინტეგრაცია ქმნის ან ცვლის, ისტორიაში ამ სახელით ჩანს.

**სრულ წვდომას** (როგორც ადმინისტრატორს) მხოლოდ ადმინისტრატორი გასცემს. გამოიყენეთ მხოლოდ მაშინ, როცა ინტეგრაციას ნამდვილად ყველა განყოფილება სჭირდება.

გასაღების **შეცვლა** შეიძლება — სახელის, როლების, ობიექტებისა და წვდომის შეცვლა ტოკენის შეცვლის გარეშე — ან **გაუქმება**: ინტეგრაცია მაშინვე წყვეტს მუშაობას.

## პირადი ტოკენები

პირადი ტოკენი მუშაობს **თქვენი** უფლებებით და გამოდგება სკრიპტებისთვის, API-ის გამოსაცდელად და დეველოპერის AI ხელსაწყოებისთვის (Cursor, Claude Code, VS Code). შექმენით ის ჩანართზე **ჩემი ტოკენები**, თუ გაქვთ უფლება **პირადი API ტოკენები და AI აპლიკაციები**. პირადი ტოკენი სხვებს არ გადასცეთ.

## AI ასისტენტის დაკავშირება (MCP)

MCP ღია პროტოკოლია, რომლითაც AI ასისტენტები სერვისებს უკავშირდებიან. ჩანართზე **AI აპლიკაციები (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-ზე არ გადავა.

### გასაღები მონაცემების ნაწილს ვერ ხედავს

გასაღები ხედავს მხოლოდ თავისი როლებისა და ობიექტების მონაცემებს — ისევე, როგორც ასეთი უფლებების მქონე თანამშრომელი კაბინეტში. შეამოწმეთ გასაღების როლები და ობიექტები ან როლების უფლებები „უფლებები და როლები“-ში.

### მუშაობს თუ არა ინსტრუქციების ბოტის ძველი გასაღები?

დიახ. ცოდნის ბაზის ბოტისთვის ადრე გაცემული გასაღებები ინსტრუქციებთან მუშაობას აგრძელებს. სხვა განყოფილებებისთვის შექმენით ახალი გასაღები.