MCP 服务器

Nordlet 在 https://api.nordlet.com/mcp 提供 Model Context Protocol 服务。连接到该服务的 AI 助手可以搜索 API、读取任何操作的请求架构（schema）并调用它，且使用与直接请求相同的 API key、公司和权限范围（scope）。每一次工具调用都是普通的 API 请求：它像普通请求一样经过身份验证、速率限制和计量，并且修改操作会更改公司的账目。

连接

该端点使用流式 HTTP（Streamable HTTP），并通过来自快速入门的 Bearer API 密钥进行身份验证。在 Claude Code 中：

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

任何其他 MCP 客户端都使用相同的 URL 和标头。权限范围限定为 *:read 的密钥只能调用只读操作；如果权限不足，工具会将错误报告为 API 的 403 错误。

工具

三个工具涵盖了 API 的所有操作：

工具	功能
search_operations	根据名称、路径、摘要或描述中的关键词查找操作，也可在指定模块（sales、bank、reports 等）内查找。如果不带查询参数，则列出所有模块。
describe_operation	返回单个操作的方法、路径、描述和 JSON 请求架构；设置 includeResponse: true 可同时添加 200 响应的架构。
call_operation	使用 JSON 请求体运行单个操作。响应体以 JSON 形式返回；4xx 或 5xx 响应则作为工具错误返回，其中包含状态码和错误信封（error envelope）。可选的 idempotencyKey 会作为 Idempotency-Key 标头发送，因此使用相同密钥重复调用时会重放第一次的响应，而不会重复产生业务影响。

最常用的操作同时也是带有各自请求架构的独立工具，因此 AI 助手无需查询即可直接看到其字段：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 和 reports_debt_aging。每个工具都带有 MCP 注解（readOnlyHint、destructiveHint），用于向客户端告知该工具是否执行写入操作。

操作索引和架构是由与API 参考和 SDK 相同的 OpenAPI 描述生成的，因此新增到 API 的操作会随着其发布版本同步出现在 search_operations 中。服务器的指令会提醒 AI 助手注意相关约定：金额为十进制字符串，列表支持 page、pageSize、sort 和 filter 参数，并且针对特定国家的申报，如果公司不在该国内则会返回 422 错误。