MCP de AdmCloud (Claude, Codex y otros asistentes)
El MCP de AdmCloud conecta tu asistente de inteligencia artificial favorito (Claude, Codex o cualquier otro compatible con MCP) con tu empresa en AdmCloud. Una vez conectado, puedes preguntarle en lenguaje natural por tus ventas, saldos, cuentas por cobrar o existencias, y, si tu grupo de usuarios lo permite, pedirle que cree o modifique clientes, artículos, facturas, pagos y otros registros, sin entrar a las pantallas de AdmCloud.
¿Qué es y para qué sirve?
MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA usar herramientas de otros sistemas. AdmCloud publica un servidor MCP en https://mcp.admcloud.net/mcp con más de 150 herramientas sobre los datos de tu empresa. Tu asistente decide qué herramienta usar según lo que le pidas, la ejecuta con tu usuario y te responde con el resultado.
- Consultar: ventas por mes, cliente, artículo o vendedor; estado de resultados, balance general y balanza de comprobación; saldos de bancos, clientes y proveedores; antigüedad de cuentas por cobrar y por pagar; existencias y artículos por reordenar; documentos pendientes de autorización; empleados ausentes hoy, y mucho más.
- Registrar: clientes, proveedores, contactos, artículos, servicios, kits, proyectos, cotizaciones, pedidos, facturas, ventas al contado, notas de crédito, facturas de proveedor, órdenes de compra, pagos, depósitos, transferencias, solicitudes de servicio y solicitudes de vacaciones.
- Combinar: como el asistente puede usar varias herramientas en una misma respuesta, puedes pedirle análisis que cruzan información ("compara las ventas de este año con las del año pasado y dime qué clientes bajaron más").
¿En qué se diferencia de AtIna? AtIna es el asistente que vive dentro de AdmCloud. El MCP lleva AdmCloud a tu asistente: lo usas desde Claude, Codex u otra aplicación, junto con el resto de tus herramientas (correo, documentos, hojas de cálculo), y con el modelo de IA que tú elijas.
Cómo se activa
No hay que activar nada en la empresa: cualquier usuario de AdmCloud puede conectar su asistente con su propio correo y clave. Lo que sí controla el administrador es si el MCP puede cambiar información (ver la sección siguiente).
- Agrega el conector en tu asistente con la dirección https://mcp.admcloud.net/mcp (los pasos para Claude y Codex están más abajo).
- Inicia sesión. El asistente abre la página de inicio de sesión de AdmCloud en el navegador. Entra con el mismo correo y clave que usas en AdmCloud. Se aplican las mismas reglas: el correo debe estar confirmado, la clave no debe estar vencida y el usuario no debe estar bloqueado.
- Elige la empresa y el grupo de usuarios. Si tienes acceso a una sola empresa y esa empresa tiene un solo grupo de usuarios para ti, se eligen solos. Si no, pídele al asistente, por ejemplo: "¿A qué empresas tengo acceso?" y luego "Usa la empresa Comercial del Norte con el grupo Ventas".
- Empieza a preguntar. La empresa y el grupo elegidos se recuerdan para tus próximas conversaciones hasta que los cambies.
El grupo de usuarios elegido define con qué alcance trabaja el MCP, igual que en AdmCloud: la sucursal y la ubicación del grupo y, si el grupo solo puede ver sus propios registros, las consultas de ventas, clientes y documentos de venta se limitan a los del usuario.
Permitir que el MCP agregue, edite o borre (Grupos de Usuarios)
Por defecto el MCP solo puede consultar. Para que pueda cambiar información, un administrador debe entrar a Administración del Sistema > Grupos de Usuarios, editar el grupo y marcar una o las dos opciones del final del encabezado:
| Opción | Qué permite |
|---|---|
| Permitir que el MCP agregue y edite información | Las herramientas que crean o modifican registros: crear clientes, proveedores, artículos, facturas, pagos, proyectos, etc.; actualizar sus datos; cambiar el estado de una solicitud de servicio y registrar solicitudes de vacaciones. |
| Permitir que el MCP borre información | Las herramientas que eliminan registros o documentos. Las eliminaciones no se pueden deshacer. |
- Se evalúa con el grupo con el que está trabajando el MCP, no con todos los grupos del usuario. Si el usuario pertenece a dos grupos y solo uno tiene la opción marcada, el MCP puede escribir únicamente cuando ese grupo está seleccionado.
- Aplica a todos los grupos, incluido el grupo Admin. Ser administrador da todos los privilegios dentro de AdmCloud, pero no da permiso de escritura al MCP: también hay que marcar las opciones en el grupo Admin si se quiere.
- Son independientes: puedes permitir agregar y editar sin permitir borrar, que es la combinación recomendada para la mayoría de los grupos.
- El cambio surte efecto de inmediato: al marcar o desmarcar una opción, la siguiente acción del asistente ya usa el permiso nuevo, sin volver a conectar.
- Si el MCP intenta cambiar algo sin permiso, la acción se rechaza y el asistente te indica qué opción debe marcar el administrador. No se modifica nada.
- Sin un grupo de usuarios seleccionado, el MCP no puede escribir.
Más detalles sobre los grupos en Grupos de Usuarios.
Configurarlo en Claude
Los conectores personalizados funcionan en Claude en la web, Claude Desktop y Cowork, en los planes Free (un solo conector personalizado), Pro, Max, Team y Enterprise.
Planes Pro y Max (o Free)
- En Claude, ve a Customize > Connectors.
- Pulsa + Add y elige Add custom connector.
- Escribe un nombre (por ejemplo, AdmCloud) y la URL https://mcp.admcloud.net/mcp. Pulsa Continue.
- Deja la autenticación que Claude detecta (OAuth) y pulsa Add. Al conectar, se abre la página de inicio de sesión de AdmCloud: entra con tu correo y clave.
Planes Team y Enterprise
- Un dueño o administrador de la organización en Claude agrega el conector en Organization settings > Connectors > Add > Custom > Web, con la misma URL.
- Cada persona entra luego a Customize > Connectors, busca AdmCloud y pulsa Connect para iniciar sesión con su propio usuario de AdmCloud.
Usarlo en una conversación
Pulsa el botón + abajo a la izquierda del cuadro de mensaje, entra a Connectors y activa AdmCloud. Claude puede pedirte que apruebes cada herramienta la primera vez que la usa; te recomendamos mantener esa aprobación para las herramientas que crean, editan o borran.
Claude Code
En la terminal, ejecuta:
claude mcp add --transport http admcloud https://mcp.admcloud.net/mcpLuego, dentro de Claude Code, escribe /mcp, elige admcloud y completa el inicio de sesión en el navegador.
Configurarlo en Codex
La aplicación de escritorio, la línea de comandos (CLI) y la extensión para el editor de Codex comparten la misma configuración, así que basta con agregarlo una vez.
Desde la línea de comandos
- Agrega el servidor:
codex mcp add admcloud --url https://mcp.admcloud.net/mcp - Inicia sesión (se abre el navegador con la página de AdmCloud):
codex mcp login admcloud
Desde el archivo de configuración
Si prefieres editar la configuración a mano, agrega esto a ~/.codex/config.toml y luego ejecuta codex mcp login admcloud:
[mcp_servers.admcloud]
url = "https://mcp.admcloud.net/mcp"Desde la aplicación o la extensión del editor
Agrega un servidor MCP con la misma URL desde la configuración de MCP y pulsa Authenticate cuando te pida iniciar sesión.
Otros asistentes
Cualquier aplicación compatible con servidores MCP remotos (transporte Streamable HTTP) con inicio de sesión OAuth puede conectarse con la misma URL, https://mcp.admcloud.net/mcp. El registro del cliente es automático: no necesitas pedir ningún identificador ni clave de aplicación.
Ejemplos de preguntas
Ventas y clientes
- "¿Cuánto vendimos este año, mes por mes? Muéstralo en un gráfico."
- "¿Quiénes son mis 10 mejores clientes de 2026 y cuánto le vendimos a cada uno?"
- "¿Cuál es el saldo pendiente de Distribuidora Caribe y cuánto tiene vencido?"
- "Dame la antigüedad de cuentas por cobrar y dime a quién debería llamar primero."
- "¿Cuáles oportunidades llevan tiempo sin que las contactemos?"
Finanzas y contabilidad
- "¿Cuánto efectivo tenemos disponible en cada banco?"
- "Muéstrame el estado de resultados de septiembre y compáralo con agosto."
- "¿Cuáles fueron los 10 gastos más grandes de este año?"
- "¿Cuánto le debemos a proveedores y qué está vencido?"
- "Dame la balanza de comprobación del trimestre."
Inventario y proyectos
- "¿Qué artículos están por debajo del punto de reorden?"
- "¿Cuántas unidades del artículo LAP-001 hay en el almacén principal?"
- "Dame el resumen del proyecto Torre Sur: presupuesto contra lo real."
Registrar información (requiere el permiso de agregar y editar)
- "Crea el cliente Ferretería El Puerto con el RNC 101234567 y condición de pago 30 días."
- "Hazle una cotización a Ferretería El Puerto de 20 unidades del artículo TAL-500."
- "Registra un anticipo de 15,000 de Distribuidora Caribe recibido en la cuenta del Banco Popular."
- "Pide vacaciones para mí del 3 al 7 de noviembre."
Personal y autorizaciones
- "¿Quién está ausente hoy?"
- "¿Cuántos días de vacaciones me quedan?"
- "¿Cuántos pedidos, órdenes de compra y pagos están esperando autorización?"
Reportes personalizados (requiere el permiso "Personalización")
- "Ayúdame a crear un SQL para un reporte de clientes agrupado por vendedor."
- "Necesito un reporte de ventas por artículo con filtro de fechas para pegarlo en Reportes Personalizados."
- "¿En qué tabla y campo se guarda el vendedor de una factura?"
Herramientas disponibles
Estas son las herramientas que el MCP ofrece hoy, agrupadas por área. No necesitas llamarlas por su nombre: el asistente elige la adecuada según lo que le pidas. La lista completa, con la descripción y los parámetros de cada una, está siempre actualizada en https://mcp.admcloud.net/.
| Área | Consultar | Agregar y editar | Borrar |
|---|---|---|---|
| Sesión e identidad | who_am_i, get_current_context, list_companies, select_company, list_user_groups, select_user_group, get_company_name, get_default_currency | — | — |
| Ventas (reportes) | get_sales, get_monthly_sales, get_top10_sales_by_customer, get_top10_sales_by_item, get_sales_for_customer, get_sales_by_sales_rep, get_sales_by_item_class, get_monthly_collections | — | — |
| Clientes | search_customers, get_customer_info, get_customer_balance, get_aged_receivables | create_customer, update_customer | delete_customer |
| Contactos | search_contacts, get_contact, get_contact_info | create_contact, update_contact | delete_contact |
| Oportunidades (CRM) | search_opportunities, get_opportunity, get_opportunities_to_contact | create_opportunity | delete_opportunity |
| Cotizaciones | search_quotes, get_quote | create_quote | delete_quote |
| Pedidos | search_sales_orders, get_sales_order, get_pending_sales_orders_to_authorize | create_sales_order | delete_sales_order |
| Facturas a crédito | search_invoices, get_invoice | create_invoice | delete_invoice |
| Ventas al contado | search_sales_receipts, get_sales_receipt | create_sales_receipt | delete_sales_receipt |
| Notas de crédito a clientes | search_credit_memos, get_credit_memo | create_credit_memo | delete_credit_memo |
| Cobros y anticipos de clientes | search_payments, get_payment, get_pending_payments_to_authorize | create_payment | delete_payment |
| Proveedores | search_vendors, get_vendor_info, get_vendor_balance, get_aged_payables | create_vendor, update_vendor | delete_vendor |
| Órdenes de compra | search_purchase_orders, get_purchase_order, get_pending_purchase_orders_to_authorize | create_purchase_order | delete_purchase_order |
| Facturas de proveedor | search_bills, get_bill | create_bill | delete_bill |
| Notas de crédito de proveedor | search_vendor_credits, get_vendor_credit | create_vendor_credit | delete_vendor_credit |
| Pagos y anticipos a proveedores | search_bill_payments, get_bill_payment | create_bill_payment | delete_bill_payment |
| Bancos y efectivo | get_available_cash_in_bank, get_available_cash_by_bank, get_current_loans, search_deposits, get_deposit, search_transfers, get_transfer | create_deposit, create_transfer | delete_deposit, delete_transfer |
| Contabilidad | get_results, get_results_by_month, get_balance_sheet, get_trial_balance, get_general_ledger, search_journals, search_accounts, get_account, get_account_balance, get_account_movement, get_expenses_by_month, get_expenses_by_month_for_account, get_top10_expenses_by_account | create_account | delete_account |
| Artículos e inventario | search_items, get_item, get_item_stock, get_items_low_stock | create_item, update_item | delete_item |
| Servicios | search_services, get_service | create_service, update_service | delete_service |
| Kits | search_kits, get_kit | create_kit, update_kit | delete_kit |
| Clases de artículos | search_item_classes, get_item_class | create_item_class | delete_item_class |
| Proyectos | search_projects, get_project, get_project_summary | create_project, update_project | delete_project |
| Solicitudes de servicio | search_service_requests, get_service_request | create_service_request, update_service_request, change_service_request_status | delete_service_request |
| Órdenes de servicio | search_service_orders, get_service_order | create_service_order, update_service_order, change_service_order_billing_authorization, void_service_order | delete_service_order |
| Empleados | get_employees, who_is_out_today | create_employee, update_employee | delete_employee |
| Vacaciones y ausencias | get_my_vacation_days | register_time_off | delete_time_off (solo tus propias solicitudes) |
| Reportes personalizados (SQL) | get_sql_report_guide, get_sql_report_samples, list_data_dictionary_tables, search_data_dictionary, describe_data_dictionary_tables, validate_sql_report_query | — | — |
| Catálogos | search_departments, get_department, search_payment_terms, get_payment_term, search_tax_codes, get_tax_code | create_department, create_payment_term | delete_department, delete_payment_term |
Qué debes saber
- Todo queda registrado con tu usuario. Lo que el MCP crea, modifica o borra aparece en la bitácora de AdmCloud a tu nombre, igual que si lo hubieras hecho desde la pantalla.
- Se aplican las mismas validaciones de AdmCloud. Numeración fiscal, impuestos, precios y documentos vinculados se validan igual que en el sistema. Por ejemplo, no se puede borrar un cliente que tiene transacciones ni una factura que ya tiene pagos aplicados.
- Los documentos se crean con una sola línea. Las herramientas que crean cotizaciones, pedidos, facturas, notas de crédito, facturas de proveedor y órdenes de compra registran un artículo con su cantidad. Para documentos de varias líneas, créalo con el MCP y complétalo en AdmCloud, o regístralo directamente en la pantalla.
- Los cobros y pagos se registran como anticipos, sin aplicarlos a facturas específicas. La aplicación a facturas se hace en AdmCloud.
- Enlaces a AdmCloud: los documentos que encuentra el asistente (facturas, pedidos, pagos, oportunidades) traen su enlace. Al abrirlo entras a ese documento en AdmCloud, con tu sesión del navegador.
- Tu sesión dura hasta 30 días. Pasado ese tiempo, o si desconectas el conector, el asistente te pide iniciar sesión de nuevo.
- SQL para Reportes Personalizados: el asistente consulta el diccionario de datos de tu empresa (tablas, campos, relaciones y tus campos personalizados) para escribir el SQL y lo valida contra tu base de datos sin ejecutarlo. El MCP no crea el reporte: copia el SQL en Reportes Personalizados y crea ahí los filtros que el asistente te indique. Requiere el permiso "Personalización" del grupo de usuarios.
- Errores inesperados: si una herramienta falla por un problema técnico (no por una regla del sistema), el asistente te muestra una referencia del tipo MCP-20261013-143512-9F2A31 y el equipo de AdmCloud recibe el aviso automáticamente. Si contactas a soporte, menciona esa referencia.
- La IA puede equivocarse. Revisa las cifras importantes antes de tomar decisiones y, antes de aprobar una acción que crea, edita o borra, confirma que los datos (cliente, artículo, monto, fecha) son los correctos. Los borrados no se pueden deshacer.
Consejos y errores comunes
Empieza preguntando "¿en qué empresa y grupo estoy?". Así confirmas sobre qué empresa va a trabajar el asistente antes de pedirle algo, sobre todo si tienes acceso a varias empresas.
Da los nombres tal como están en AdmCloud. El MCP busca clientes, artículos y cuentas por nombre o código. Si hay varias coincidencias, el asistente te muestra las opciones para que elijas.
"El MCP no tiene permitido agregar o editar información". El grupo de usuarios con el que estás trabajando no tiene marcada la opción Permitir que el MCP agregue y edite información (o la de borrar). Pide a un administrador que la marque en Grupos de Usuarios, o cámbiate a otro grupo que la tenga: "usa el grupo Contabilidad".
"No hay una empresa seleccionada". Tienes acceso a varias empresas y aún no elegiste una. Pídele al asistente que te muestre tus empresas y elige la que quieres usar.
No puedo iniciar sesión. El inicio de sesión del MCP usa tu mismo usuario de AdmCloud. Si tu clave venció, la bloqueaste por intentos fallidos o tu usuario está bloqueado, primero resuélvelo entrando a AdmCloud (o con la opción de cambiar la clave) y luego vuelve a conectar el asistente.