Docs

AI ინსტრუმენტების დაკავშირება meni.ge MCP სერვერთან

ნაბიჯ-ნაბიჯ ინსტრუქციები პოპულარული AI ასისტენტების თქვენი რესტორნის მონაცემებთან დასაკავშირებლად MCP პროტოკოლის საშუალებით.

რა დაგჭირდებათ

ნებისმიერი ინსტრუმენტის დაკავშირებამდე გჭირდებათ:

  • სერვერის URL: https://api.meni.ge/mcp
  • API გასაღები: გენერირებული ადმინ-პანელში admin.meni.ge → ⚙️ პარამეტრები → 🔑 წვდომა → 🤖 MCP API გასაღებები

💡 გასაღების გენერაციის დეტალური ინსტრუქცია — MCP მომხმარებლის სახელმძღვანელოში.

Claude Desktop

Anthropic-ის დესკტოპ აპლიკაცია.

ნაბიჯი 1. გახსენით Claude Desktop

ნაბიჯი 2. გადადით Settings (⚙️) → Developer → Edit Config

ნაბიჯი 3. გაიხსნება ფაილი claude_desktop_config.json. დაამატეთ:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

ნაბიჯი 4. შეინახეთ ფაილი და გადატვირთეთ Claude Desktop

ნაბიჯი 5. ახალ ჩატში ქვემოთ გამოჩნდება 🔨 (ინსტრუმენტები) იკონი — დააჭირეთ და დარწმუნდით, რომ meni MCP სერვერი დაკავშირებულია

📁 კონფიგურაციის ფაილის მდებარეობა:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code (CLI)

Anthropic-ის ტერმინალის AI ასისტენტი.

ვარიანტი 1 — ბრძანებით (რეკომენდებული):

claude mcp add meni \
  --transport http \
  --url https://api.meni.ge/mcp \
  --header "Authorization: Bearer თქვენი_API_გასაღები"

ვარიანტი 2 — კონფიგურაციის ფაილი:

შეცვალეთ ფაილი ~/.claude/settings.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

შემოწმება: გაუშვით claude და ჰკითხეთ «რა ლოკაციები მაქვს?» — Claude გამოიძახებს my_locations-ს.

Cursor

AI კოდის რედაქტორი ჩაშენებული MCP მხარდაჭერით.

ვარიანტი 1 — ინტერფეისით:

  1. გახსენით Cursor
  2. გადადით Settings (Cmd/Ctrl + ,) → MCP
  3. დააჭირეთ "+ Add new MCP Server"
  4. შეავსეთ:
    • Name: meni
    • Type: HTTP
    • URL: https://api.meni.ge/mcp
  5. დააჭირეთ Save
  6. გახსენით .cursor/mcp.json ფაილი და დაამატეთ ავტორიზაციის ჰედერი (იხ. ქვემოთ)

ვარიანტი 2 — კონფიგურაციის ფაილი:

შექმენით .cursor/mcp.json ფაილი პროექტის root-ში:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

შემოწმება: Cursor-ის ჩატში (Agent რეჟიმი) ჰკითხეთ «მაჩვენე ჩემი ლოკაციები meni.ge-ზე» — Cursor დაუკავშირდება სერვერს.

💡 Cursor MCP-ს მხარს უჭერს Agent რეჟიმში. დარწმუნდით, რომ არჩეულია Agent, და არა Ask.

VS Code (GitHub Copilot)

GitHub Copilot გაფართოება VS Code-სთვის მხარს უჭერს MCP სერვერებს.

ვარიანტი 1 — პროექტის ფაილი (რეკომენდებული):

შექმენით .vscode/mcp.json პროექტის root-ში:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

ვარიანტი 2 — გლობალური პარამეტრები:

გახსენით Settings (Cmd/Ctrl + ,) → მოძებნეთ mcp → გახსენით settings.json და დაამატეთ:

{
  "mcp": {
    "servers": {
      "meni": {
        "type": "http",
        "url": "https://api.meni.ge/mcp",
        "headers": {
          "Authorization": "Bearer თქვენი_API_გასაღები"
        }
      }
    }
  }
}

შემოწმება: გახსენით Copilot Chat (Ctrl+Alt+I), აირჩიეთ Agent რეჟიმი და ჰკითხეთ: «რა ლოკაციები მაქვს meni.ge-ზე?»

💡 MCP სერვერები მუშაობს მხოლოდ Agent რეჟიმში (არა Edits ან Ask-ში).

Windsurf

Codeium-ის AI რედაქტორი MCP მხარდაჭერით.

ნაბიჯი 1. გახსენით Windsurf

ნაბიჯი 2. დააჭირეთ 🔨 (hammer) იკონს Cascade პანელში, შემდეგ Configure

ან გადადით: Settings → Cascade → MCP Servers

ნაბიჯი 3. გაიხსნება mcp_config.json ფაილი. დაამატეთ:

{
  "mcpServers": {
    "meni": {
      "serverUrl": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

ნაბიჯი 4. შეინახეთ და გადატვირთეთ Windsurf

შემოწმება: Cascade ჩატში 🔨 იკონი აჩვენებს ხელმისაწვდომ MCP ინსტრუმენტებს.

📁 ფაილის მდებარეობა: ~/.codeium/windsurf/mcp_config.json

Cline (VS Code გაფართოება)

ავტონომიური AI აგენტი VS Code-სთვის.

ნაბიჯი 1. გახსენით Cline VS Code-ში (გვერდითა პანელი)

ნაბიჯი 2. დააჭირეთ MCP Servers (🔌 იკონი) Cline პანელის ზემოთ

ნაბიჯი 3. დააჭირეთ "Remote Servers", შემდეგ "Add Remote MCP Server"

ნაბიჯი 4. შეავსეთ:

  • Server URL: https://api.meni.ge/mcp
  • Name: meni
  • Headers (JSON ფორმატში):
{
  "Authorization": "Bearer თქვენი_API_გასაღები"
}

ნაბიჯი 5. დააჭირეთ Save

ან პირდაპირ შეცვალეთ cline_mcp_settings.json ფაილი:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

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

Continue (VS Code / JetBrains)

ღია კოდის AI ასისტენტი VS Code და JetBrains IDE-სთვის.

ნაბიჯი 1. გახსენით Continue-ის პარამეტრები: დააჭირეთ ⚙️ Continue პანელში

ნაბიჯი 2. გადადით MCP ჩანართზე

ნაბიჯი 3. დააჭირეთ "Add MCP Server" და აირჩიეთ ტიპი Streamable HTTP

ნაბიჯი 4. ან შეცვალეთ ფაილი ~/.continue/config.yaml:

mcpServers:
  - name: meni
    url: https://api.meni.ge/mcp
    headers:
      Authorization: "Bearer თქვენი_API_გასაღები"

შემოწმება: Continue ჩატში ჰკითხეთ «მაჩვენე ჩემი ლოკაციები» — Continue გამოიყენებს MCP ინსტრუმენტებს.

ChatGPT (Connectors)

OpenAI ChatGPT მხარს უჭერს გარე MCP სერვერებს Connectors-ის საშუალებით.

ნაბიჯი 1. გახსენით chatgpt.com

ნაბიჯი 2. გადადით Settings → Connectors → Add Connector

ნაბიჯი 3. აირჩიეთ ტიპი MCP

ნაბიჯი 4. შეავსეთ:

  • URL: https://api.meni.ge/mcp
  • Authentication: Bearer Token
  • Token: თქვენი_API_გასაღები

ნაბიჯი 5. დააჭირეთ Save

შემოწმება: ახალ ChatGPT ჩატში ჰკითხეთ «რა ლოკაციები მაქვს meni.ge-ზე?» — ChatGPT გამოიყენებს MCP ინსტრუმენტებს.

⚠️ Connectors ხელმისაწვდომია ChatGPT Plus / Team / Enterprise ხელმომწერებისთვის.

პრობლემების აღმოფხვრა

შეამოწმეთ გასაღები

დარწმუნდით, რომ API გასაღები მუშაობს ნებისმიერი ინსტრუმენტის კონფიგურაციამდე:

curl https://api.meni.ge/mcp/health \
  -H "Authorization: Bearer თქვენი_API_გასაღები"

წარმატებული პასუხი: {"status":"ok"}

ხშირი პრობლემები

პრობლემა გადაწყვეტა
კავშირი უარყოფილია შეამოწმეთ URL: https://api.meni.ge/mcp
401 Unauthorized შეამოწმეთ API გასაღები — შეიძლება გაუქმებულია ან არასწორად შეყვანილი
ინსტრუმენტები არ ჩანს გადატვირთეთ AI ინსტრუმენტი კონფიგურაციის შენახვის შემდეგ
გასაღები არ მუშაობს დარწმუნდით ფორმატში: Bearer <გასაღები> (სივრცით Bearer-ის შემდეგ)
გასაღები დაკარგულია გააუქმეთ ადმინ-პანელში და შექმენით ახალი

ზოგადი რჩევები

  • დააკოპირეთ API გასაღები სივრცეების გარეშე და ზედმეტი სიმბოლების გარეშე
  • ჰედერის ფორმატი ყოველთვის: Authorization: Bearer თქვენი_გასაღები
  • შეამოწმეთ გასაღების სტატუსი admin.meni.ge → პარამეტრები → წვდომა
  • შეგიძლიათ შექმნათ 10 გასაღებამდე — თითოეული ინსტრუმენტისთვის ცალკე
  • გაუქმებული გასაღებები წყვეტენ მუშაობას დაუყოვნებლივ