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

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

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

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

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

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

⚠️ В российском контуре MCP-сервера нет. На cenaly.ru он не поднят (/mcp/health отвечает 404 not found), поэтому раздел «MCP API Ключи» в настройках там не показывается — подключать нечего. В остальных контурах адрес из панели рабочий; если ваш аккаунт живёт не в основном контуре, своих данных в нём вы пока можете не увидеть — разведение хранилищ по контурам в работе.

Claude Desktop#

Десктоп-приложение Claude от Anthropic.

Шаг 1. Откройте Claude Desktop

Шаг 2. Перейдите в Settings (⚙️) → Developer → Edit Config

Шаг 3. Откроется файл claude_desktop_config.json. Добавьте:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.cenaly.ru/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 --transport http meni https://api.cenaly.ru/mcp \
  --header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Имя сервера и адрес идут позиционно: сначала meni, затем URL.

Способ 2 — Файл конфигурации:

Создайте файл .mcp.json в корне проекта (или добавьте сервер в общий конфиг Claude Code командой выше с флагом --scope user):

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

Проверка: Запустите claude и спросите «Какие у меня локации?» — Claude вызовет my_locations.

Cursor#

AI-редактор кода с встроенной поддержкой MCP.

Способ 1 — Через интерфейс:

Откройте Cursor
Перейдите в Settings (Cmd/Ctrl + ,) → MCP
Нажмите "+ Add new MCP Server"
Заполните:
- Name: meni
- Type: HTTP
- URL: https://api.cenaly.ru/mcp
Нажмите Save
Откройте файл .cursor/mcp.json и добавьте заголовок авторизации (см. ниже)

Способ 2 — Файл конфигурации:

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

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

Проверка: В чате Cursor (Agent mode) спросите «Покажи мои локации в cenaly.ru» — 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.cenaly.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Способ 2 — Глобальные настройки:

Откройте Settings (Cmd/Ctrl + ,) → найдите mcp → откройте settings.json и добавьте:

{
  "mcp": {
    "servers": {
      "meni": {
        "type": "http",
        "url": "https://api.cenaly.ru/mcp",
        "headers": {
          "Authorization": "Bearer ВАШ_API_КЛЮЧ"
        }
      }
    }
  }
}

Проверка: Откройте Copilot Chat (Ctrl+Alt+I), выберите режим Agent и спросите: «Какие у меня локации на cenaly.ru?»

💡 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.cenaly.ru/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.cenaly.ru/mcp
Name: meni
Headers (в формате JSON):

{
  "Authorization": "Bearer ВАШ_API_КЛЮЧ"
}

Шаг 5. Нажмите Save

Или отредактируйте файл cline_mcp_settings.json напрямую:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.cenaly.ru/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.cenaly.ru/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.cenaly.ru/mcp
Authentication: Bearer Token
Token: ВАШ_API_КЛЮЧ

Шаг 5. Нажмите Save

Проверка: В новом чате ChatGPT спросите «Какие у меня локации на cenaly.ru?» — ChatGPT будет использовать MCP-инструменты.

⚠️ Connectors доступны для подписчиков ChatGPT Plus / Team / Enterprise.

Устранение неполадок#

Проверьте, что сервер жив#

curl https://api.cenaly.ru/mcp/health

Успешный ответ: {"status":"ok", ...} (авторизация для этой проверки не нужна).

Проверьте ключ#

Здесь ключ уже обязателен — сервер должен ответить вашими данными:

curl -X POST https://api.cenaly.ru/mcp \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'

Если вместо данных приходит 401 — ключ неверный или отозван.

Частые проблемы#

Проблема	Решение
Отказ в подключении	Проверьте URL: `https://api.cenaly.ru/mcp`
`404 not found` вместо `{"status":"ok"}`	В вашем контуре сервер не поднят — см. предупреждение в начале статьи
`401 Unauthorized`	Проверьте API-ключ — он мог быть отозван или неверно введён
Инструменты не отображаются	Перезапустите AI-инструмент после сохранения конфига
Ключ не работает	Убедитесь, что формат: `Bearer <ключ>` (с пробелом после Bearer)
Ключ потерян	Отзовите его в админ-панели и создайте новый

Общие советы#

Копируйте API-ключ без пробелов и лишних символов
Формат заголовка всегда: Authorization: Bearer ваш_ключ
В панели (admin.cenaly.ru → Настройки → Доступ) видно, какие ключи существуют, их имена и даты создания; сам ключ и его активность там не показываются — если сомневаетесь, отзовите и создайте новый
Можно создать до 10 ключей — по одному для каждого инструмента
Отозванные ключи перестают работать немедленно

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