MCP Server — User Guide

What is it?

The MCP server (Model Context Protocol) for meni.ge allows you to connect AI assistants (Claude, ChatGPT, Cursor, VS Code Copilot, etc.) to your restaurant data. The AI gets access to your menu, locations, orders, images and can manage them on your behalf.

Quick Start

1. Get an API Key

The API key is generated in your restaurant's admin panel.

Step by step:

1. Log in to the Admin Panel at admin.meni.ge
2. In the sidebar menu, go to ⚙️ Settings → 🔑 Access
3. Find the 🤖 MCP API Keys section on the page
4. Click the "Generate New Key" button
5. Enter a key name (e.g., "Claude Desktop", "Cursor", "My GPT") — this helps distinguish keys from each other
6. Copy the key immediately — it is shown only once!

💡 The same page also displays the Server URL (https://api.meni.ge/mcp), which you can copy with one click.

Managing Keys

• You can create up to 10 keys per account
• Each key can be revoked at any time — use the "Revoke" button next to the key
• Once revoked, the key stops working immediately
• If a key is lost — revoke it and create a new one

2. Connect Your AI Assistant

Claude Desktop / Claude Code

Configuration file claude_desktop_config.json:

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

Cursor

In Cursor settings → MCP Servers → Add, or create .cursor/mcp.json:

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

VS Code (GitHub Copilot)

In your project's .vscode/mcp.json:

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

Other AI Tools

Detailed step-by-step instructions for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Continue, ChatGPT and more — in a separate guide:

👉 Connect AI Tools to MCP

What Can the AI Assistant Do?

For Restaurant Owners (Regular Users)

User Profiles

Working with Locations

Working with Menus

Orders

Domains

CDN (Published Data)

Images

Low-level S3 Access

Cognito

Statistics

Authentication

The server supports three authentication methods:

1. API Key (recommended for AI assistants)

Authorization: Bearer your_64_character_key

The key is generated in the admin panel. It is bound to your account — the AI sees only your data.

2. Cognito JWT Token

For programmatic integration, you can obtain a token via login:

# Get token
curl -X POST https://api.meni.ge/mcp/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "password": "your_password"}'

# The response contains idToken — use it:
Authorization: Bearer eyJraWQ...

The token is valid for 1 hour, after which you need to log in again.

3. Admin API Key (administrators only)

Authorization: Bearer admin_key

The admin key grants full access to all users' data.

Security

• Each API key is bound to a specific account
• Regular users can see only their own data
• A key can be revoked at any time in the admin panel
• Maximum of 10 keys per account
• All requests use HTTPS
• Commands marked [ADMIN] are not available to regular users

Usage Examples

Ask AI to update a dish price

"Update the price of 'Khachapuri' in my menu — make it 15 GEL instead of 12"

AI will call my_locations → get_location_menu → update_menu_item.

Add a new item to the menu

"Add a new dish 'Churchkhela' for 8 GEL to the 'Desserts' category"

AI will call my_locations → get_location_menu → create_menu_item.

Create a new category

"Create a 'Drinks' category with Georgian and Russian translations"

AI will call create_menu_category with nameTranslations.

Move an item between categories

"Move 'Lemonade' from 'Cold Drinks' to 'Non-Alcoholic'"

AI will call move_menu_item specifying source and target categories.

View today's orders

"Show me my orders for today"

AI will call my_orders and filter by date.

Check the published menu

"How does my menu look in Russian for visitors?"

AI will call resolve_domain → get_cdn_menu with language ru.

Change the restaurant domain

"Check if domain my-restaurant is available, and if so — set it"

AI will call check_domain_availability → set_location_domain.

Upload a dish photo

"Give me a link to upload a photo for dish X"

AI will call get_image_upload_url and return a presigned URL for uploading.

API Endpoints

Key Management

Viewing Keys

In Admin Panel → Settings → Access → MCP API Keys. Or via API:

curl https://api.meni.ge/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

Creating a Key

curl -X POST https://api.meni.ge/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Claude Desktop"}'

The response contains a key field — that is your key. Save it!

Revoking a Key

curl -X DELETE https://api.meni.ge/mcp/api/keys/mk_abc123 \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

⚠️ Creating and revoking keys requires a Cognito JWT token (not an API key). Use the admin panel — it's simpler.

Troubleshooting