Avantti + IA (MCP e LLMs) - Avantti Finance

Infraestrutura financeira preparada para IA, automações inteligentes, MCPs e Large Language Models.

A Avantti AI conecta pagamentos, contas, eventos e operações financeiras diretamente com agentes inteligentes, automações e aplicações baseadas em LLMs. Construa produtos AI-native com acesso seguro e estruturado à infraestrutura financeira da Avantti.

Visão geral

Integrar LLMs

Conecte modelos de linguagem diretamente às operações financeiras.

Agentes autônomos

Crie agentes que executam pagamentos e consultas de forma independente.

Automação via linguagem natural

Execute ações financeiras descrevendo o que precisa em texto livre.

MCP nativo

Use o Model Context Protocol para integrar com Claude, ChatGPT, Cursor e mais.

O que é MCP

MCP (Model Context Protocol) é um protocolo aberto para conectar modelos de IA com ferramentas externas, APIs e sistemas. Com MCP, modelos conseguem ler dados, executar ações, consumir APIs, operar sistemas financeiros e interagir com contexto em tempo real.

Avantti MCP

O Avantti MCP fornece acesso estruturado à infraestrutura financeira da Avantti para Claude, ChatGPT, Cursor, Windsurf, VSCode AI, agentes personalizados e aplicações AI-native.

Capacidades

Recurso	Descrição
Payments	Criar pagamentos
Customers	Gerenciar clientes
Balance	Consultar saldo
Webhooks	Consumir eventos
Refunds	Criar reembolsos
Accounts	Gerenciar contas
Analytics	Métricas financeiras
Subscriptions	Assinaturas

Instalação

npx @avantti/mcp

docker run avantti/mcp

{
  "mcpServers": {
    "avantti": {
      "command": "npx",
      "args": ["@avantti/mcp"],
      "env": {
        "AVANTTI_API_KEY": "sk_test_xxxxx"
      }
    }
  }
}

Configuração por cliente

Claude Desktop
Cursor
Windsurf

Localize o arquivo de configuração de acordo com seu sistema operacional:macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Em seguida, adicione:

{
  "mcpServers": {
    "avantti": {
      "command": "npx",
      "args": ["@avantti/mcp"],
      "env": {
        "AVANTTI_API_KEY": "sk_test_xxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "avantti": {
      "command": "npx",
      "args": ["@avantti/mcp"]
    }
  }
}

{
  "mcpServers": {
    "avantti": {
      "command": "npx",
      "args": ["@avantti/mcp"]
    }
  }
}

Ferramentas disponíveis

Tool	Descrição
`payments.create`	Criar pagamento
`payments.get`	Buscar pagamento
`payments.list`	Listar pagamentos
`customers.create`	Criar cliente
`customers.get`	Buscar cliente
`refunds.create`	Criar reembolso
`balance.get`	Consultar saldo
`subscriptions.create`	Criar assinatura

Exemplos de uso

Claude
ChatGPT
Agente autônomo

Prompt

Crie um pagamento PIX de R$50 para João Silva.

ResultadoO modelo irá:

Interpretar o pedido
Executar a tool financeira
Criar o pagamento
Retornar QR Code e detalhes

Prompt

Liste os pagamentos aprovados hoje.

ResultadoA IA irá consultar a API da Avantti e retornar os pagamentos filtrados.

const response = await agent.run(
  "Crie uma cobrança PIX de R$100"
)

SDK de IA (Node.js)

Instale o pacote

npm install @avantti/ai

Inicialize o cliente

import { AvanttiAI } from "@avantti/ai"

const ai = new AvanttiAI({
  apiKey: process.env.AVANTTI_API_KEY
})

Crie um agente

const agent = ai.agent({
  tools: ["payments", "customers"]
})

Execute uma ação

const response = await agent.run(
  "Crie um pagamento PIX de R$50"
)

Tool calling

A Avantti AI suporta tool calling compatível com OpenAI, Anthropic, Gemini, Groq, DeepSeek e Ollama.

import OpenAI from "openai"

const openai = new OpenAI()

const completion = await openai.chat.completions.create({
  model: "gpt-4.1",
  tools: [
    {
      type: "function",
      function: {
        name: "create_payment",
        description: "Cria pagamento PIX"
      }
    }
  ],
  messages: [
    {
      role: "user",
      content: "Crie um PIX de R$50"
    }
  ]
})

const response = await anthropic.messages.create({
  model: "claude-sonnet-4",
  tools: [
    {
      name: "payments_create",
      description: "Cria pagamento"
    }
  ]
})

import { AvanttiTool } from "@avantti/ai/langchain"

const tools = [
  new AvanttiTool()
]

import { avanttiTools } from "@avantti/ai/vercel"

const tools = avanttiTools()

Segurança

A Avantti AI foi construída com foco em segurança.

Escopo de permissões

Controle granular sobre quais ações cada integração pode executar.

Isolamento por workspace

Cada workspace opera de forma isolada, sem vazamento de contexto.

Validação de tool calls

Toda chamada de ferramenta é validada antes da execução.

Rate limiting

Limites de requisição protegem contra uso abusivo.

Logs auditáveis

Todas as ações de IA ficam registradas para auditoria.

Assinaturas criptográficas

Requisições críticas são assinadas criptograficamente.

Permissões

{
  "permissions": {
    "payments:create": true,
    "refunds:create": false
  }
}

Ambientes

AVANTTI_ENV=sandbox

AVANTTI_ENV=production

Eventos em tempo real

A Avantti AI pode consumir eventos em tempo real:

ai.events.on("payment.approved", (event) => {
  console.log(event)
})

Automação

Um fluxo automático típico:

Cliente paga → webhook → IA interpreta → ação automática

Casos de uso

Atendimento financeiro

Segunda via automática, consulta de pagamentos, status de cobranças e reembolsos automáticos.

Operações

Conciliação, monitoramento, alertas inteligentes e análise de fraude.

Checkout AI-native

Cobranças por linguagem natural, assistentes de compra e conversational commerce.

ERP AI

Integrações financeiras inteligentes, operações automatizadas e fluxos autônomos.

Estrutura de resposta

{
  "success": true,
  "data": {
    "id": "pay_123456",
    "status": "approved"
  }
}

Logs e depuração

Para ativar o modo debug:

AVANTTI_DEBUG=true

Troubleshooting

MCP não conecta

Verifique:

Node.js instalado
API Key válida
Variáveis de ambiente
Firewall
Configuração JSON

Erro de autenticação

Invalid API Key

Confirme:

Ambiente correto
Token ativo
Permissões habilitadas

Performance

O MCP da Avantti foi otimizado para baixa latência, tool calling rápido, streaming, alta concorrência e execução paralela.

Compatibilidade

Plataforma	Compatível
Claude Desktop	Sim
Cursor	Sim
Windsurf	Sim
VSCode AI	Sim
OpenAI SDK	Sim
LangChain	Sim
Vercel AI SDK	Sim

Boas práticas

Utilize sandbox durante o desenvolvimento
Restrinja permissões ao mínimo necessário
Faça validação de inputs
Monitore tool calls
Utilize logs auditáveis

Recursos relacionados

Referência da API

Explore todos os endpoints disponíveis.

SDKs

Bibliotecas oficiais para integração.

CLI

Gerencie sua conta pela linha de comando.

Webhooks

Receba eventos em tempo real.

Você também pode consultar a página de Status e o Changelog para acompanhar atualizações da plataforma.

Suporte

Caso precise de ajuda, entre em contato:

E-mail

suporte@avanttifinance.com

Comunidade

Participe do nosso Discord da comunidade ou abra uma issue no GitHub.

A Avantti AI foi construída para conectar infraestrutura financeira moderna com a próxima geração de aplicações baseadas em IA.

​Visão geral

Integrar LLMs

Agentes autônomos

Automação via linguagem natural

MCP nativo

​O que é MCP

​Avantti MCP

​Capacidades

​Instalação

​Configuração por cliente

​Ferramentas disponíveis

​Exemplos de uso

​SDK de IA (Node.js)

​Tool calling

​Segurança