Herramientas de Business Central

Catálogo de herramientas del servidor MCP de Plur-e para Dynamics 365 Business Central — clientes, artículos y disponibilidad, ventas, compras, almacén y documentos registrados — con ámbito y argumentos de ejemplo.

Respuesta rápida

El servidor de Business Central expone herramientas de lectura para clientes, artículos, disponibilidad, movimientos, documentos de venta y compra, actividades de almacén y documentos registrados, y herramientas de escritura que crean cotizaciones y pedidos de venta. Cada herramienta declara un ámbito read o write; las de escritura se activan por rol y pueden requerir aprobación.

Área	Herramienta	Ámbito	Estado	Qué hace
platform	`list_environments`	read	disponible	Environments del tenant y cuál usa MCP
platform	`list_companies`	read	disponible	Compañías del environment configurado
platform	`select_tenant`	read	disponible	Solo personal de Plur-e y partners: elige el tenant de la sesión
Clientes	`search_customers`	read	disponible	Busca clientes por nombre, número, ciudad o contacto
Clientes	`get_customer`	read	disponible	Ficha de cliente, direcciones, condiciones de pago, saldo
Clientes	`list_customer_ledger`	read	disponible	Movimientos de cliente, opcionalmente por rango de fechas
Artículos	`search_items`	read	disponible	Artículos por número o descripción
Artículos	`get_availability`	read	disponible	Inventario, cantidades en pedidos y disponibilidad prevista, opcionalmente por almacén
Artículos	`list_item_ledger`	read	disponible	Movimientos de producto con filtros
Ventas	`list_sales_documents`	read	disponible	Cotizaciones, pedidos, facturas, abonos y devoluciones por cliente o estado
Ventas	`create_sales_quote`	write	disponible	Crea una cotización con líneas; precios de Business Central
Ventas	`create_sales_order`	write	disponible	Crea un pedido (aprobación por defecto)
Compras	`list_purchase_orders`	read	hoja de ruta	Pedidos de compra abiertos y fechas de recepción previstas
Compras	`get_vendor`	read	hoja de ruta	Cabecera de proveedor y contactos
Almacén	`list_warehouse_activities`	read	hoja de ruta	Recepciones, ubicaciones, picking, envíos y su estado
Almacén	`get_bin_contents`	read	hoja de ruta	Contenido de una ubicación o de un artículo en todas
Almacén	`list_count_discrepancies`	read	hoja de ruta	Diferencias del diario de inventario físico
Documentos	`get_posted_document`	read	disponible	Una factura, envío, abono o recepción registrados con sus líneas
Informes	`run_report_summary`	read	hoja de ruta	Salida resumida de un informe guardado

Ejemplo: `get_availability`

{
  "name": "get_availability",
  "arguments": {
    "itemNo": "1896-S",
    "locationCode": "MAIN"
  }
}

Resultado: las cifras de disponibilidad que devuelve Business Central para el artículo (inventario, en pedidos de venta/compra, prevista), más sourceUrl, la URL de la ficha del artículo en Business Central.

Convenciones

Los argumentos se validan con JSON Schema antes de cualquier llamada.
Los resultados incluyen sourceUrl para que Claude pueda citar el registro.
Las listas devuelven items más un nextCursor opaco; pásalo de vuelta con los mismos argumentos para obtener la página siguiente (pageSize está limitado por el Max page size del tenant).
Las llamadas denegadas o fallidas devuelven un resultado isError con un código error legible por máquina (not_licensed, disabled, scope_denied, tenant_selection_required…) y un mensaje.
Cada llamada queda auditada y visible en el Admin Center (AI & MCP → Audit log).

To be validated

Las herramientas marcadas hoja de ruta están documentadas pero aún no se sirven; el tools/list del servidor es el catálogo de referencia.

Relacionado: Modelo de seguridad · Página de producto

Herramientas de Business Central

Ejemplo: get_availability

Convenciones

On this page

Ejemplo: `get_availability`