დეველოპერებისთვის

MCP სერვერი საქართველოს ბიზნეს სისტემებისთვის

ერთი ჰოსტინგური მისამართი იმ ბიზნეს სისტემებისთვის, რომლებსაც საქართველოში კომპანიები იყენებენ. შედით OAuth-ით, გამოიძახეთ ტიპიზებული ინსტრუმენტები და მიიღეთ სტრუქტურირებული JSON პასუხი.

უფასო ანგარიშის შექმნა API ცნობარი

უფასო პაკეტი: თვეში 300 მოქმედება. ბარათი არ არის საჭირო.

MCP მისამართი

https://waybill.ge/mcp
ტრანსპორტი
Streamable HTTP
შესვლა
OAuth 2.1 ან API გასაღები
პასუხი
სტრუქტურირებული JSON

სწრაფი დაწყება

  1. შექმენით ანგარიში

    დარეგისტრირდით ელფოსტით. უფასო პაკეტს ბარათი არ სჭირდება.

  2. დააკავშირეთ სისტემა

    დაამატეთ RS.GE, Balance.ge ან სხვა სისტემა ბიზნეს ინტეგრაციებში.

    RS.GE-ის ინსტრუქცია

  3. დაამატეთ სერვერი კლიენტში

    მიჰყევით ქვემოთ თქვენი კლიენტის ნაბიჯებს, შემდეგ შედით და დაადასტურეთ წვდომა waybill.ge-ზე.

მხარდაჭერილი კლიენტები

ყველა კლიენტი OAuth-ით შედის. წვდომას ერთხელ ადასტურებთ, waybill.ge-ზე.

Claude რეკომენდებული მუშაობს claude.ai-ში, Claude Desktop-სა და Cowork-ში.

Claude-ის კატალოგიდან

Claude-ში გახსენით Customize → Connectors და მოძებნეთ waybill.ge. დააჭირეთ Connect-ს, შემდეგ შედით ანგარიშში და დაადასტურეთ ამ საიტზე.

ერთი ბმულით

Claude-ში დამატება

Claude გაიხსნება და waybill.ge უკვე შევსებული დაგხვდებათ. დააჭირეთ Add-ს, შემდეგ შედით ანგარიშში და დაადასტურეთ ამ საიტზე.

Claude Code (CLI)

გაუშვით თქვენს პროექტში:

claude mcp add --transport http waybill https://waybill.ge/mcp

Claude Code ავტორიზაციისთვის გახსნის ბრაუზერს. დადასტურების შემდეგ კონექტორი მზად იქნება.

Codex (OpenAI)

დაამატეთ კონექტორი Codex CLI-დან და გაიარეთ ავტორიზაცია:

codex mcp add waybill --url https://waybill.ge/mcp
codex mcp login waybill

გამოიყენეთ OAuth იქ, სადაც Codex-ს მისი მხარდაჭერა აქვს. ხელით კონფიგურაციისთვის Bearer ტოკენი და ჰედერები შეგიძლიათ მართოთ ~/.codex/config.toml-დან; იხილეთ „სხვა MCP კლიენტები“ ქვემოთ.

Cursor
გახსნა Cursor-ში

თუ Cursor არ გაიხსნა, გამოიყენეთ ვებ ინსტალერი.

ან ჩასვით Cursor-ის MCP პარამეტრებში

{ "mcpServers": { "waybill": { "url": "https://waybill.ge/mcp" } } }

ეს არ არის Cursor Marketplace-ის ჩამონათვალი. ეს არის პირდაპირი კონექტორი ჰოსტინგური MCP სერვერისკენ.

Grok Bot
  1. Grok Bot-ის ჩატში გაგზავნეთ ეს შეტყობინება:
    დაამატე ეს MCP სერვერი: https://waybill.ge/mcp
  2. დაადასტურეთ დეტალები, რომლებსაც Grok Bot გაჩვენებთ.
  3. როცა მოგთხოვთ, გაიარეთ ავტორიზაცია OAuth-ით, შემდეგ დაადასტურეთ ამ საიტზე.
  4. waybill.ge-ის ინსტრუმენტები თქვენი შემდეგი შეტყობინებიდან იმუშავებს.
სხვა MCP კლიენტები ChatGPT და ნებისმიერი კლიენტი, რომელიც დისტანციურ MCP სერვერებს უჭერს მხარს.
  1. დაამატეთ MCP მისამართი დისტანციურ სერვერად და შედით OAuth-ით.
  2. თუ თქვენი კლიენტი OAuth-ს ვერ იყენებს, შექმენით API გასაღები და გაგზავნეთ Bearer ტოკენად:
    Authorization: Bearer rsk_live_...

ინსტრუმენტები

92 ტიპიზებული ინსტრუმენტი. მონაცემებს მხოლოდ RS.GE-ის ინსტრუმენტები ცვლის; ყველა სხვა სისტემა მხოლოდ იკითხება.

  • RS.GE

    32 ინსტრუმენტი კითხვა და ჩაწერა

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

    ინსტრუმენტების სახელები
    • get_waybill
    • list_seller_waybills
    • list_buyer_waybills
    • find_return_original
    • get_waybill_corrections
    • list_active_drivers
    • save_waybill_draft
    • update_waybill_draft
    • activate_waybill
    • close_waybill
    • correct_waybill
    • send_waybill_to_transporter
    • cancel_waybill
    • confirm_waybill
    • reject_waybill
    • save_invoice_from_waybill
    • save_advance_invoice
    • save_supply_invoice
    • attach_advance_invoice
    • send_invoice
    • correct_invoice
    • get_invoice
    • list_attachable_advance_invoices
    • list_invoices
    • vat_period_summary
    • list_units
    • list_waybill_types
    • list_transport_types
    • lookup_name_by_tin
    • lookup_taxpayer_info
    • list_rs_companies
    • rsge_open_waybills

  • Balance.ge

    22 ინსტრუმენტი მხოლოდ კითხვა

    კლიენტები, მომწოდებლები, საქონელი, ნაშთები, ფასები, ბალანსები, მთავარი წიგნი და ფულადი ნაკადები.

    ინსტრუმენტების სახელები
    • balance_list_companies
    • balance_check_credentials
    • balance_list_clients
    • balance_list_vendors
    • balance_list_items
    • balance_list_employees
    • balance_list_warehouses
    • balance_list_branches
    • balance_list_price_types
    • balance_get_stocks
    • balance_get_prices
    • balance_find_item
    • balance_list_fixed_assets
    • balance_get_fixed_asset
    • balance_list_documents
    • balance_get_document
    • balance_client_balances
    • balance_vendor_balances
    • balance_fetch_general_ledger
    • balance_cash_flow
    • balance_open_financials
    • balance_open_operations

  • 1C (OneSoft)

    21 ინსტრუმენტი მხოლოდ კითხვა

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

    ინსტრუმენტების სახელები
    • onesoft_list_connections
    • onesoft_check_connection
    • onesoft_list_organisations
    • onesoft_list_items
    • onesoft_list_clients
    • onesoft_list_vendors
    • onesoft_list_contracts
    • onesoft_list_warehouses
    • onesoft_list_branches
    • onesoft_list_price_types
    • onesoft_list_currencies
    • onesoft_get_rates
    • onesoft_get_stocks
    • onesoft_get_prices
    • onesoft_client_balances
    • onesoft_vendor_balances
    • onesoft_cash_balances
    • onesoft_cash_flow
    • onesoft_get_document
    • onesoft_account_turnovers
    • onesoft_trial_balance

  • QuickShipper

    4 ინსტრუმენტი მხოლოდ კითხვა

    მიწოდების ფასები, შეკვეთები და თვალთვალის ბმულები. არაფერი იჯავშნება, იცვლება ან უქმდება.

    ინსტრუმენტების სახელები
    • quickshipper_list_connections
    • quickshipper_get_delivery_quote
    • quickshipper_get_order
    • quickshipper_list_orders

  • ბანკები

    5 ინსტრუმენტი მხოლოდ კითხვა

    თქვენ მიერ არჩეული ანგარიშების ნაშთები, ტრანზაქციები და ამონაწერის შეჯამებები ბანკებში: საქართველოს ბანკი, თიბისი ბანკი და პროკრედიტ ბანკი. გადახდები და გადარიცხვები შეუძლებელია.

    ინსტრუმენტების სახელები
    • bank_list_connections
    • bank_check_connection
    • bank_get_balances
    • bank_list_transactions
    • bank_statement_summary

  • საჯარო რეესტრი და NBG-ის კურსები

    4 ინსტრუმენტი მხოლოდ კითხვა

    კომპანიების, ყადაღებისა და უძრავი ქონების მოძიება საჯარო რეესტრში (NAPR) და საქართველოს ეროვნული ბანკის ოფიციალური კურსები. დაკავშირება არ სჭირდება.

    ინსტრუმენტების სახელები
    • napr_company_lookup
    • napr_lien_check
    • napr_property_lookup
    • nbg_exchange_rates

შესვლა და უსაფრთხოება

  • OAuth 2.1

    Authorization code ნაკადი PKCE-ით, კლიენტის დინამიური რეგისტრაცია (RFC 7591) და client ID metadata დოკუმენტები. ერთი scope: mcp.

    აღმოჩენა:

    /.well-known/oauth-protected-resource/mcp/

  • API გასაღებები

    სკრიპტებისა და OAuth-ის გარეშე კლიენტებისთვის. იგზავნება Bearer ტოკენად, ჩანს ერთხელ, ინახება Argon2 ჰეშად და ნებისმიერ დროს შეგიძლიათ გააუქმოთ.

  • შესვლის მონაცემები waybill.ge-ზე რჩება

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

  • ნაგულისხმევად მხოლოდ კითხვა

    მონაცემებს მხოლოდ RS.GE-ის ინსტრუმენტები ცვლის. სხვა სისტემები მხოლოდ იკითხება: არაფერი ტარდება, იჯავშნება ან იხდება.

ლიმიტები და პაკეტები

ერთი თვიური ლიმიტი ყველა დაკავშირებულ სისტემას მოიცავს.

  • უფასო · 0 ლარი თვეში 300 მოქმედება
  • სტარტერი · 19 ლარი თვეში თვეში 5,000 მოქმედება
  • პრო · 39 ლარი თვეში თვეში 15,000 მოქმედება
  • ენტერპრაისი · დაგვიკავშირდით მოცულობა შეთანხმებით

პაკეტების შედარება

როგორ ითვლება მოქმედებები

  • ინსტრუმენტის ყოველი გამოძახება ერთი მოქმედებაა. ანგარიშის ინსტრუმენტები არ ითვლება და ლიმიტის ამოწურვის შემდეგაც მუშაობს: check_credentials, whoami, get_quota_status, get_egress_ip.
  • ლიმიტის ამოწურვისას ინსტრუმენტები აბრუნებს QUOTA_EXCEEDED შეცდომას პაკეტის შეცვლის ბმულებით.
  • უფასო ლიმიტი განახლდება ყოველი თვის 1 რიცხვში, 00:00 საათზე, თბილისის დროით.
  • საჯარო REST API შეზღუდულია IP მისამართის მიხედვით და აგზავნის RateLimit ჰედერებს. ლიმიტის გადაჭარბებისას პასუხია 429, Retry-After ჰედერით.

ვერსიები

  • /api/v1 პასუხების სტრუქტურას არ ცვლის. შეუთავსებელი ცვლილება ახალ ვერსიად, ახალ გზაზე გამოდის.
  • MCP ინსტრუმენტების სქემებს ველები მხოლოდ ემატება. არაფერი იშლება და არც დანიშნულება ეცვლება.
  • წაშლას მინიმუმ 6 თვით ადრე ვაცხადებთ Deprecation და Sunset ჰედერებით (RFC 8594) და ამ გვერდზე.
  • როცა ინსტრუმენტები იცვლება, სერვერი მიერთებულ კლიენტებს სთხოვს, ინსტრუმენტების სია თავიდან ჩამოტვირთონ. თუ AI აპლიკაცია ისევ მოძველებულ ინსტრუმენტებს აჩვენებს, ხელახლა დააკავშირეთ კონექტორი.

დოკუმენტაცია და მხარდაჭერა