AzterDocs

Empezar

Quickstart

En cinco minutos vas a conectar un cliente MCP a tu espacio de Azter y ejecutar una operación comercial real: buscar producto, validar stock y emitir una cotización con condiciones de pago.

1 · Credenciales

Crea una API key desde la consola en Ajustes → Desarrolladores. Cada key se emite con scopes explícitos y puede limitarse a un agente, a un entorno y a un rango de IPs.

terminal
1export AZTER_API_KEY="sk_live_••••••••"
2export AZTER_WORKSPACE="ws_acme"

Ambientes

Usa sk_test_ para el sandbox: mismo contrato, datos ficticios y sin efectos sobre tu ERP ni sobre canales reales.

2 · Conectar un cliente

El servidor MCP de Azter habla Streamable HTTP. Cualquier cliente compatible se conecta con la misma URL.

mcp.json
1{
2  "mcpServers": {
3    "azter": {
4      "url": "https://mcp.azter.ai/v1",
5      "headers": { "Authorization": "Bearer sk_live_••••" }
6    }
7  }
8}

3 · Primera llamada

Consulta el catálogo con precios resueltos para un cliente concreto. Es la tool más simple y no requiere aprobación.

tools/call
1{
2  "name": "catalog.search",
3  "arguments": { "query": "guantes de nitrilo talla M", "price_list": "mayorista" }
4}

4 · Operación completa

El valor real aparece al encadenar herramientas. Este es el arco típico de una compra B2B, ejecutado por el agente y supervisado por tus políticas.

Secuencia

  • catalog.search resuelve producto, lista de precios y descuento por volumen.
  • inventory.check confirma stock real y reserva las unidades.
  • quote.create emite la cotización con condiciones a 30 días.
  • order.place convierte la cotización aceptada en orden en tu ERP (requiere aprobación).
  • audit.query devuelve la traza completa de lo ocurrido.
flow.ts
1const item = await azter.call("catalog.search", { query: "NIT-M-100" });
2await azter.call("inventory.check", { sku: item.sku, quantity: 240 });
3
4const quote = await azter.call("quote.create", {
5  contact_id: "cnt_4412",
6  lines: [{ sku: item.sku, quantity: 240 }],
7  payment_terms: "30d",
8});
9
10// order.place exige aprobación humana según la política del workspace
11await azter.call("order.place", { quote_id: quote.quote_id });

Human-in-the-loop

Las herramientas marcadas como humano devuelven status: "pending_approval" y crean una tarea en la consola. El agente no queda bloqueado: continúa y retoma cuando llega la aprobación.

Qué sigue

  • Revisa el catálogo completo de herramientas y sus esquemas en la sección de MCP.
  • Suscríbete a eventos para reaccionar en tu propio sistema.
  • Define scopes por agente antes de pasar a producción.
AnteriorIntroducciónSiguiente Servidor MCP