@comando.one/mcp-server 0.15.0 → 0.16.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/dist/index.js +60 -3
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -151,6 +151,8 @@ var MANIFEST = [
|
|
|
151
151
|
{ operationId: "listChargePayments", tool: "invoices_list_charge_payments" },
|
|
152
152
|
{ operationId: "reverseChargePayment", tool: "invoices_reverse_payment", write: true, destructive: true },
|
|
153
153
|
{ operationId: "generateContractInvoices", tool: "contracts_generate_invoices", write: true },
|
|
154
|
+
{ operationId: "getContractPixAutomatico", tool: "contracts_pix_automatico_get" },
|
|
155
|
+
{ operationId: "createContractPixAutomaticoLink", tool: "contracts_pix_automatico_link", write: true },
|
|
154
156
|
// ----- Cobranças -----
|
|
155
157
|
{ operationId: "listCharges", tool: "charges_list" },
|
|
156
158
|
{ operationId: "getCharge", tool: "charges_get" },
|
|
@@ -529,6 +531,32 @@ var SCHEMAS = {
|
|
|
529
531
|
content: { type: "string" }
|
|
530
532
|
}
|
|
531
533
|
},
|
|
534
|
+
ContractPixAutomatico: {
|
|
535
|
+
type: "object",
|
|
536
|
+
description: "Autoriza\xE7\xE3o de Pix Autom\xE1tico de um contrato (d\xE9bito recorrente autorizado pelo pagador no app do banco).",
|
|
537
|
+
properties: {
|
|
538
|
+
contract_id: { type: "string", format: "uuid" },
|
|
539
|
+
banco: { type: ["string", "null"], enum: ["inter", "c6bank", null], description: "Banco da forma de cobran\xE7a do contrato. null = a forma n\xE3o \xE9 Pix Autom\xE1tico." },
|
|
540
|
+
apto: { type: "boolean", description: "O contrato cabe nas regras do Banco Central para Pix Autom\xE1tico." },
|
|
541
|
+
problemas: { type: "array", items: { type: "string" }, description: "O que impede o Pix Autom\xE1tico, em portugu\xEAs, quando apto = false." },
|
|
542
|
+
link: { type: ["string", "null"], description: "Link de autoriza\xE7\xE3o (https://comando.one/assinar/\u2026) para enviar ao pagador. null at\xE9 o POST criar." },
|
|
543
|
+
autorizacao: {
|
|
544
|
+
type: ["object", "null"],
|
|
545
|
+
description: "A autoriza\xE7\xE3o (Rec) mais recente. null enquanto o pagador n\xE3o abriu o link e pediu o QR Code.",
|
|
546
|
+
properties: {
|
|
547
|
+
id_rec: { type: "string", description: "Identificador da recorr\xEAncia no Banco Central." },
|
|
548
|
+
status: { type: "string", enum: ["CRIADA", "APROVADA", "REJEITADA", "CANCELADA", "EXPIRADA"] },
|
|
549
|
+
banco: { type: "string", enum: ["inter", "c6bank"] },
|
|
550
|
+
valor: { type: ["number", "null"], description: "Valor fixo autorizado por d\xE9bito, em reais." },
|
|
551
|
+
periodicidade: { type: ["string", "null"], enum: ["SEMANAL", "MENSAL", "TRIMESTRAL", "SEMESTRAL", "ANUAL", null] },
|
|
552
|
+
data_inicial: { type: ["string", "null"], format: "date", description: "1\xBA vencimento." },
|
|
553
|
+
data_final: { type: ["string", "null"], format: "date" },
|
|
554
|
+
criada_em: { type: "string", format: "date-time" },
|
|
555
|
+
atualizada_em: { type: "string", format: "date-time" }
|
|
556
|
+
}
|
|
557
|
+
}
|
|
558
|
+
}
|
|
559
|
+
},
|
|
532
560
|
Contract: {
|
|
533
561
|
type: "object",
|
|
534
562
|
properties: {
|
|
@@ -2615,7 +2643,7 @@ var OPENAPI_SPEC = {
|
|
|
2615
2643
|
operationId: "createContract",
|
|
2616
2644
|
security: [{ ApiKeyAuth: ["contracts:write"] }],
|
|
2617
2645
|
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractCreate" } } } },
|
|
2618
|
-
responses: { "201": { description: "Contrato criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
|
|
2646
|
+
responses: { "201": { description: "Contrato criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), "422": errorResponse("Forma Pix Autom\xE1tico com periodicidade, parcelas ou prazo de vencimento que o Banco Central n\xE3o aceita"), ...COMMON_ERRORS }
|
|
2619
2647
|
}
|
|
2620
2648
|
},
|
|
2621
2649
|
"/contracts/{id}": {
|
|
@@ -2637,7 +2665,7 @@ var OPENAPI_SPEC = {
|
|
|
2637
2665
|
operationId: "updateContract",
|
|
2638
2666
|
security: [{ ApiKeyAuth: ["contracts:write"] }],
|
|
2639
2667
|
requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractUpdate" } } } },
|
|
2640
|
-
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 }
|
|
2668
|
+
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"), "422": errorResponse("Forma Pix Autom\xE1tico com periodicidade, parcelas ou prazo de vencimento que o Banco Central n\xE3o aceita"), ...COMMON_ERRORS }
|
|
2641
2669
|
},
|
|
2642
2670
|
delete: {
|
|
2643
2671
|
tags: ["Contratos"],
|
|
@@ -2828,6 +2856,35 @@ var OPENAPI_SPEC = {
|
|
|
2828
2856
|
responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("H\xE1 registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
|
|
2829
2857
|
}
|
|
2830
2858
|
},
|
|
2859
|
+
"/contracts/{id}/pix-automatico": {
|
|
2860
|
+
parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
|
|
2861
|
+
get: {
|
|
2862
|
+
tags: ["Contratos"],
|
|
2863
|
+
summary: "Consultar a autoriza\xE7\xE3o de Pix Autom\xE1tico do contrato",
|
|
2864
|
+
operationId: "getContractPixAutomatico",
|
|
2865
|
+
description: "Estado do Pix Autom\xE1tico do contrato: banco da forma de cobran\xE7a (inter ou c6bank), se o contrato cabe nas regras do Banco Central (apto/problemas), a autoriza\xE7\xE3o (Rec) mais recente com o status (CRIADA = aguardando o pagador, APROVADA = d\xE9bitos liberados, REJEITADA/CANCELADA/EXPIRADA = encerrada) e o link de autoriza\xE7\xE3o, se j\xE1 existe. N\xE3o cria nada. As cobran\xE7as de cada ciclo saem em GET /v1/charges?channel=pix_automatico e o pagamento chega pelo webhook charge.paid.",
|
|
2866
|
+
security: [{ ApiKeyAuth: ["contracts:read"] }],
|
|
2867
|
+
responses: {
|
|
2868
|
+
"200": { description: "Estado do Pix Autom\xE1tico", content: { "application/json": { schema: { $ref: "#/components/schemas/ContractPixAutomatico" } } } },
|
|
2869
|
+
"404": errorResponse("Contrato n\xE3o encontrado"),
|
|
2870
|
+
...COMMON_ERRORS
|
|
2871
|
+
}
|
|
2872
|
+
},
|
|
2873
|
+
post: {
|
|
2874
|
+
tags: ["Contratos"],
|
|
2875
|
+
summary: "Gerar o link de autoriza\xE7\xE3o do Pix Autom\xE1tico",
|
|
2876
|
+
operationId: "createContractPixAutomaticoLink",
|
|
2877
|
+
description: "Devolve o link que o pagador abre para autorizar o d\xE9bito recorrente (/assinar): ele l\xEA os termos, recebe o QR Code e aprova no app do banco dele. Idempotente: se o contrato j\xE1 tem link ativo, devolve o mesmo. Recusa (422) se a forma de cobran\xE7a n\xE3o \xE9 Pix Autom\xE1tico ou se o contrato n\xE3o cabe nas regras do Banco Central (periodicidade semanal/mensal/trimestral/semestral/anual, uma parcela por ciclo, vencimento a 2+ dias da gera\xE7\xE3o), e (409) se o contrato n\xE3o est\xE1 ativo. Envie o link ao pagador pelo seu canal; depois acompanhe por GET at\xE9 autorizacao.status = APROVADA.",
|
|
2878
|
+
security: [{ ApiKeyAuth: ["contracts:write"] }],
|
|
2879
|
+
responses: {
|
|
2880
|
+
"200": { description: "Link de autoriza\xE7\xE3o e estado", content: { "application/json": { schema: { $ref: "#/components/schemas/ContractPixAutomatico" } } } },
|
|
2881
|
+
"404": errorResponse("Contrato n\xE3o encontrado"),
|
|
2882
|
+
"409": errorResponse("Contrato n\xE3o est\xE1 ativo"),
|
|
2883
|
+
"422": errorResponse("Forma de cobran\xE7a n\xE3o \xE9 Pix Autom\xE1tico ou contrato fora das regras do Banco Central"),
|
|
2884
|
+
...COMMON_ERRORS
|
|
2885
|
+
}
|
|
2886
|
+
}
|
|
2887
|
+
},
|
|
2831
2888
|
"/contracts/{id}/generate-invoices": {
|
|
2832
2889
|
parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
|
|
2833
2890
|
post: {
|
|
@@ -5663,7 +5720,7 @@ function buildWhoamiTool(api) {
|
|
|
5663
5720
|
// src/branding.ts
|
|
5664
5721
|
var MCP_SERVER_NAME = "comando-one";
|
|
5665
5722
|
var MCP_SERVER_TITLE = "Comando1";
|
|
5666
|
-
var MCP_SERVER_VERSION = "0.
|
|
5723
|
+
var MCP_SERVER_VERSION = "0.16.0";
|
|
5667
5724
|
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.";
|
|
5668
5725
|
var MCP_SERVER_WEBSITE = "https://comando.one";
|
|
5669
5726
|
var MCP_SERVER_ICONS = [
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@comando.one/mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.16.0",
|
|
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",
|