Saltar al contenido
DocumentaciónAbrir panel
Explorar guías
IntegracionesTu primera conexión

Tu primera conexión

Crea una clave de lectura y comprueba una llamada real antes de habilitar importaciones.

Abrir Markdown

Servidor 1.0 · MCP 2025-11-25 · Claves Bearer por negocio

En esta página

Crea una clave del negocio

  1. Entra al panel del negocio y abre Menú → Conectar con una cuenta que pueda gestionar el catálogo.
  2. Nombra el sistema o agente, elige Solo consultar y define la vigencia. El valor inicial es 90 días, con máximo de 365.
  3. Crea la clave y guárdala en el almacén privado de tu cliente. Solo se muestra al crearla; puedes revocarla desde el mismo panel.

Configura un cliente HTTP

Configuración genérica: adapta el formato a tu cliente
{
  "mcpServers": {
    "zoy": {
      "url": "https://zoydelivery.com/api/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE_PRIVADA"
      }
    }
  }
}

Este es un ejemplo con un marcador, no un formato universal. Reemplázalo únicamente en la configuración privada del cliente; no lo pegues en una conversación ni lo subas a Git. Si el cliente solo admite OAuth, este método no es compatible.

Verifica la conexión con una lectura

Petición para tu agente
Usa el servidor MCP zoy. Descubre sus herramientas y consulta catalog_schema. Informa moneda, unidad monetaria y límites, sin mostrar costos ni credenciales. No crees propuestas ni modifiques productos.

Comprueba la llamada y su resultado en el cliente. Ver el servidor en una lista no demuestra que la autorización funcione. El ejemplo descargable permite probar el mismo recorrido con el SDK oficial.

SDK oficial 1.x, en un proyecto Node.js
npm install @modelcontextprotocol/[email protected]
# Configura ZOY_MENU_TOKEN en el entorno privado del proceso.
node zoy-mcp-read.mjs

Habilita escritura cuando vayas a importar

Crea una clave independiente con Consultar e importar. La lectura no permite preparar documentos, guardar propuestas ni publicar. Conserva separados los entornos y las credenciales de cada negocio.