Cómo conectar Dynamics 365 Business Central a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Microsoft Dynamics 365 Business Central, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Dynamics 365 Business Central + Gemini

Deja que tu IA trabaje en Business Central: consulta clientes, proveedores y productos, lee ofertas, pedidos y facturas de venta, facturas de compra, la contabilidad general, el plan de cuentas y las dimensiones, y crea clientes y borradores de ofertas y pedidos. Business Central online a través de la API estándar v2.0, con el inicio de sesión de tu cuenta de Microsoft.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID, BC_ENVIRONMENT

Paso 1 — Obtener credenciales

1. Abre el centro de administración de Microsoft Entra en https://entra.microsoft.com → Applications → App registrations → New registration, o reutiliza la app que creaste para el conector de Outlook, OneDrive o SharePoint. Lo habitual es elegir Accounts in this organizational directory only.
2. Añade un URI de redirección con la plataforma Web: https://cloud.anythingmcp.com/api/mcp-oauth/callback (si alojas AnythingMCP tú mismo: <your AnythingMCP URL>/api/mcp-oauth/callback). Debe coincidir exactamente; si no, Microsoft responde AADSTS50011.
3. En API permissions → Add a permission → Dynamics 365 Business Central → Delegated permissions, marca Financials.ReadWrite.All (y user_impersonation). Haz clic en Grant admin consent si tu organización no permite que los usuarios den su consentimiento por sí mismos.
4. En Certificates & secrets → New client secret, copia el Value del secreto. Solo se muestra una vez; el Secret ID no es lo que necesitas.
5. Rellena MICROSOFT_CLIENT_ID (el Application (client) ID), MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID y BC_ENVIRONMENT, e instala el conector.
6. Haz clic en Authorize with Provider e inicia sesión con un usuario de Business Central. Los access tokens se renuevan automáticamente.
7. Ejecuta bc_list_companies. Todas las demás herramientas trabajan dentro de una empresa y necesitan su id.

Inquilino y entorno: MICROSOFT_TENANT_ID es tu Directory (tenant) ID o un dominio como contoso.onmicrosoft.com. common y organizations no funcionan aquí, porque el inquilino forma parte de la dirección de Business Central. BC_ENVIRONMENT es el nombre del entorno tal como aparece en el centro de administración de Business Central: Production en la mayoría de los inquilinos en producción, Sandbox o un nombre propio para un entorno de pruebas. bc_list_environments muestra los nombres. Prueba primero el conector en un sandbox: en producción, los clientes y documentos que crea son reales.

Los mismos permisos que el usuario: cada llamada se ejecuta como el usuario que inició sesión, con su licencia de Business Central y sus conjuntos de permisos. La IA ve y modifica exactamente lo que ese usuario puede.

Qué lee y escribe: clientes, proveedores, productos, ofertas, pedidos y facturas de venta, facturas de compra, movimientos de contabilidad, el plan de cuentas, dimensiones y empleados, además de cualquier otro recurso estándar de la API v2.0 mediante bc_query, como contactos, pedidos de compra, abonos, antigüedad de cobros y pagos o el balance de comprobación. Crea clientes y ofertas y pedidos de venta con sus líneas, y actualiza clientes. Los documentos quedan como borradores abiertos: nada se lanza, se envía, se factura ni se registra. Antes de crear un documento, la IA confirma contigo el cliente, los productos, las cantidades y los precios.

Desactivadas al instalar: bc_delete_customer, bc_make_order_from_quote, bc_delete_sales_quote y bc_delete_sales_order. Eliminar un registro o convertir una oferta en pedido no se puede deshacer, así que activa estas herramientas una a una solo si las necesitas.

Límites: Business Central permite unas 6000 llamadas a la API por usuario cada 5 minutos; por encima de eso, pide al conector que espere.

Errores frecuentes: 401 significa que la autorización se revocó o que el client secret caducó: pega un secreto nuevo si hace falta y vuelve a autorizar. 403: al usuario le falta una licencia o un conjunto de permisos, o falta el consentimiento del administrador. 404 NoEnvironment: BC_ENVIRONMENT o MICROSOFT_TENANT_ID es incorrecto. 412: alguien modificó el registro después de leerlo, así que la IA lo vuelve a leer.

Solo Business Central online: las instalaciones locales no están cubiertas, y las instalaciones antiguas de NAV tienen su propio conector de Dynamics NAV. No llega a las API personalizadas que publican las extensiones.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Dynamics 365 Business Central.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué clientes tienen facturas vencidas y cuál es el total por cliente?"
• "Muéstrame los pedidos de venta de este mes que aún no se han enviado por completo."
• "Crea una oferta de venta para Adatum Corporation con 10 unidades del producto 1896-S y enséñamela antes de guardarla."
• "¿Qué registramos en las cuentas de ingresos en septiembre, por departamento?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT