@comando.one/mcp-server 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @comando.one/mcp-server
2
2
 
3
- Servidor **MCP (Model Context Protocol)** para a API pública do **Comando.One**. Conecte o Claude (Desktop, Code ou qualquer cliente MCP) ao seu ERP e **opere tudo por linguagem natural**: clientes, propostas, contratos, faturas, cobranças Pix/boleto, NFS-e, contas a pagar, financeiro e webhooks.
3
+ Servidor **MCP (Model Context Protocol)** para a API pública do **Comando1**. Conecte o Claude (Desktop, Code ou qualquer cliente MCP) ao seu ERP e **opere tudo por linguagem natural**: clientes, propostas, contratos, faturas, cobranças Pix/boleto, NFS-e, contas a pagar, financeiro e webhooks.
4
4
 
5
5
  ## Instalação rápida (Claude Desktop)
6
6
 
@@ -51,13 +51,13 @@ Ambos expõem o **mesmo conjunto de ferramentas** (131 curadas + `lookups` + `co
51
51
 
52
52
  ## Como funciona
53
53
 
54
- - **134 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`/`invoices_delete`, `charges_create`, `nfse_emit`, `payouts_create`, `contracts_pause`/`contracts_resume`, `service_categories_create`, `reports_aging_actions`/`reports_cashflow_forecast`, `audit_timeline`, `documents_analyze` (lê boleto/guia/NF anexada e extrai valor, vencimento e emitente), `cost_centers_create`, `invoices_settle_charge` (dá baixa numa parcela — registra o recebimento), etc.
54
+ - **136 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`/`invoices_delete`, `charges_create`, `nfse_emit`, `payouts_create`, `contracts_pause`/`contracts_resume`, `service_categories_create`, `reports_aging_actions`/`reports_cashflow_forecast`, `audit_timeline`, `documents_analyze` (lê boleto/guia/NF anexada e extrai valor, vencimento e emitente), `cost_centers_create`, `invoices_settle_charge` (dá baixa numa parcela — registra o recebimento), etc.
55
55
  - **`comando_request`** — escape hatch genérico (`method`, `path`, `query`, `body`) que cobre 100% dos endpoints restantes.
56
56
  - **`lookups`** — catálogos read-only (centros de custo, condições/métodos de pagamento, naturezas, contas bancárias).
57
57
  - **`whoami`** — identidade, empresas acessíveis e scopes da chave.
58
58
  - **Nomes em português** — cada tool viaja com `title` (e `annotations.title`) vindo do
59
59
  `summary` da OpenAPI, então o cliente mostra "Listar clientes" em vez de "Customers list".
60
- O servidor também se identifica com `title` ("Comando.One"), `description`, `websiteUrl` e
60
+ O servidor também se identifica com `title` ("Comando1"), `description`, `websiteUrl` e
61
61
  `icons` (SEP-973). Clientes que ainda não leem esses campos caem no nome técnico sem quebrar.
62
62
 
63
63
  ### Segurança
package/dist/index.js CHANGED
@@ -1433,9 +1433,9 @@ var COMMON_ERRORS = {
1433
1433
  var OPENAPI_SPEC = {
1434
1434
  openapi: "3.1.0",
1435
1435
  info: {
1436
- title: "Comando.One API",
1436
+ title: "Comando1 API",
1437
1437
  version: "1.1.0",
1438
- description: "API REST p\xFAblica do Comando.One \u2014 ERP SaaS para empresas de servi\xE7o brasileiras.\n\nAutentique com uma API key no header `x-api-key` ou `Authorization: Bearer <key>`.\n\n**Idempot\xEAncia:** envie o header `Idempotency-Key` (string \xFAnica) em requisi\xE7\xF5es POST. Repeti\xE7\xF5es com a mesma chave retornam a resposta original (header `Idempotent-Replayed: true`), evitando cobran\xE7as/pagamentos duplicados em caso de retry.\n\n**Rate limit:** 60 requisi\xE7\xF5es/minuto por chave (429 ao exceder).\n\n**Multi-empresa:** chaves podem ter acesso a v\xE1rias empresas. Use `GET /v1/companies` para list\xE1-las e o header `X-Company-Id` para escolher o tenant de cada request (omitido = empresa padr\xE3o da chave).\n\nGere sua chave em **Configura\xE7\xF5es \u2192 API Keys** dentro da plataforma.",
1438
+ description: "API REST p\xFAblica do Comando1 \u2014 ERP SaaS para empresas de servi\xE7o brasileiras.\n\nAutentique com uma API key no header `x-api-key` ou `Authorization: Bearer <key>`.\n\n**Idempot\xEAncia:** envie o header `Idempotency-Key` (string \xFAnica) em requisi\xE7\xF5es POST. Repeti\xE7\xF5es com a mesma chave retornam a resposta original (header `Idempotent-Replayed: true`), evitando cobran\xE7as/pagamentos duplicados em caso de retry.\n\n**Rate limit:** 60 requisi\xE7\xF5es/minuto por chave (429 ao exceder).\n\n**Multi-empresa:** chaves podem ter acesso a v\xE1rias empresas. Use `GET /v1/companies` para list\xE1-las e o header `X-Company-Id` para escolher o tenant de cada request (omitido = empresa padr\xE3o da chave).\n\nGere sua chave em **Configura\xE7\xF5es \u2192 API Keys** dentro da plataforma.",
1439
1439
  contact: { email: "contato@comando.one", url: "https://comando.one" },
1440
1440
  license: { name: "Propriet\xE1rio" }
1441
1441
  },
@@ -3959,7 +3959,7 @@ function buildRequestTool(api) {
3959
3959
  return {
3960
3960
  name: "comando_request",
3961
3961
  title: "Chamada livre \xE0 API",
3962
- description: "Chamada gen\xE9rica \xE0 API do Comando.One (cobre qualquer endpoint /v1/*). Use quando n\xE3o houver uma tool espec\xEDfica. Ex.: method=GET, path=/webhooks/deliveries. Os scopes da chave s\xE3o validados pelo servidor.",
3962
+ description: "Chamada gen\xE9rica \xE0 API do Comando1 (cobre qualquer endpoint /v1/*). Use quando n\xE3o houver uma tool espec\xEDfica. Ex.: method=GET, path=/webhooks/deliveries. Os scopes da chave s\xE3o validados pelo servidor.",
3963
3963
  inputSchema: {
3964
3964
  type: "object",
3965
3965
  required: ["method", "path"],
@@ -4089,7 +4089,7 @@ function buildWhoamiTool(api) {
4089
4089
 
4090
4090
  // src/branding.ts
4091
4091
  var MCP_SERVER_NAME = "comando-one";
4092
- var MCP_SERVER_TITLE = "Comando.One";
4092
+ var MCP_SERVER_TITLE = "Comando1";
4093
4093
  var MCP_SERVER_VERSION = "0.5.0";
4094
4094
  var MCP_SERVER_DESCRIPTION = "ERP das empresas de servi\xE7o brasileiras: clientes, propostas, contratos, faturas, cobran\xE7as Pix e boleto, NFS-e, contas a pagar e financeiro.";
4095
4095
  var MCP_SERVER_WEBSITE = "https://comando.one";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.7.0",
4
- "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando.One — opere seu ERP por linguagem natural.",
3
+ "version": "0.8.0",
4
+ "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "type": "module",
6
6
  "license": "MIT",
7
7
  "bin": {