Dinaup DocsServidor MCP
Conecta un asistente de IA a los datos de tu empresa con el servidor MCP de Dinaup: la URL, la clave, las herramientas, la escritura en dos pasos y los límites.
Cada empresa tiene su servidor MCP (Model Context Protocol). Un asistente de IA conectado a él consulta tus secciones e informes y, con tu visto bueno, crea y modifica registros. Trabaja como el empleado de una clave API y con sus permisos.
| Servidor | URL | Para qué |
|---|---|---|
| Datos | https://<clave-de-conexion>.dinaup.io/mcp | Consultar, crear y modificar registros, vender y conciliar movimientos bancarios. |
| Estructura | https://<clave-de-conexion>.dinaup.io/mcp-flex | Leer y cambiar secciones, campos, informes, documentos dinámicos, scripts y algoritmos, como en FlexHub. |
Van separados para que un asistente que solo consulta datos no vea nunca herramientas que cambian la estructura.
Antes de empezar
- Una clave API con secreto, Compatible WebHook marcado y Empleado por defecto: Claves API.
- El token Bearer de esa clave, que se copia en la tarjeta Cómo conectar: El token Bearer.
- Un cliente MCP que envíe una cabecera
Authorizationfija. El servidor no tiene OAuth: un conector que solo admite OAuth no conecta.
Conectar
claude mcp add --transport http dinaup https://<clave-de-conexion>.dinaup.io/mcp \
--header "Authorization: Bearer <token>"Para probar la conexión sin cliente:
curl -X POST "https://<clave-de-conexion>.dinaup.io/mcp" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Qué puede ver y hacer el asistente
- Actúa como el Empleado por defecto de la clave. Lo que ese empleado no ve por su rol, el asistente tampoco.
- Si la clave limita secciones, solo ve esas. Una clave de Solo lectura solo lee.
- Nunca tiene permisos totales, y en las consultas no ve contraseñas ni campos confidenciales.
- No borra registros ni genera documentos dinámicos.
- Respeta la lista de IPs y los límites de la clave: Uso de la API.
Para dar a un asistente solo lo que necesita, crea una clave para él con sus secciones en Leer o Leer y escribir.
Herramientas del servidor de datos
| Herramienta | Qué hace |
|---|---|
describe | Lista las secciones con datos que puede leer. Con search, busca también secciones vacías e informes por su título. |
describe_section | Los campos de una sección con su tipo, las opciones de cada enum, sus relaciones, su sección de líneas y sus informes. |
query | Consulta una sección: campos, filtros, agrupaciones y funciones (sum, count, avg, min, max, month, year, quarter…). |
describe_report | Las columnas y las variables de un informe. |
run_report | Una página de un informe, con sus variables. No admite filtros ni orden. |
write | Prepara la creación o el cambio de hasta 25 registros de una sección. No guarda. |
sell | Prepara una venta nueva con hasta 25 líneas a partir de lo que dijo el usuario. No guarda. |
reconcile | Prepara la conciliación de un movimiento bancario con una venta, una compra, un cobro, un pago u otro movimiento. No guarda. |
confirm | Guarda lo que preparó write, sell o reconcile, con su código. |
El asistente recibe al conectar las instrucciones de uso. No hace falta explicarle las herramientas en tu prompt.
Reglas de las consultas
querydevuelve 50 filas por llamada y admite hasta 500. Simore_may_existestrue, hay más: pide la página siguiente o agrupa.- Un campo de una sección relacionada se pide por ruta:
<campo_relación>.<related_section_id>.<campo>. - Los registros eliminados no salen. Los archivados tampoco, salvo con
include_archived. - Las fechas se devuelven y se filtran en UTC. Las funciones de fecha agrupan en la zona horaria de la empresa.
- Una sección con
query=falsese lee por sus informes: el rol del empleado solo ve parte de ella.
Escribir en dos pasos
Ninguna herramienta guarda a la primera.
El asistente prepara el cambio
write, sell o reconcile validan los datos y devuelven lo que se va a crear o cambiar, con el valor de antes, y un código de confirmación.
Tú lo apruebas
El asistente te enseña el resumen. Si sell tiene dudas (qué cliente, qué producto), te las pregunta antes.
El asistente confirma
confirm guarda con el código. El código vale una vez y caduca a los 10 minutos. Repetir la llamada devuelve el mismo resultado sin volver a escribir.
Los registros se guardan uno a uno, con los scripts de la sección, como al guardar en Play. Si uno falla, los demás quedan guardados y confirm dice cuál.
Herramientas del servidor de estructura
| Herramienta | Qué hace |
|---|---|
list_objects, get_object | Lista los objetos de un tipo y enseña uno con todos sus valores. |
describe_type | Qué se puede cambiar en un tipo y qué pide su alta. |
enum_values | Las opciones de un enum. |
script_functions, script_routes | Las funciones y las rutas que se escriben en un script o un documento. |
validate_code | Comprueba sin guardar un script, un algoritmo o un documento dinámico. |
filter_operators | Lo que se puede preguntar a un campo en el filtro de un informe. |
prepare | Prepara crear, cambiar, borrar o recuperar un objeto, colocar los campos de una ficha o consolidar. Admite hasta 25 cambios con un solo código. No guarda. |
confirm | Guarda lo que preparó prepare. Si alguien cambió el objeto entre medias, no escribe. |
Una clave que limita secciones no entra en este servidor.
Errores
| Respuesta | Qué significa |
|---|---|
401 con WWW-Authenticate: Bearer | El token falta, tiene mal formato o no corresponde a ninguna clave. |
404 en /.well-known/oauth-…, /register, /authorize o /token | El cliente intenta OAuth. Configura la cabecera Authorization fija. |
405 | El servidor solo atiende POST. No abre flujo de eventos por GET. |
400 con error -32600 | El cuerpo lleva varios mensajes. Envía uno por petición. |
Resultado con isError | La herramienta rechazó la llamada. El texto dice el motivo y el asistente lo usa para corregirla. |
El protocolo es MCP por HTTP sin estado, en sus versiones 2025-11-25, 2025-06-18 y 2025-03-26.