O que é MCP?
O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA se conectem a ferramentas e serviços externos. Com o MCP Server da Garu, seu agente pode criar cobranças, consultar transações e gerenciar clientes diretamente pelo chat. Por que isso importa?- Seu agente de IA entende o contexto do seu código e cria cobranças sem sair do editor
- Menos copy-paste de documentação, mais produtividade
- Funciona com Claude Code, Cursor, Codex, Windsurf e qualquer cliente MCP
Pré-requisito: Você precisa de uma chave de API. Veja como obter em
Autenticação.
Instalação
Escolha sua ferramenta e siga as instruções:Transportes
O MCP Server da Garu suporta dois modos de transporte:
O modo stdio é o padrão e funciona automaticamente com os comandos de instalação acima. Para usar o modo HTTP:
Catálogo de Ferramentas
O servidor expõe mais de 50 ferramentas. Estas são as principais que o agente pode usar:Produtos
O
value de um produto é 0 (produto sem preço, que não vende pelo link de pagamento) ou **pelo menos R 0,01 a R$ 4,99 a API recusa com 400. No update_product, a regra só vale quando o agente envia value: sem ele, o preço atual fica como está.Ofertas
Uma oferta é um preço com nome em um produto, com link próprio (/pay/{uuid}?offer={slug ou id}). Ela muda só o preço; o resto continua o do produto.
Diferente do produto, uma oferta não pode ficar sem preço: o
value precisa ser de pelo menos R$ 5,00, e 0 é recusado.Cobranças
Clientes
Cobranças agendadas
charge.amount e transactions[].value estão ambos em BRL decimal
(297.50) — nunca centavos. Nenhuma conversão é necessária entre os dois.Exemplos de Prompts
Experimente pedir ao seu agente:Resolução de Problemas
Erros comuns ao instalar e usar o MCP Server:command not found: claude (ou cursor, codex, windsurf)
command not found: claude (ou cursor, codex, windsurf)
O cliente MCP não está instalado ou não está no
PATH. Reinstale o
Claude Code/Cursor/Codex/Windsurf seguindo o guia oficial e reabra o
terminal antes de tentar de novo.network timeout ao executar uma ferramenta
network timeout ao executar uma ferramenta
Provavelmente firewall ou proxy corporativo bloqueando
https://garu.com.br/api. Adicione garu.com.br à lista de exceções da sua
rede ou use uma conexão fora da rede corporativa para testar.O agente não vê as ferramentas da Garu
O agente não vê as ferramentas da Garu
O cliente MCP geralmente carrega o servidor só na primeira conversa. Reinicie
completamente o IDE (não só recarregar a janela). No Claude Code, rode
claude mcp list para confirmar que garu aparece na lista.permission denied ao executar npx
permission denied ao executar npx
Ambiente Node desatualizado ou sem permissão de escrita no cache do
npx.
Atualize o Node para 20.x ou superior e rode npx --yes --package=@garuhq/mcp@latest garu-mcp --version
uma vez no terminal para popular o cache antes de o cliente MCP tentar.O agente criou uma cobrança no ambiente errado
O agente criou uma cobrança no ambiente errado
O MCP usa exatamente a chave que você passou — ele não detecta sozinho
se é teste ou produção. Mantenha chaves de teste no ambiente de
desenvolvimento e revogue qualquer chave
sk_live_ que tenha vazado
para o ambiente local. Cobranças criadas em produção por engano podem
ser canceladas pelo dashboard, ou reembolsadas com refund_charge se
já tiverem sido pagas.Recursos
Repositório GitHub
Código-fonte e documentação técnica
Pacote npm
@garuhq/mcp no npm
Próximos Passos
CLI
Use a Garu direto no terminal
Skills
Ensine boas práticas ao seu agente