@comando.one/mcp-server 0.12.1 → 0.12.3
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/dist/index.js +15 -8
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -416,7 +416,8 @@ var SCHEMAS = {
|
|
|
416
416
|
trade_name: { type: ["string", "null"] },
|
|
417
417
|
status: { type: "string" },
|
|
418
418
|
created_at: { type: "string", format: "date-time" },
|
|
419
|
-
updated_at: { type: "string", format: "date-time" }
|
|
419
|
+
updated_at: { type: "string", format: "date-time" },
|
|
420
|
+
addresses: { type: "array", items: { $ref: "#/components/schemas/CustomerAddress" }, description: "S\xF3 vem com ?include=addresses. Endere\xE7o padr\xE3o primeiro; lista vazia = cliente sem endere\xE7o cadastrado." }
|
|
420
421
|
}
|
|
421
422
|
},
|
|
422
423
|
CustomerCreate: {
|
|
@@ -951,8 +952,8 @@ var SCHEMAS = {
|
|
|
951
952
|
type: "object",
|
|
952
953
|
required: ["name"],
|
|
953
954
|
properties: {
|
|
954
|
-
name: { type: "string" },
|
|
955
|
-
description: { type: "string" },
|
|
955
|
+
name: { type: "string", description: "Nome do item (exibi\xE7\xE3o). Na NFS-e s\xF3 \xE9 usado se `description` vier vazio." },
|
|
956
|
+
description: { type: "string", description: "Texto do item. \xC9 ele que comp\xF5e a discrimina\xE7\xE3o da NFS-e (uma linha por item)." },
|
|
956
957
|
unit: { type: "string", default: "un" },
|
|
957
958
|
quantity: { type: "number", default: 1 },
|
|
958
959
|
unit_price: { type: "number" },
|
|
@@ -1568,7 +1569,8 @@ var SCHEMAS = {
|
|
|
1568
1569
|
type: "object",
|
|
1569
1570
|
required: ["invoice_id"],
|
|
1570
1571
|
properties: {
|
|
1571
|
-
invoice_id: { type: "string", format: "uuid", description: "Fatura a partir da qual emitir a NFS-e" }
|
|
1572
|
+
invoice_id: { type: "string", format: "uuid", description: "Fatura a partir da qual emitir a NFS-e" },
|
|
1573
|
+
discriminacao: { type: "string", maxLength: 2e3, description: "Opcional. Texto integral da discrimina\xE7\xE3o do servi\xE7o (xDescServ) \u2014 substitui o montado dos itens. Nota autorizada n\xE3o se edita (s\xF3 cancela e reemite), ent\xE3o \xE9 aqui que se acerta o texto. Inclua o n\xFAmero da fatura se quiser que ele apare\xE7a. Sem o campo: n\xFAmero da fatura + a descri\xE7\xE3o de cada item." }
|
|
1572
1574
|
}
|
|
1573
1575
|
},
|
|
1574
1576
|
NfseCancel: {
|
|
@@ -1912,7 +1914,8 @@ var OPENAPI_SPEC = {
|
|
|
1912
1914
|
...PAGINATION_PARAMS,
|
|
1913
1915
|
{ name: "search", in: "query", schema: { type: "string" }, description: "Busca por nome, e-mail ou documento" },
|
|
1914
1916
|
{ name: "status", in: "query", schema: { type: "string" }, description: "Filtrar por status" },
|
|
1915
|
-
{ name: "type", in: "query", schema: { type: "string", enum: ["fisica", "juridica", "estrangeira"] }, description: "Filtrar por tipo de pessoa" }
|
|
1917
|
+
{ name: "type", in: "query", schema: { type: "string", enum: ["fisica", "juridica", "estrangeira"] }, description: "Filtrar por tipo de pessoa" },
|
|
1918
|
+
{ name: "include", in: "query", schema: { type: "string", enum: ["addresses"] }, description: "addresses = traz os endere\xE7os de cada cliente no campo `addresses` (1 chamada em vez de 1 por cliente)" }
|
|
1916
1919
|
],
|
|
1917
1920
|
responses: {
|
|
1918
1921
|
"200": paginatedResponse("#/components/schemas/Customer"),
|
|
@@ -1950,6 +1953,9 @@ var OPENAPI_SPEC = {
|
|
|
1950
1953
|
summary: "Obter cliente",
|
|
1951
1954
|
operationId: "getCustomer",
|
|
1952
1955
|
security: [{ ApiKeyAuth: ["customers:read"] }],
|
|
1956
|
+
parameters: [
|
|
1957
|
+
{ name: "include", in: "query", schema: { type: "string", enum: ["addresses"] }, description: "addresses = inclui os endere\xE7os do cliente no campo `addresses`" }
|
|
1958
|
+
],
|
|
1953
1959
|
responses: {
|
|
1954
1960
|
"200": { description: "Cliente", content: { "application/json": { schema: { $ref: "#/components/schemas/Customer" } } } },
|
|
1955
1961
|
"404": errorResponse("Cliente n\xE3o encontrado"),
|
|
@@ -2048,6 +2054,7 @@ var OPENAPI_SPEC = {
|
|
|
2048
2054
|
get: {
|
|
2049
2055
|
tags: ["Clientes"],
|
|
2050
2056
|
summary: "Listar endere\xE7os do cliente",
|
|
2057
|
+
description: "Funciona tamb\xE9m para cliente compartilhado com a sua empresa (somente leitura). Para os endere\xE7os de v\xE1rios clientes de uma vez, use GET /customers?include=addresses.",
|
|
2051
2058
|
operationId: "listCustomerAddresses",
|
|
2052
2059
|
security: [{ ApiKeyAuth: ["customers:read"] }],
|
|
2053
2060
|
responses: { "200": { description: "Endere\xE7os", content: { "application/json": { schema: { type: "object", properties: { data: { type: "array", items: { $ref: "#/components/schemas/CustomerAddress" } } } } } } }, "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
@@ -2380,7 +2387,7 @@ var OPENAPI_SPEC = {
|
|
|
2380
2387
|
tags: ["Faturas"],
|
|
2381
2388
|
summary: "Criar fatura",
|
|
2382
2389
|
operationId: "createInvoice",
|
|
2383
|
-
description: "Cria uma fatura. Se 'items' for enviado, o valor \xE9 calculado a partir deles.",
|
|
2390
|
+
description: "Cria uma fatura. Se 'items' for enviado, o valor \xE9 calculado a partir deles. O cliente pode ser da empresa **ou compartilhado com ela com permiss\xE3o de faturas = editor** (o dono configura em Clientes \u2192 Compartilhar). A fatura pertence a quem a lan\xE7a \u2014 financeiro, baixa e NFS-e s\xE3o dessa empresa; s\xF3 o cadastro do cliente \xE9 do dono. Cliente compartilhado s\xF3 para leitura devolve 404.",
|
|
2384
2391
|
security: [{ ApiKeyAuth: ["invoices:create"] }],
|
|
2385
2392
|
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InvoiceCreate" } } } },
|
|
2386
2393
|
responses: { "201": { description: "Fatura criada", content: { "application/json": { schema: { $ref: "#/components/schemas/Invoice" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
@@ -3149,7 +3156,7 @@ var OPENAPI_SPEC = {
|
|
|
3149
3156
|
tags: ["NFS-e"],
|
|
3150
3157
|
summary: "Emitir NFS-e",
|
|
3151
3158
|
operationId: "emitNfse",
|
|
3152
|
-
description: "Emite uma NFS-e a partir de uma fatura. O m\xE9todo (certificado/portal) vem da configura\xE7\xE3o da empresa. Pode levar alguns segundos.\n\n**Os itens da fatura N\xC3O precisam de `service_id`** \u2014 item avulso emite normalmente; a classifica\xE7\xE3o fiscal (cTribNac, cNBS, al\xEDquotas) vem da configura\xE7\xE3o fiscal da empresa e do CNAE padr\xE3o, n\xE3o do item.\n\nC\xF3digos: **201** = autorizada ou em transmiss\xE3o \u2014 o `id` devolvido \xE9 o mesmo `{id}` de `/v1/nfse/{id}`, `/files`, `/sync` e `/cancel`. **422 com `status: 'rejeitada'`** = o fisco REJEITOU (motivo em `message`) \u2014 n\xE3o existe nota, n\xE3o afirme ao usu\xE1rio que foi emitida. **422 sem `status`** = a EMPRESA n\xE3o est\xE1 configurada para emitir. **409** = esta fatura j\xE1 tem nota (o `error` traz o id da existente). **424** = o provedor fiscal falhou; o motivo dele vem em `error`.\n\nRetentativa \xE9 segura: mande o header `Idempotency-Key` (a mesma resposta volta, com `Idempotent-Replayed: true`), e mesmo sem ele o 409 impede uma segunda nota para a mesma fatura.",
|
|
3159
|
+
description: "Emite uma NFS-e a partir de uma fatura. O m\xE9todo (certificado/portal) vem da configura\xE7\xE3o da empresa. Pode levar alguns segundos.\n\n**Discrimina\xE7\xE3o do servi\xE7o (o texto que vai \xE0 prefeitura).** Por padr\xE3o \xE9 o n\xFAmero da fatura seguido, uma linha por item, do `description` de cada item \u2014 e, s\xF3 se o `description` estiver vazio, o `name`. Ou seja: com os dois preenchidos, o `name` \xE9 exibi\xE7\xE3o interna e N\xC3O chega ao documento fiscal. Para controlar o texto, mande `discriminacao` (at\xE9 2000 caracteres). Nota autorizada n\xE3o se edita: errou o texto, \xE9 cancelar e reemitir \u2014 por isso confira antes. Um 409 de nota anterior s\xF3 vale para nota `autorizada` ou `transmitindo`; fatura com nota **cancelada** pode ser emitida de novo.\n\n**Os itens da fatura N\xC3O precisam de `service_id`** \u2014 item avulso emite normalmente; a classifica\xE7\xE3o fiscal (cTribNac, cNBS, al\xEDquotas) vem da configura\xE7\xE3o fiscal da empresa e do CNAE padr\xE3o, n\xE3o do item.\n\nC\xF3digos: **201** = autorizada ou em transmiss\xE3o \u2014 o `id` devolvido \xE9 o mesmo `{id}` de `/v1/nfse/{id}`, `/files`, `/sync` e `/cancel`. **422 com `status: 'rejeitada'`** = o fisco REJEITOU (motivo em `message`) \u2014 n\xE3o existe nota, n\xE3o afirme ao usu\xE1rio que foi emitida. **422 sem `status`** = a EMPRESA n\xE3o est\xE1 configurada para emitir. **409** = esta fatura j\xE1 tem nota (o `error` traz o id da existente). **424** = o provedor fiscal falhou; o motivo dele vem em `error`.\n\nRetentativa \xE9 segura: mande o header `Idempotency-Key` (a mesma resposta volta, com `Idempotent-Replayed: true`), e mesmo sem ele o 409 impede uma segunda nota para a mesma fatura.",
|
|
3153
3160
|
security: [{ ApiKeyAuth: ["nfse:emitir"] }],
|
|
3154
3161
|
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/NfseEmit" } } } },
|
|
3155
3162
|
responses: { "201": { description: "Emiss\xE3o solicitada", content: { "application/json": { schema: { type: "object", properties: { id: { type: ["string", "null"], description: "Id da NFS-e \u2014 use em /v1/nfse/{id}, /files, /sync e /cancel. Mesmo valor de history_id." }, invoice_id: { type: "string" }, status: { type: "string", description: "autorizada | transmitindo | rejeitada" }, numero_nfse: { type: ["string", "null"] }, chave_acesso: { type: ["string", "null"] }, history_id: { type: ["string", "null"], description: "Alias de `id`, mantido por compatibilidade." }, message: { type: ["string", "null"] } } } } } }, "400": errorResponse("invoice_id ausente"), "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("A fatura j\xE1 tem NFS-e autorizada ou em transmiss\xE3o \u2014 o `error` traz o id da existente"), "402": errorResponse("Saldo insuficiente na carteira pr\xE9-paga (ou limite de gasto atingido) \u2014 nada foi transmitido. `code`: saldo_insuficiente | limite_de_gasto_atingido | carteira_inativa; recarregue em Cobran\xE7a da plataforma"), "422": errorResponse('Rejeitada pelo fisco (corpo traz `status: "rejeitada"` e `message`) OU empresa sem NFS-e configurada (corpo traz s\xF3 `error`)'), "424": errorResponse("O provedor de NFS-e falhou \u2014 o motivo dele vem em `error`"), ...COMMON_ERRORS }
|
|
@@ -4947,7 +4954,7 @@ function buildWhoamiTool(api) {
|
|
|
4947
4954
|
// src/branding.ts
|
|
4948
4955
|
var MCP_SERVER_NAME = "comando-one";
|
|
4949
4956
|
var MCP_SERVER_TITLE = "Comando1";
|
|
4950
|
-
var MCP_SERVER_VERSION = "0.12.
|
|
4957
|
+
var MCP_SERVER_VERSION = "0.12.3";
|
|
4951
4958
|
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.";
|
|
4952
4959
|
var MCP_SERVER_WEBSITE = "https://comando.one";
|
|
4953
4960
|
var MCP_SERVER_ICONS = [
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@comando.one/mcp-server",
|
|
3
|
-
"version": "0.12.
|
|
3
|
+
"version": "0.12.3",
|
|
4
4
|
"description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
|
|
5
5
|
"author": "Orbital Tecnologia e Desenvolvimento LTDA <contato@comando.one> (https://orbitaldev.com.br)",
|
|
6
6
|
"homepage": "https://comando.one",
|