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

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

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

ტექნიკური დოკუმენტაცია პროგრამისტებისთვის (ინგლისურად) — ყველა მეთოდი, მოთხოვნისა და პასუხის მაგალითები, შეცდომები — პორტალზეა 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 დღე. გასაღებების გაცემა და გაუქმება იწერება „უფლებები და როლები“-ს წვდომის ჟურნალში.

უსაფრთხოება

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

ხშირად დასმული კითხვები