Docs

Подключение AI-инструментов к MCP серверу meni.ge

Пошаговые инструкции для подключения популярных AI-ассистентов к данным вашего ресторана через протокол MCP.

Что понадобится

Перед подключением любого инструмента вам нужны:

  • URL сервера: https://api.meni.ge/mcp
  • API-ключ: сгенерированный в админ-панели admin.meni.ge → ⚙️ Настройки → 🔑 Доступ → 🤖 MCP API Ключи

💡 Подробная инструкция по генерации ключа — в Руководстве пользователя MCP.

Claude Desktop

Десктоп-приложение Claude от 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. В новом чате внизу появится иконка 🔨 (инструменты) — нажмите и убедитесь, что MCP-сервер meni подключён

📁 Расположение файла конфигурации:

  • 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)

Терминальный AI-ассистент от Anthropic.

Способ 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 в корне проекта:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Проверка: В чате Cursor (Agent mode) спросите «Покажи мои локации в meni.ge» — Cursor подключится к серверу.

💡 Cursor поддерживает MCP в режиме Agent. Убедитесь, что выбран режим Agent, а не Ask.

VS Code (GitHub Copilot)

Расширение GitHub Copilot для VS Code поддерживает MCP-серверы.

Способ 1 — Файл проекта (рекомендуется):

Создайте файл .vscode/mcp.json в корне вашего проекта:

{
  "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

AI-редактор от Codeium с поддержкой 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)

Open-source 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 ключей — по одному для каждого инструмента
  • Отозванные ключи перестают работать немедленно