convez.ai
MCP ServerFinanceiroIntermediário
magiobus

Zentavo MCP

magiobus/zentavomcp

Gerencie suas finanças Zentavo via chat com Claude, ChatGPT ou Cursor

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra sua conta Zentavo com Claude, ChatGPT e Cursor, permitindo gerenciar finanças em linguagem natural. Funciona como uma camada de ferramentas sobre a API pública do Zentavo, com suporte a múltiplos planos e controle granular de permissões (read/write).

Instalação

$npx convez-ai magiobus/zentavomcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Consultar saldo de contas e transações em linguagem natural
  • Registrar despesas e receitas sem sair do chat
  • Analisar gastos por categoria e período
  • Gerenciar múltiplos planos financeiros com uma única conexão

Veredito

Integração sólida e bem arquitetada para quem usa Zentavo. O suporte a múltiplos planos via JSON e a distinção clara entre permissões read/write reduzem riscos. Implementação eficiente que delega o custo de tokens ao usuário final.

README

A tradução para o português deste README ainda está na fila.

Zentavo MCP

Servidor MCP para manejar tus finanzas de Zentavo desde Claude, ChatGPT, Cursor o cualquier cliente compatible — en lenguaje natural.

No corre ningún modelo: es una capa de herramientas sobre la API pública de Zentavo (/api/v1). El LLM lo pone tu cliente (Claude/ChatGPT), así que los tokens los pagas tú en tu cuenta, no Zentavo.

Requisitos

  1. Una cuenta de Zentavo con acceso activo.
  2. Una o más API keys: en la app → Configuración → API → crear key (read y/o write). Cópiala (solo se muestra una vez). Cada key queda atada a un plan.
  3. Node.js ≥ 18.

Configurar en tu cliente

Un solo plan

La key va en ZENTAVO_API_KEY:

{
  "mcpServers": {
    "zentavo": {
      "command": "npx",
      "args": ["-y", "github:magiobus/zentavomcp"],
      "env": { "ZENTAVO_API_KEY": "zsk_live_..." }
    }
  }
}

Varios planes

Genera una key por plan y pásalas en ZENTAVO_PLANS (JSON con name + key). Una sola conexión cubre todos:

{
  "mcpServers": {
    "zentavo": {
      "command": "npx",
      "args": ["-y", "github:magiobus/zentavomcp"],
      "env": {
        "ZENTAVO_PLANS": "[{\"name\":\"personal\",\"key\":\"zsk_live_AAA\"},{\"name\":\"negocio\",\"key\":\"zsk_live_BBB\"},{\"name\":\"casa\",\"key\":\"zsk_live_CCC\"}]"
      }
    }
  }
}

Con varios planes, cada herramienta acepta un parámetro plan (el name) que decide a cuál mandar. Usa list_plans para ver los nombres disponibles. El modelo puede inferirlo del contexto ("en mi plan de negocio, registra…").

Opcional: ZENTAVO_BASE_URL (default https://zentavo.lat/api/v1).

Desarrollo local (sin npm)

{
  "mcpServers": {
    "zentavo": {
      "command": "node",
      "args": ["/ruta/absoluta/a/zentavomcp/index.js"],
      "env": { "ZENTAVO_API_KEY": "zsk_live_..." }
    }
  }
}

Reinicia el cliente y ya puedes pedirle cosas como "¿cuánto gasté este mes?" o "registra un gasto de 120 en Oxxo".

Herramientas

  • Planes: list_plans (ver los planes configurados).
  • Lectura (key con scope read): list_accounts, list_transactions, get_transaction, list_categories, list_budgets, get_summary.
  • Escritura (key con scope write): create_transaction, update_transaction, delete_transaction, create_category, assign_budget.

Los montos van en la moneda de la cuenta como decimal (ej. 45.50); el server los convierte a milliunits para la API.

Notas

  • Si una key pierde acceso (suscripción vencida o te sacan del plan), sus herramientas devuelven error — las demás siguen.
  • Una key read que intente escribir recibe 403.
  • Docs de la API: https://zentavo.lat/docs.
Ver o original no GitHub

Bom para

Relacionados