Skip to main content

​
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 20 ferramentas que o agente pode usar:

​
Produtos

Para criar uma cobrança você precisa do UUID do produto. Use list_products para descobrir os UUIDs disponíveis antes de chamar as ferramentas de cobrança.

​
Cobranças

​
Clientes

​
Cobranças agendadas

Cobranças agendadas usam BRL decimal (297.50), não centavos. As transações geradas (transactions[] no detalhe) seguem o padrão Garu de centavos. Converta antes de comparar valores.

​
Exemplos de Prompts

Experimente pedir ao seu agente:

​
Resolução de Problemas

Erros comuns ao instalar e usar o MCP Server:
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.
Confira se GARU_API_KEY está definida no ambiente em que o cliente MCP está rodando. No Claude Code, o cliente herda o shell — então export GARU_API_KEY=... no ~/.zshrc (ou ~/.bashrc) resolve. No Cursor e Windsurf, a chave fica no campo env do mcp.json.Confira também se a chave começa com sk_test_ ou sk_live_. Chaves antigas ou rotacionadas no dashboard deixam de funcionar imediatamente.
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 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.
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 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