Servidor MCP

Nordlet ofrece el Model Context Protocol en https://api.nordlet.com/mcp. Un asistente de inteligencia artificial conectado a este servidor puede buscar en la API, leer el esquema de solicitud de cualquier operación y ejecutarla utilizando la misma clave de API, empresa y permisos (scopes) que una solicitud directa. Cada llamada a una herramienta es una solicitud de API ordinaria: se autentica, se le aplica limitación de tasa (rate limiting) y se contabiliza como tal, y cualquier llamada que modifique datos alterará la contabilidad de la empresa.

Conexión

El punto de conexión (endpoint) utiliza HTTP transmisible (Streamable HTTP) y se autentica mediante la clave de API Bearer obtenida en la guía Primeros pasos. En Claude Code:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

Cualquier otro cliente MCP requiere la misma URL y cabecera. Una clave restringida al permiso *:read solo podrá ejecutar operaciones de lectura; las herramientas informarán sobre la falta de permisos devolviendo el error 403 de la API.

Herramientas

Tres herramientas cubren todas las operaciones de la API:

Herramienta	Qué hace
search_operations	Encuentra operaciones mediante palabras clave en su nombre, ruta, resumen o descripción, opcionalmente dentro de un módulo específico (sales, bank, reports, ...). Si no se incluye una consulta, muestra la lista de módulos.
describe_operation	Devuelve el método, la ruta, la descripción y el esquema de solicitud JSON de una operación; el parámetro includeResponse: true añade el esquema de la respuesta 200.
call_operation	Ejecuta una operación con un cuerpo JSON. El cuerpo de la respuesta se devuelve en formato JSON; si se recibe una respuesta 4xx o 5xx, esta se devuelve como un error de la herramienta que incluye el código de estado y el sobre de error. Se puede enviar un parámetro opcional idempotencyKey en la cabecera Idempotency-Key, de modo que una llamada repetida con la misma clave devuelva la primera respuesta en lugar de duplicar el efecto.

Las operaciones más utilizadas también están disponibles como herramientas directas con sus propios esquemas de solicitud, lo que permite al asistente ver sus campos sin necesidad de consultas previas: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary y reports_debt_aging. Cada herramienta incluye las anotaciones de MCP (readOnlyHint, destructiveHint) que indican al cliente si realiza operaciones de escritura.

El índice de operaciones y los esquemas se generan a partir de la misma descripción OpenAPI que la Referencia de la API y los SDK, por lo que cualquier operación que se añada a la API aparecerá en search_operations junto con la versión que la incorpore. Las instrucciones del servidor recuerdan al asistente las convenciones vigentes: los importes se expresan como cadenas de texto decimales, los listados aceptan los parámetros page, pageSize, sort y filter, y las declaraciones fiscales específicas de un país devuelven el código 422 si se intentan aplicar a una empresa ubicada fuera de dicho país.