Use com seu agente (MCP)
vintem mcp é um servidor MCP por stdio. Ele chama a API do Vintém com a API
key do agente, então os escopos valem: uma key só de leitura dá um agente que
só consulta (ADR-008).
No Claude Code
Seção intitulada “No Claude Code”vintem sandbox # copie a key vtm_... que ele imprimeclaude mcp add vintem -e VINTEM_TOKEN=vtm_... -e VINTEM_CHAVE_PIX=sandbox@vintem.dev -- vintem mcpDepois peça: “cobre R$ 49,90 do pedido 42 e me mostre o Pix copia e cola”.
Em qualquer cliente MCP
Seção intitulada “Em qualquer cliente MCP”Rode vintem mcp por stdio com estas variáveis:
| Variável | Para quê |
|---|---|
VINTEM_URL |
Onde está a API (padrão http://localhost:8080) |
VINTEM_TOKEN |
A API key do agente |
VINTEM_CHAVE_PIX |
Chave usada quando o agente não informa outra |
Ferramentas
Seção intitulada “Ferramentas”| Ferramenta | Escopo |
|---|---|
criar_cobranca |
cob:write |
consultar_cobranca |
cob:read |
listar_cobrancas |
cob:read |
cancelar_cobranca |
cob:write |
devolver_pix |
devolucao:write |
consultar_devolucao |
pix:read |