@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 +3 -3
- package/dist/index.js +4 -4
- package/package.json +2 -2
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 **
|
|
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
|
-
- **
|
|
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` ("
|
|
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: "
|
|
1436
|
+
title: "Comando1 API",
|
|
1437
1437
|
version: "1.1.0",
|
|
1438
|
-
description: "API REST p\xFAblica do
|
|
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
|
|
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 = "
|
|
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.
|
|
4
|
-
"description": "Servidor MCP (Model Context Protocol) para a API pública do
|
|
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": {
|