Skip to main content
O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA (Cursor, Claude Desktop, etc.) usem ferramentas externas. O servidor MCP oficial da Avantti Finance expõe a nossa API como ferramentas, para que você crie cobranças e transferências conversando com a IA.

​
Ferramentas disponíveis

FerramentaO que faz
create_pix_inCria uma cobrança PIX (QR Code / copia e cola).
create_pix_outRealiza uma transferência PIX (saque).
get_transferConsulta o status de um saque.
create_card_tokenTokeniza os dados de um cartão.
create_cardCria uma transação por cartão.
create_boletoCria uma cobrança via boleto.
A autenticação (Basic → JWT) e a renovação do token são feitas automaticamente pelo servidor MCP. Você só precisa fornecer sua API Key e API Secret.

​
Instalação

Adicione ao arquivo ~/.cursor/mcp.json (global) ou .cursor/mcp.json (do projeto):
{
  "mcpServers": {
    "avantti-finance": {
      "command": "npx",
      "args": ["-y", "@avantti/mcp-server"],
      "env": {
        "AVANTTI_API_KEY": "SUBSTITUA_PELA_SUA_API_KEY",
        "AVANTTI_API_SECRET": "SUBSTITUA_PELO_SEU_API_SECRET"
      }
    }
  }
}
Segurança: substitua os placeholders pela sua API Key e API Secret reais e nunca comite esse arquivo em repositórios públicos. As credenciais ficam apenas no ambiente local onde o MCP roda.

​
Variáveis de ambiente

VariávelObrigatóriaPadrão
AVANTTI_API_KEYsim—
AVANTTI_API_SECRETsim—
AVANTTI_BASE_URLnãohttps://api.avanttifinance.com

​
Exemplos de uso

Depois de configurar, basta pedir ao assistente:
“Crie uma cobrança PIX de R$ 80,00 para o cliente João (CPF 123.456.789-09).”
“Faça um saque PIX de R$ 3,00 para a chave email@exemplo.com com a senha 111111.”
“Qual o status da transferência clxyz123abc?”
Quer fazer tudo de uma vez? Veja o prompt de integração — um único comando configura a segurança e integra PIX in e out no seu projeto.