AzterDocs

Empezar

Quickstart

En pocos minutos vas a conectar un cliente MCP a tu espacio de Azter y ejecutar una llamada real contra tus datos: contactos, catálogo y stock. La vía más rápida es OAuth: el propio cliente abre el navegador y tú autorizas tu workspace.

1 · Credenciales

Necesitas una cuenta de Azter con un workspace activo. Hay dos caminos, ambos disponibles hoy:

  • OAuth 2.1 — al conectar el cliente se abre el navegador, inicias sesión en Azter y eliges el workspace a autorizar. No requiere copiar nada a mano.
  • API key — desde la consola en Configuración → API generas una clave que puedes revocar en cualquier momento.
terminal
1export AZTER_API_KEY="azter_live_••••••••"   # desde Consola → Configuración → API

Sobre ambientes

Hoy la integración opera sobre tu workspace real. Un entorno sandbox para developers está en desarrollo y se anunciará aquí cuando exista.

2 · Conectar un cliente

El servidor MCP de Azter habla JSON-RPC 2.0 sobre HTTP en https://mcp.azter.ai. Cualquier cliente compatible se conecta con la misma URL.

mcp.json
1{
2  "mcpServers": {
3    "azter": {
4      "url": "https://mcp.azter.ai"
5    }
6  }
7}

3 · Primera llamada

Consulta el stock de un producto por SKU. Es de solo lectura y no requiere aprobación.

terminal
1curl https://mcp.azter.ai \
2  -H "Authorization: Bearer $AZTER_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
5       "params":{"name":"check_stock","arguments":{"sku":"TU-SKU"}}}'

Respuesta

El resultado incluye el stock y su disponibilidad. En las capabilities canónicas, toda respuesta respaldada por un sistema externo incluye además provenance con la frescura del dato.

Qué sigue

  • Explora la referencia de capabilities con schemas reales.
  • Suscribe webhooks para reaccionar a eventos en tus sistemas.
  • Revisa el modelo de scopes antes de ampliar permisos.

Acceso para developers

El self-service completo de developers (registro, sandbox, facturación por uso) está en construcción. Para acceso anticipado o integraciones partners, solicita acceso desde el sitio.

AnteriorIntroducciónSiguiente Conceptos