# Tu primera conexión

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

Página: https://zoydelivery.com/docs/primeros-pasos

## 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.

> **También es información privada**
>
> Una clave de lectura accede a códigos y costos internos. No la entregues a compradores ni la insertes en una web pública. La documentación nunca necesita tu clave.

## Configura un cliente HTTP

### Configuración genérica: adapta el formato a tu cliente

```json
{
  "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.

- [Configuración de VS Code y cliente Node.js](https://zoydelivery.com/docs/clientes-mcp)

## Verifica la conexión con una lectura

### Petición para tu agente

```text
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

```bash
npm install @modelcontextprotocol/sdk@1.32.2
# Configura ZOY_MENU_TOKEN en el entorno privado del proceso.
node zoy-mcp-read.mjs
```

- [Descargar zoy-mcp-read.mjs](https://zoydelivery.com/examples/zoy-mcp-read.mjs)
- [Ver el código del ejemplo](https://zoydelivery.com/docs/clientes-mcp#node)

## 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.

- [Entender códigos, moneda y campos del catálogo](https://zoydelivery.com/docs/catalogo)
- [Revisar permisos y seguridad](https://zoydelivery.com/docs/seguridad)