@comando.one/mcp-server 0.12.0 → 0.12.1
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 +61 -10
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -561,6 +561,37 @@ var SCHEMAS = {
|
|
|
561
561
|
notes: { type: "string" }
|
|
562
562
|
}
|
|
563
563
|
},
|
|
564
|
+
// Schemas de ATUALIZAÇÃO: o PATCH reusava o de criação, que carrega `required` — o MCP
|
|
565
|
+
// derivava a tool de update exigindo `customer_id` em toda edição — e não dizia o que cada
|
|
566
|
+
// campo faz depois que o registro existe (trocar cliente, reagendar, anexar).
|
|
567
|
+
ProposalUpdate: {
|
|
568
|
+
type: "object",
|
|
569
|
+
description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio.",
|
|
570
|
+
properties: {
|
|
571
|
+
customer_id: { type: "string", format: "uuid", description: "Troca o cliente da proposta. Precisa ser cliente desta empresa (404 se n\xE3o for)." },
|
|
572
|
+
status: { type: "string", enum: ["rascunho", "enviada", "aceita", "recusada", "cancelada"] },
|
|
573
|
+
total_amount: { type: "number" },
|
|
574
|
+
valid_until: { type: ["string", "null"], format: "date" },
|
|
575
|
+
notes: { type: ["string", "null"] }
|
|
576
|
+
}
|
|
577
|
+
},
|
|
578
|
+
ContractUpdate: {
|
|
579
|
+
type: "object",
|
|
580
|
+
description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio. Itens e se\xE7\xF5es do contrato n\xE3o s\xE3o edit\xE1veis por esta rota.",
|
|
581
|
+
properties: {
|
|
582
|
+
customer_id: { type: "string", format: "uuid", description: "Troca o cliente do contrato. Precisa ser cliente desta empresa (404). Recusado com 409 se o contrato tem autoriza\xE7\xE3o de d\xE9bito recorrente ativa (cart\xE3o salvo ou Pix Autom\xE1tico) \u2014 ela \xE9 do pagador atual; revogue-a antes. Faturas j\xE1 geradas continuam no cliente antigo." },
|
|
583
|
+
title: { type: ["string", "null"] },
|
|
584
|
+
status: { type: "string", enum: ["ativo", "suspenso", "cancelado", "finalizado"] },
|
|
585
|
+
frequency: { type: "string", enum: ["semanal", "quinzenal", "mensal", "bimestral", "trimestral", "semestral", "anual"] },
|
|
586
|
+
start_date: { type: "string", format: "date" },
|
|
587
|
+
end_date: { type: ["string", "null"], format: "date" },
|
|
588
|
+
due_days: { type: "integer" },
|
|
589
|
+
amount: { type: "number" },
|
|
590
|
+
payment_method_id: { type: ["string", "null"], format: "uuid" },
|
|
591
|
+
next_generation_date: { type: "string", format: "date", description: "Reagenda a pr\xF3xima gera\xE7\xE3o de fatura (rodada di\xE1ria das 03:00). S\xF3 hoje (fuso de Bras\xEDlia) em diante: data no passado \xE9 400, porque o gerador emitiria de uma vez uma fatura por ciclo atrasado. Para gerar um ciclo agora use POST /contracts/{id}/generate-invoices." },
|
|
592
|
+
notes: { type: ["string", "null"] }
|
|
593
|
+
}
|
|
594
|
+
},
|
|
564
595
|
ContractReadjustment: {
|
|
565
596
|
type: "object",
|
|
566
597
|
description: "Reajuste aplicado a um contrato (specs/reajustes/).",
|
|
@@ -833,6 +864,27 @@ var SCHEMAS = {
|
|
|
833
864
|
}
|
|
834
865
|
}
|
|
835
866
|
},
|
|
867
|
+
ExpenseUpdate: {
|
|
868
|
+
type: "object",
|
|
869
|
+
description: "S\xF3 os campos enviados mudam. Ao menos um \xE9 obrigat\xF3rio (`attachment_ids` sozinho vale).",
|
|
870
|
+
properties: {
|
|
871
|
+
supplier_id: { type: "string", format: "uuid", description: "Troca o fornecedor. Precisa ser fornecedor desta empresa (404 se n\xE3o for)." },
|
|
872
|
+
description: { type: "string" },
|
|
873
|
+
amount: { type: "number" },
|
|
874
|
+
expense_date: { type: "string", format: "date" },
|
|
875
|
+
payment_date: { type: ["string", "null"], format: "date" },
|
|
876
|
+
category_id: { type: ["string", "null"], format: "uuid" },
|
|
877
|
+
status: { type: "string", enum: ["pendente", "pago", "cancelado"] },
|
|
878
|
+
bank_account_id: { type: ["string", "null"], format: "uuid" },
|
|
879
|
+
payment_method_id: { type: ["string", "null"], format: "uuid" },
|
|
880
|
+
notes: { type: ["string", "null"] },
|
|
881
|
+
attachment_ids: {
|
|
882
|
+
type: "array",
|
|
883
|
+
items: { type: "string", format: "uuid" },
|
|
884
|
+
description: "ACRESCENTA anexos j\xE1 enviados \xE0 despesa (n\xE3o substitui os atuais). Anexo que a despesa j\xE1 tem \xE9 ignorado, ent\xE3o repetir a chamada n\xE3o duplica. Id inexistente nesta empresa \u2192 404, sem gravar nada."
|
|
885
|
+
}
|
|
886
|
+
}
|
|
887
|
+
},
|
|
836
888
|
PurchaseInvoice: {
|
|
837
889
|
type: "object",
|
|
838
890
|
properties: {
|
|
@@ -974,7 +1026,7 @@ var SCHEMAS = {
|
|
|
974
1026
|
type: "object",
|
|
975
1027
|
required: ["url"],
|
|
976
1028
|
properties: {
|
|
977
|
-
name: { type: "string", description: "R\xF3tulo opcional" },
|
|
1029
|
+
name: { type: ["string", "null"], description: "R\xF3tulo opcional. No PUT /webhooks/payments, omitido preserva o r\xF3tulo atual; null apaga." },
|
|
978
1030
|
url: { type: "string", format: "uri", description: "Deve come\xE7ar com https://" },
|
|
979
1031
|
events: { type: "array", items: { type: "string", enum: WEBHOOK_EVENT_KEYS }, description: "Eventos assinados (default: charge.paid, charge.cancelled, charge.expired)" },
|
|
980
1032
|
active: { type: "boolean", default: true }
|
|
@@ -1280,8 +1332,7 @@ var SCHEMAS = {
|
|
|
1280
1332
|
pix_key_type: { type: "string", enum: ["cpf", "cnpj", "email", "phone", "random"] },
|
|
1281
1333
|
pix_copia_e_cola: { type: "string", description: "QR Pix copia e cola (EMV)" },
|
|
1282
1334
|
boleto_barcode: { type: "string" },
|
|
1283
|
-
scheduled_for: { type: "string", format: "date", description: "Data de agendamento (YYYY-MM-DD); omitir paga \xE0 vista" }
|
|
1284
|
-
description: { type: "string" }
|
|
1335
|
+
scheduled_for: { type: "string", format: "date", description: "Data de agendamento (YYYY-MM-DD); omitir paga \xE0 vista" }
|
|
1285
1336
|
}
|
|
1286
1337
|
},
|
|
1287
1338
|
SplitRuleRecipient: {
|
|
@@ -2116,8 +2167,8 @@ var OPENAPI_SPEC = {
|
|
|
2116
2167
|
summary: "Atualizar proposta",
|
|
2117
2168
|
operationId: "updateProposal",
|
|
2118
2169
|
security: [{ ApiKeyAuth: ["proposals:write"] }],
|
|
2119
|
-
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/
|
|
2120
|
-
responses: { "200": { description: "Proposta atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Proposal" } } } }, "404": errorResponse("Proposta n\xE3o
|
|
2170
|
+
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ProposalUpdate" } } } },
|
|
2171
|
+
responses: { "200": { description: "Proposta atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Proposal" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Proposta ou cliente n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
2121
2172
|
},
|
|
2122
2173
|
delete: {
|
|
2123
2174
|
tags: ["Propostas"],
|
|
@@ -2186,8 +2237,8 @@ var OPENAPI_SPEC = {
|
|
|
2186
2237
|
summary: "Atualizar contrato",
|
|
2187
2238
|
operationId: "updateContract",
|
|
2188
2239
|
security: [{ ApiKeyAuth: ["contracts:write"] }],
|
|
2189
|
-
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/
|
|
2190
|
-
responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "404": errorResponse("Contrato n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
2240
|
+
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractUpdate" } } } },
|
|
2241
|
+
responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Contrato ou cliente n\xE3o encontrado"), "409": errorResponse("Troca de cliente com autoriza\xE7\xE3o de d\xE9bito recorrente ativa"), ...COMMON_ERRORS }
|
|
2191
2242
|
},
|
|
2192
2243
|
delete: {
|
|
2193
2244
|
tags: ["Contratos"],
|
|
@@ -3299,8 +3350,8 @@ var OPENAPI_SPEC = {
|
|
|
3299
3350
|
summary: "Atualizar despesa",
|
|
3300
3351
|
operationId: "updateExpense",
|
|
3301
3352
|
security: [{ ApiKeyAuth: ["expenses:write"] }],
|
|
3302
|
-
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/
|
|
3303
|
-
responses: { "200": { description: "Despesa atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Expense" } } } }, "404": errorResponse("Despesa n\xE3o
|
|
3353
|
+
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ExpenseUpdate" } } } },
|
|
3354
|
+
responses: { "200": { description: "Despesa atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Expense" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Despesa, fornecedor ou anexo n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
3304
3355
|
},
|
|
3305
3356
|
delete: {
|
|
3306
3357
|
tags: ["Despesas"],
|
|
@@ -4896,7 +4947,7 @@ function buildWhoamiTool(api) {
|
|
|
4896
4947
|
// src/branding.ts
|
|
4897
4948
|
var MCP_SERVER_NAME = "comando-one";
|
|
4898
4949
|
var MCP_SERVER_TITLE = "Comando1";
|
|
4899
|
-
var MCP_SERVER_VERSION = "0.12.
|
|
4950
|
+
var MCP_SERVER_VERSION = "0.12.1";
|
|
4900
4951
|
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.";
|
|
4901
4952
|
var MCP_SERVER_WEBSITE = "https://comando.one";
|
|
4902
4953
|
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.1",
|
|
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",
|