Podłączenie narzędzi AI do serwera MCP meni.ge

Instrukcje krok po kroku dotyczące podłączenia popularnych asystentów AI do danych Twojej restauracji za pomocą protokołu MCP.

Co będzie potrzebne

Przed podłączeniem jakiegokolwiek narzędzia potrzebujesz:

URL serwera: https://api.meni.ge/mcp
Klucz API: wygenerowany w panelu administracyjnym admin.meni.ge → ⚙️ Ustawienia → 🔑 Dostęp → 🤖 Klucze MCP API

💡 Szczegółowa instrukcja generowania klucza znajduje się w Podręczniku użytkownika MCP.

Claude Desktop

Aplikacja desktopowa Claude od Anthropic.

Krok 1. Otwórz Claude Desktop

Krok 2. Przejdź do Settings (⚙️) → Developer → Edit Config

Krok 3. Otworzy się plik claude_desktop_config.json. Dodaj:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Krok 4. Zapisz plik i zrestartuj Claude Desktop

Krok 5. W nowym czacie na dole pojawi się ikona 🔨 (narzędzia) — kliknij i upewnij się, że serwer MCP meni jest podłączony

📁 Lokalizacja pliku konfiguracyjnego:

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)

Terminalowy asystent AI od Anthropic.

Sposób 1 — Komendą (zalecane):

claude mcp add meni \
  --transport http \
  --url https://api.meni.ge/mcp \
  --header "Authorization: Bearer TWÓJ_KLUCZ_API"

Sposób 2 — Plik konfiguracyjny:

Edytuj plik ~/.claude/settings.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Sprawdzenie: Uruchom claude i zapytaj „Jakie mam lokalizacje?” — Claude wywoła my_locations.

Cursor

Edytor kodu AI z wbudowanym wsparciem MCP.

Sposób 1 — Przez interfejs:

Otwórz Cursor
Przejdź do Settings (Cmd/Ctrl + ,) → MCP
Kliknij "+ Add new MCP Server"
Wypełnij:
- Name: meni
- Type: HTTP
- URL: https://api.meni.ge/mcp
Kliknij Save
Otwórz plik .cursor/mcp.json i dodaj nagłówek autoryzacji (patrz poniżej)

Sposób 2 — Plik konfiguracyjny:

Utwórz plik .cursor/mcp.json w katalogu głównym projektu:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Sprawdzenie: W czacie Cursor (Agent mode) zapytaj „Pokaż moje lokalizacje w meni.ge” — Cursor połączy się z serwerem.

💡 Cursor wspiera MCP w trybie Agent. Upewnij się, że wybrany jest tryb Agent, a nie Ask.

VS Code (GitHub Copilot)

Rozszerzenie GitHub Copilot dla VS Code wspiera serwery MCP.

Sposób 1 — Plik projektu (zalecane):

Utwórz plik .vscode/mcp.json w katalogu głównym projektu:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Sposób 2 — Ustawienia globalne:

Otwórz Settings (Cmd/Ctrl + ,) → znajdź mcp → otwórz settings.json i dodaj:

{
  "mcp": {
    "servers": {
      "meni": {
        "type": "http",
        "url": "https://api.meni.ge/mcp",
        "headers": {
          "Authorization": "Bearer TWÓJ_KLUCZ_API"
        }
      }
    }
  }
}

Sprawdzenie: Otwórz Copilot Chat (Ctrl+Alt+I), wybierz tryb Agent i zapytaj: „Jakie mam lokalizacje na meni.ge?”

💡 Serwery MCP działają tylko w trybie Agent (nie w Edits ani nie w Ask).

Windsurf

Edytor AI od Codeium z wsparciem MCP.

Krok 1. Otwórz Windsurf

Krok 2. Kliknij na ikonę 🔨 (młotek) w panelu Cascade, następnie Configure

Lub przejdź: Settings → Cascade → MCP Servers

Krok 3. Otworzy się plik mcp_config.json. Dodaj:

{
  "mcpServers": {
    "meni": {
      "serverUrl": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Krok 4. Zapisz i zrestartuj Windsurf

Sprawdzenie: W czacie Cascade ikona 🔨 pokaże dostępne narzędzia MCP.

📁 Lokalizacja pliku: ~/.codeium/windsurf/mcp_config.json

Cline (rozszerzenie VS Code)

Autonomiczny agent AI dla VS Code.

Krok 1. Otwórz Cline w VS Code (panel boczny)

Krok 2. Kliknij MCP Servers (ikona 🔌) w górnej części panelu Cline

Krok 3. Kliknij "Remote Servers", następnie "Add Remote MCP Server"

Krok 4. Wypełnij:

Server URL: https://api.meni.ge/mcp
Name: meni
Headers (w formacie JSON):

{
  "Authorization": "Bearer TWÓJ_KLUCZ_API"
}

Krok 5. Kliknij Save

Lub edytuj plik cline_mcp_settings.json bezpośrednio:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_API"
      }
    }
  }
}

Sprawdzenie: Zielony wskaźnik obok serwera oznacza pomyślne połączenie.

Continue (VS Code / JetBrains)

Open-source asystent AI dla VS Code i JetBrains IDE.

Krok 1. Otwórz ustawienia Continue: kliknij ⚙️ w panelu Continue

Krok 2. Przełącz się na zakładkę MCP

Krok 3. Kliknij "Add MCP Server" i wybierz typ Streamable HTTP

Krok 4. Lub edytuj plik ~/.continue/config.yaml:

mcpServers:
  - name: meni
    url: https://api.meni.ge/mcp
    headers:
      Authorization: "Bearer TWÓJ_KLUCZ_API"

Sprawdzenie: W czacie Continue zapytaj „Pokaż moje lokalizacje” — Continue wywoła narzędzia MCP.

ChatGPT (Connectors)

OpenAI ChatGPT wspiera podłączenie zewnętrznych serwerów MCP przez Connectors.

Krok 1. Otwórz chatgpt.com

Krok 2. Przejdź do Settings → Connectors → Add Connector

Krok 3. Wybierz typ MCP

Krok 4. Wypełnij:

URL: https://api.meni.ge/mcp
Authentication: Bearer Token
Token: TWÓJ_KLUCZ_API

Krok 5. Kliknij Save

Sprawdzenie: W nowym czacie ChatGPT zapytaj „Jakie mam lokalizacje na meni.ge?” — ChatGPT użyje narzędzi MCP.

⚠️ Connectors są dostępne dla subskrybentów ChatGPT Plus / Team / Enterprise.

Rozwiązywanie problemów

Sprawdź klucz

Upewnij się, że klucz API działa, zanim skonfigurujesz jakiekolwiek narzędzie:

curl https://api.meni.ge/mcp/health \
  -H "Authorization: Bearer TWÓJ_KLUCZ_API"

Pomyślna odpowiedź: {"status":"ok"}

Częste problemy

Problem	Rozwiązanie
Odmowa połączenia	Sprawdź URL: `https://api.meni.ge/mcp`
`401 Unauthorized`	Sprawdź klucz API — mógł zostać odwołany lub błędnie wprowadzony
Narzędzia się nie wyświetlają	Zrestartuj narzędzie AI po zapisaniu konfiguracji
Klucz nie działa	Upewnij się, że format: `Bearer <klucz>` (z odstępem po Bearer)
Klucz zgubiony	Odwołaj go w panelu administracyjnym i stwórz nowy

Ogólne porady

Kopiuj klucz API bez spacji i zbędnych znaków
Format nagłówka zawsze: Authorization: Bearer twój_klucz
Sprawdzaj status klucza na admin.meni.ge → Ustawienia → Dostęp
Możesz stworzyć do 10 kluczy — po jednym dla każdego narzędzia
Odwołane klucze przestają działać natychmiast