Which integrations are available for this server?

Integrates with the Pix instant payment system to process and deliver payment information and billing status as part of an automated financial orchestration workflow.

How do I use MCP Financeiro?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Financeiro enviar boleto e pix para a placa NPU0901" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Financeiro - API Multi-Empresas

Servidor API em Node.js + TypeScript + Hono para orquestrar integrações SGA (Hinova) e Chat Atomos em modelo SaaS multi-empresas.

Pré-requisitos

Node.js 18+
Conta Supabase
Tokens: token_erp (Hinova SGA), token_chat e token_canal (Atomos)

Setup

1. Instalar dependências

npm install

2. Configurar variáveis de ambiente

Copie .env.example para .env e preencha:

SUPABASE_URL=https://seu-projeto.supabase.co SUPABASE_SERVICE_ROLE_KEY=sua-service-role-key

3. Executar migrations no Supabase

No Supabase Dashboard > SQL Editor, execute o conteúdo do arquivo:

supabase/migrations/001_initial_schema.sql

4. Iniciar o servidor

npm run dev

O servidor estará em http://localhost:3000.

Endpoints

POST /api/v1/clientes

Cadastra um cliente com todas as configurações em uma única chamada.

Body:

{ "nome": "Cliente X", "ativo": true, "token_erp": "...", "token_chat": "...", "token_canal": "...", "perfil_sistema": "SGA", "base_url": "https://api.hinova.com.br/api/sga/v2", "configuracoes_boleto": { "dias_antes_vencimento": 15, "dias_depois_vencimento": 5, "situacoes_envio_direto": ["ATIVO"], "situacoes_com_checagem_vencimento": ["INADIMPLENTE"], "dias_checagem_vencimento": 2 }, "configuracoes_respostas": { "response_sucesso": "Boleto e pix enviados! Vencimento: {{ data_vencimento }} Valor: {{ valor_boleto }}", "response_regularizacao_moto": "...", "response_regularizacao_veiculo": "...", "response_boleto_baixado": "..." }, "configuracoes_revistoria": { "enviar_midia": true, "video_moto": "https://...", "video_carro": "https://..." } }

POST /api/v1/webhook

Recebe eventos do agente de IA (placa, telefone) e processa o fluxo de boleto.

Body ou Header X-Client-Id:

{ "placa": "NPU0901", "telefone": "83998700386", "client_id": "uuid-do-cliente" }

Response: { "message": "..." } - texto formatado para a LLM.

PATCH /api/v1/clientes/:id/configuracoes

Atualiza configurações parciais de um cliente.

Scripts

npm run dev - Inicia em modo watch
npm run start - Inicia em produção
npm run typecheck - Verifica tipos TypeScript

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

MCP Financeiro