next-finance-mcp 0.9.13 → 0.9.15

package/dist/client.d.ts

@@ -113,8 +113,15 @@ export declare function atualizarOpenFinance(nomeConta: string): Promise<{
     sucesso: boolean;
     mensagem: string;
 }>;
-/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web. */
-export declare function obterExtratoOpenFinance(nomeConta: string, dataInicio: string, dataFim: string): Promise<{
+/** Abre janela local com QR do Pluggy para conta com MFA. */
+export declare function iniciarOpenFinanceQR(nomeConta: string): Promise<{
+    conta: string;
+    status: string;
+    mensagem: string;
+}>;
+/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web.
+ *  Período default: últimos 30 dias. */
+export declare function obterExtratoOpenFinance(nomeConta: string, dataInicioOpt?: string, dataFimOpt?: string): Promise<{
     conta: string;
     sucesso: boolean;
     mensagem: string;

package/dist/client.js

@@ -646,6 +646,18 @@ export async function listarTiposConta() {
     const tipos = arr.map(t => ({ nome: String(t["Nome"] ?? t["Descricao"] ?? "") })).filter(t => t.nome);
     return { tipos };
 }
+// ── Helpers de datas padrão ──────────────────────────────────────────────────
+// Default consistente em toda a API: últimos 30 dias terminando hoje.
+function isoDate(d) { return d.toISOString().slice(0, 10); }
+function defaultsUltimos30Dias(opts) {
+    const hoje = new Date();
+    const dataFim = opts.dataFim ?? isoDate(hoje);
+    // 30 dias atrás = hoje - 30 (inclusive)
+    const trintaDiasAtras = new Date(hoje);
+    trintaDiasAtras.setDate(trintaDiasAtras.getDate() - 30);
+    const dataInicio = opts.dataInicio ?? isoDate(trintaDiasAtras);
+    return { dataInicio, dataFim };
+}
 /** Resolve um nome de conta → IdConta interno, exigindo match único (não expõe ID). */
 async function resolverIdConta(nome) {
     const { contas } = await fetchContas();
@@ -709,9 +721,49 @@ export async function atualizarOpenFinance(nomeConta) {
     }
     return { conta: nome, sucesso: true, mensagem: r.text?.trim() || "Sincronização iniciada." };
 }
-/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web. */
-export async function obterExtratoOpenFinance(nomeConta, dataInicio, dataFim) {
+/** Pega o accessToken do Pluggy para iniciar o widget Connect. */
+async function obterPluggyAccessToken(itemId) {
+    const r = await webGet(`/ConciliacaoAjax/ObterOpenFinanceAccessToken?itemId=${encodeURIComponent(itemId)}`);
+    if (r.status !== 200)
+        throw new Error(`Falha ao obter access token Pluggy (HTTP ${r.status}).`);
+    return r.text.trim().replace(/^"|"$/g, "");
+}
+/** Abre janela local com QR do Pluggy para conta com MFA. */
+export async function iniciarOpenFinanceQR(nomeConta) {
+    const { contas } = await fetchContas();
+    const ativas = contas.filter(isContaAtiva);
+    const termo = nomeConta.trim().toLowerCase();
+    const matches = ativas.filter(c => String(c["Nome"] ?? c["NomeConta"] ?? "").toLowerCase().includes(termo));
+    if (matches.length === 0)
+        throw new Error(`Conta "${nomeConta}" não encontrada.`);
+    const exata = matches.find(c => String(c["Nome"] ?? c["NomeConta"] ?? "").toLowerCase() === termo);
+    const conta = exata ?? (matches.length === 1 ? matches[0] : null);
+    if (!conta)
+        throw new Error(`"${nomeConta}" corresponde a ${matches.length} contas. Seja mais específico.`);
+    const itemId = String(conta["OpenFinanceId"] ?? "");
+    if (!itemId)
+        throw new Error(`Conta "${nomeConta}" não tem vínculo Open Finance.`);
+    const nomeFmt = String(conta["Nome"] ?? "");
+    const banco = String(conta["NomeBanco"] ?? "Banco");
+    const accessToken = await obterPluggyAccessToken(itemId);
+    const { abrirQrPluggy } = await import("./qr-server.js");
+    const result = await abrirQrPluggy(accessToken, itemId, banco, nomeFmt);
+    if (result.status === "success") {
+        return { conta: nomeFmt, status: "success", mensagem: "Autenticação Open Finance concluída. Use 'obter_extrato_open_finance' para puxar o extrato." };
+    }
+    if (result.status === "timeout") {
+        return { conta: nomeFmt, status: "timeout", mensagem: "Tempo esgotado (5 min). Tente novamente." };
+    }
+    if (result.status === "error") {
+        return { conta: nomeFmt, status: "error", mensagem: `Erro no widget Pluggy: ${result.error ?? "desconhecido"}` };
+    }
+    return { conta: nomeFmt, status: "closed", mensagem: "Janela fechada antes de concluir a autenticação." };
+}
+/** Solicita o extrato OF (faz pull do banco para o período) — POST JSON web.
+ *  Período default: últimos 30 dias. */
+export async function obterExtratoOpenFinance(nomeConta, dataInicioOpt, dataFimOpt) {
     const { id, nome } = await resolverIdConta(nomeConta);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias({ dataInicio: dataInicioOpt, dataFim: dataFimOpt });
     // Endpoint web real (verificado): POST application/json com DataInicio/DataFim em ISO datetime
     const body = JSON.stringify({
         DataInicio: `${dataInicio}T00:00:00`,
@@ -819,9 +871,7 @@ function slimDespesa(d, comItens) {
     return result;
 }
 export async function buscarDespesas(opts = {}) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     // API exige formato ISO completo com hora
     const raw = await apiPost("/api/Despesa/Filtrar", {
         DataInicio: dataInicio + "T00:00:00.000Z",
@@ -855,9 +905,7 @@ export async function buscarDespesas(opts = {}) {
     };
 }
 export async function buscarItensDespesa(opts = {}) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     // Resolve nome do fornecedor → ID interno (nunca exposto)
     let pessoaId;
     if (opts.nomeFornecedor?.trim()) {
@@ -982,9 +1030,7 @@ const TIPOS_CONTA_MOVIMENTO = new Set([
     "contas em cobrança", "contas em cobranca",
 ]);
 export async function buscarLancamentos(opts) {
-    const today = new Date();
-    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
-    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const { dataInicio, dataFim } = defaultsUltimos30Dias(opts);
     const pagina = Math.max(1, opts.pagina ?? 1);
     const limite = Math.min(200, Math.max(1, opts.limite ?? 50));
     // Resolve nome da conta → ID interno (nunca exposto ao usuário)

package/dist/index.js

@@ -8,7 +8,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import * as client from "./client.js";
 import { openLoginUI } from "./login-server.js";
-const server = new Server({ name: "next-finance-mcp", version: "0.9.13" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "next-finance-mcp", version: "0.9.15" }, { capabilities: { tools: {} } });
 // ── Ferramentas ─────────────────────────────────────────────────────────────
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -100,7 +100,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 type: "object",
                 properties: {
                     nome_conta: { type: "string", description: "Nome da conta (opcional — omitir busca em todas as contas, ex: 'Nubank', 'Inter')" },
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
                     data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                     plano_de_contas: { type: "string", description: "Filtra por categoria/plano de contas (ex: 'Restaurante')" },
                     centro_de_custo: { type: "string", description: "Filtra por centro de custo" },
@@ -157,20 +157,31 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["nome_conta"],
             },
         },
+        {
+            name: "iniciar_open_finance_qr",
+            description: "Abre uma janela local no navegador com o widget Pluggy Connect para autenticar uma conta Open Finance que exige MFA (ex: Inter, que pede leitura de QR Code no Super App). Após o usuário concluir a autenticação, a janela fecha sozinha e a conta fica pronta para 'obter_extrato_open_finance'.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    nome_conta: { type: "string", description: "Nome da conta (ex: 'Inter CC 651549')" },
+                },
+                required: ["nome_conta"],
+            },
+        },
         {
             name: "obter_extrato_open_finance",
-            description: "Solicita ao banco (via Open Finance) o extrato completo de uma conta no período. " +
-                "Diferente de 'atualizar_open_finance' (que só pega o mais recente), este endpoint " +
-                "permite especificar um intervalo de datas. Após sucesso, use 'buscar_lancamentos' " +
-                "para ver os lançamentos importados.",
+            description: "Solicita ao banco (via Open Finance) o extrato de uma conta no período. " +
+                "Diferente de 'atualizar_open_finance' (que só pega o mais recente), permite " +
+                "especificar um intervalo de datas. Default: últimos 30 dias. Após sucesso, " +
+                "a conciliação fica pendente no NEXT — finalize no app para os lançamentos aparecerem em 'buscar_lancamentos'.",
             inputSchema: {
                 type: "object",
                 properties: {
                     nome_conta: { type: "string", description: "Nome da conta (ex: 'Inter CC 651549')" },
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD" },
-                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
+                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                 },
-                required: ["nome_conta", "data_inicio", "data_fim"],
+                required: ["nome_conta"],
             },
         },
         {
@@ -182,7 +193,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             inputSchema: {
                 type: "object",
                 properties: {
-                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 30 dias atrás)" },
                     data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
                     nome_fornecedor: { type: "string", description: "Filtra por nome do fornecedor (ex: 'Supermercados BH', 'Epa')" },
                     busca: { type: "string", description: "Filtra por número do documento ou tipo" },
@@ -377,6 +388,15 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     return walErr;
                 return ok(await client.atualizarOpenFinance(args["nome_conta"]));
             }
+            case "iniciar_open_finance_qr": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                const walErr = requireWallet();
+                if (walErr)
+                    return walErr;
+                return ok(await client.iniciarOpenFinanceQR(args["nome_conta"]));
+            }
             case "obter_extrato_open_finance": {
                 const authErr = requireAuth();
                 if (authErr)

package/dist/qr-server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Servidor HTTP local para exibir o QR Code do Pluggy Connect.
+ * Usado quando uma conta Open Finance exige MFA (ex: Inter).
+ *
+ * Fluxo:
+ *  1. MCP busca o accessToken do Pluggy via ConciliacaoAjax/ObterOpenFinanceAccessToken
+ *  2. Inicia servidor HTTP local com página que carrega o widget Pluggy Connect
+ *  3. Abre o browser na URL local
+ *  4. Widget Pluggy renderiza o QR; usuário escaneia no app do banco
+ *  5. Após sucesso, a página POSTa /done de volta para o servidor → MCP encerra e retorna
+ */
+export interface QrSessionResult {
+    status: "success" | "error" | "closed" | "timeout";
+    itemId?: string;
+    error?: string;
+}
+/** Abre o widget Pluggy no browser local e espera o usuário concluir o MFA. */
+export declare function abrirQrPluggy(accessToken: string, itemId: string, banco: string, conta: string, timeoutMs?: number): Promise<QrSessionResult>;

package/dist/qr-server.js

@@ -0,0 +1,160 @@
+/**
+ * Servidor HTTP local para exibir o QR Code do Pluggy Connect.
+ * Usado quando uma conta Open Finance exige MFA (ex: Inter).
+ *
+ * Fluxo:
+ *  1. MCP busca o accessToken do Pluggy via ConciliacaoAjax/ObterOpenFinanceAccessToken
+ *  2. Inicia servidor HTTP local com página que carrega o widget Pluggy Connect
+ *  3. Abre o browser na URL local
+ *  4. Widget Pluggy renderiza o QR; usuário escaneia no app do banco
+ *  5. Após sucesso, a página POSTa /done de volta para o servidor → MCP encerra e retorna
+ */
+import * as http from "http";
+import * as os from "os";
+import { exec } from "child_process";
+function openBrowser(url) {
+    const platform = os.platform();
+    const cmd = platform === "darwin" ? `open "${url}"` :
+        platform === "win32" ? `start "" "${url}"` :
+            `xdg-open "${url}"`;
+    exec(cmd, (err) => {
+        if (err)
+            console.error("Não foi possível abrir o browser:", err.message);
+    });
+}
+function buildHtml(accessToken, itemId, banco, conta) {
+    return `<!DOCTYPE html>
+<html lang="pt-br">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Open Finance — ${conta}</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      background: #f0f2f5; min-height: 100vh;
+      display: flex; align-items: center; justify-content: center;
+    }
+    .card {
+      background: #fff; border-radius: 12px;
+      box-shadow: 0 4px 24px rgba(0,0,0,.10);
+      padding: 32px; width: 480px; text-align: center;
+    }
+    h1 { color: #1a73e8; font-size: 20px; margin-bottom: 8px; }
+    .sub { color: #666; font-size: 13px; margin-bottom: 24px; }
+    .status {
+      padding: 16px; border-radius: 8px; margin-top: 20px;
+      font-size: 14px; line-height: 1.5;
+    }
+    .status.info    { background: #e8f0fe; color: #1a73e8; }
+    .status.success { background: #e6f4ea; color: #137333; }
+    .status.error   { background: #fce8e6; color: #c5221f; }
+    .btn {
+      margin-top: 16px; padding: 10px 20px; background: #1a73e8; color: #fff;
+      border: none; border-radius: 6px; font-size: 14px; cursor: pointer;
+    }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>Conectar via Open Finance</h1>
+    <p class="sub"><strong>${banco}</strong> — ${conta}</p>
+    <div id="status" class="status info">Carregando o widget do Pluggy…</div>
+  </div>
+
+  <script src="https://cdn.pluggy.ai/pluggy-connect/v2.10.0/pluggy-connect.js"></script>
+  <script>
+    const ACCESS_TOKEN = ${JSON.stringify(accessToken)};
+    const ITEM_ID = ${JSON.stringify(itemId)};
+    const statusEl = document.getElementById("status");
+    function setStatus(text, kind) { statusEl.textContent = text; statusEl.className = "status " + kind; }
+    function notifyServer(payload) {
+      fetch("/done", { method: "POST", headers: {"Content-Type":"application/json"}, body: JSON.stringify(payload) }).catch(() => {});
+    }
+    try {
+      const pc = new PluggyConnect({
+        connectToken: ACCESS_TOKEN,
+        updateItem: ITEM_ID,
+        includeSandbox: false,
+        onSuccess: (data) => {
+          setStatus("✅ Autenticação concluída! Você já pode fechar esta janela.", "success");
+          notifyServer({ status: "success", itemId: data.item?.id ?? ITEM_ID });
+        },
+        onError: (err) => {
+          setStatus("❌ Erro: " + (err.message || JSON.stringify(err)), "error");
+          notifyServer({ status: "error", error: err.message || String(err) });
+        },
+        onClose: () => {
+          setStatus("Widget fechado. Se concluiu a autenticação, pode fechar esta janela.", "info");
+          notifyServer({ status: "closed" });
+        },
+      });
+      pc.init();
+      setStatus("Aponte a câmera do app do banco para o QR Code que vai aparecer.", "info");
+    } catch (e) {
+      setStatus("Erro ao iniciar widget Pluggy: " + e.message, "error");
+      notifyServer({ status: "error", error: e.message });
+    }
+  </script>
+</body>
+</html>`;
+}
+/** Abre o widget Pluggy no browser local e espera o usuário concluir o MFA. */
+export function abrirQrPluggy(accessToken, itemId, banco, conta, timeoutMs = 5 * 60 * 1000) {
+    return new Promise((resolve) => {
+        let resolved = false;
+        const resolveOnce = (r) => {
+            if (resolved)
+                return;
+            resolved = true;
+            try {
+                server.close();
+            }
+            catch { }
+            clearTimeout(timer);
+            resolve(r);
+        };
+        const server = http.createServer((req, res) => {
+            if (req.method === "GET" && (req.url === "/" || req.url === "/index.html")) {
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(buildHtml(accessToken, itemId, banco, conta));
+                return;
+            }
+            if (req.method === "POST" && req.url === "/done") {
+                let body = "";
+                req.on("data", chunk => body += chunk);
+                req.on("end", () => {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(`{"ok":true}`);
+                    try {
+                        const data = JSON.parse(body);
+                        if (data.status === "success")
+                            resolveOnce({ status: "success", itemId: data.itemId });
+                        else if (data.status === "error")
+                            resolveOnce({ status: "error", error: data.error });
+                        else if (data.status === "closed") {
+                            // Closed sem success: mantemos servidor por mais alguns segundos caso o user reabra
+                            // Mas pra simplificar, vamos fechar mesmo
+                            setTimeout(() => resolveOnce({ status: "closed" }), 1000);
+                        }
+                    }
+                    catch { /* ignora payload inválido */ }
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end("Not found");
+        });
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (!addr || typeof addr === "string") {
+                resolveOnce({ status: "error", error: "Falha ao iniciar servidor local" });
+                return;
+            }
+            const url = `http://127.0.0.1:${addr.port}/`;
+            openBrowser(url);
+        });
+        const timer = setTimeout(() => resolveOnce({ status: "timeout" }), timeoutMs);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.9.13",
+  "version": "0.9.15",
   "mcpName": "io.github.paivapiovesan/next-finance",
   "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
   "type": "module",