Docs

Conexión de herramientas de IA al servidor MCP de meni.ge

Instrucciones paso a paso para conectar asistentes de IA populares a los datos de su restaurante a través del protocolo MCP.

Qué necesitarás

Antes de conectar cualquier herramienta, necesitas:

  • URL del servidor: https://api.meni.ge/mcp
  • Clave API: generada en el panel de administración admin.meni.ge → ⚙️ Configuración → 🔑 Acceso → 🤖 Claves API MCP

💡 Instrucciones detalladas para generar la clave — en la Guía del usuario de MCP.

Claude Desktop

Aplicación de escritorio Claude de Anthropic.

Paso 1. Abre Claude Desktop

Paso 2. Ve a Settings (⚙️) → Developer → Edit Config

Paso 3. Se abrirá el archivo claude_desktop_config.json. Añade:

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

Paso 4. Guarda el archivo y reinicia Claude Desktop

Paso 5. En un nuevo chat, aparecerá un icono de 🔨 (herramientas) en la parte inferior — haz clic y asegúrate de que el servidor MCP meni está conectado

📁 Ubicación del archivo de configuración:

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

Asistente de IA de terminal de Anthropic.

Método 1 — Comando (recomendado):

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

Método 2 — Archivo de configuración:

Edita el archivo ~/.claude/settings.json:

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

Verificación: Ejecuta claude y pregunta «¿Cuáles son mis ubicaciones?» — Claude llamará a my_locations.

Cursor

Editor de código de IA con soporte integrado para MCP.

Método 1 — A través de la interfaz:

  1. Abre Cursor
  2. Ve a Settings (Cmd/Ctrl + ,) → MCP
  3. Haz clic en "+ Add new MCP Server"
  4. Completa:
    • Name: meni
    • Type: HTTP
    • URL: https://api.meni.ge/mcp
  5. Haz clic en Save
  6. Abre el archivo .cursor/mcp.json y añade el encabezado de autorización (ver abajo)

Método 2 — Archivo de configuración:

Crea el archivo .cursor/mcp.json en la raíz del proyecto:

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

Verificación: En el chat de Cursor (modo Agent) pregunta «Muéstrame mis ubicaciones en meni.ge» — Cursor se conectará al servidor.

💡 Cursor soporta MCP en modo Agent. Asegúrate de que el modo Agent está seleccionado, no Ask.

VS Code (GitHub Copilot)

La extensión GitHub Copilot para VS Code soporta servidores MCP.

Método 1 — Archivo del proyecto (recomendado):

Crea el archivo .vscode/mcp.json en la raíz de tu proyecto:

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

Método 2 — Configuración global:

Abre Settings (Cmd/Ctrl + ,) → busca mcp → abre settings.json y añade:

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

Verificación: Abre Copilot Chat (Ctrl+Alt+I), selecciona el modo Agent y pregunta: «¿Cuáles son mis ubicaciones en meni.ge?»

💡 Los servidores MCP solo funcionan en modo Agent (no en Edits ni en Ask).

Windsurf

Editor de IA de Codeium con soporte para MCP.

Paso 1. Abre Windsurf

Paso 2. Haz clic en el icono 🔨 (martillo) en el panel Cascade, luego Configure

O ve a: Settings → Cascade → MCP Servers

Paso 3. Se abrirá el archivo mcp_config.json. Añade:

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

Paso 4. Guarda y reinicia Windsurf

Verificación: En el chat de Cascade, el icono 🔨 mostrará las herramientas MCP disponibles.

📁 Ubicación del archivo: ~/.codeium/windsurf/mcp_config.json

Cline (extensión VS Code)

Agente de IA autónomo para VS Code.

Paso 1. Abre Cline en VS Code (panel lateral)

Paso 2. Haz clic en MCP Servers (icono 🔌) en la parte superior del panel de Cline

Paso 3. Haz clic en "Remote Servers", luego "Add Remote MCP Server"

Paso 4. Completa:

  • Server URL: https://api.meni.ge/mcp
  • Name: meni
  • Headers (en formato JSON):
{
  "Authorization": "Bearer SU_CLAVE_API"
}

Paso 5. Haz clic en Save

O edita directamente el archivo cline_mcp_settings.json:

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

Verificación: Un indicador verde junto al servidor indica una conexión exitosa.

Continue (VS Code / JetBrains)

Asistente de IA de código abierto para VS Code y JetBrains IDE.

Paso 1. Abre la configuración de Continue: haz clic en ⚙️ en el panel de Continue

Paso 2. Cambia a la pestaña MCP

Paso 3. Haz clic en "Add MCP Server" y selecciona el tipo Streamable HTTP

Paso 4. O edita el archivo ~/.continue/config.yaml:

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

Verificación: En el chat de Continue pregunta «Muéstrame mis ubicaciones» — Continue llamará a las herramientas MCP.

ChatGPT (Connectors)

OpenAI ChatGPT soporta la conexión de servidores MCP externos a través de Connectors.

Paso 1. Abre chatgpt.com

Paso 2. Ve a Settings → Connectors → Add Connector

Paso 3. Selecciona el tipo MCP

Paso 4. Completa:

  • URL: https://api.meni.ge/mcp
  • Authentication: Bearer Token
  • Token: SU_CLAVE_API

Paso 5. Haz clic en Save

Verificación: En un nuevo chat de ChatGPT pregunta «¿Cuáles son mis ubicaciones en meni.ge?» — ChatGPT utilizará las herramientas MCP.

⚠️ Los Connectors están disponibles para suscriptores de ChatGPT Plus / Team / Enterprise.

Solución de problemas

Verifica la clave

Asegúrate de que la clave API funciona antes de configurar cualquier herramienta:

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

Respuesta exitosa: {"status":"ok"}

Problemas comunes

Problema Solución
Conexión rechazada Verifica la URL: https://api.meni.ge/mcp
401 Unauthorized Verifica la clave API — podría haber sido revocada o ingresada incorrectamente
Las herramientas no aparecen Reinicia la herramienta de IA después de guardar la configuración
La clave no funciona Asegúrate de que el formato es: Bearer <clave> (con un espacio después de Bearer)
Clave perdida Revócala en el panel de administración y crea una nueva

Consejos generales

  • Copia la clave API sin espacios ni caracteres adicionales
  • El formato del encabezado siempre es: Authorization: Bearer tu_clave
  • Verifica el estado de la clave en admin.meni.ge → Configuración → Acceso
  • Puedes crear hasta 10 claves — una para cada herramienta
  • Las claves revocadas dejan de funcionar inmediatamente