MCP Vindi (V0)

Vindi MCP.
Pergunte ao Claude ou qualquer outra LLM sobre a sua operação de recorrência, em português, sem abrir o painel e sem escrever uma linha de código.

O QUE É

O conector MCP da Vindi permite que o Claude e outas LLMs consultem, em modo somente leitura, os dados da sua conta Vindi: clientes, assinaturas, faturas, cobranças, notas fiscais, planos, produtos e meios de pagamento.

MCP (Model Context Protocol) é um protocolo aberto que padroniza como assistentes de IA se conectam a sistemas externos.
O que você pode perguntar
Para quem atende, cobra e acompanha:

"Quais assinaturas ativas tem o cliente [email protected]?"
"Liste as faturas pendentes desta semana."
"Mostre as cobranças que falharam e o status de cada uma."
"Quais planos e produtos estão ativos na minha conta?"
"Detalhe a assinatura 12345."

SOMENTE LEITURA

O conector não cria, altera nem exclui nada na sua conta Vindi. Ele não estorna cobranças, não cancela assinaturas e não emite faturas.
Ferramentas disponíveis
São 15 ferramentas, todas de leitura. Para cada recurso há uma ferramenta de listagem (com filtro e paginação) e uma de detalhe por ID.

Recurso
Listar
Detalhar
Clientes
list_customers
get_customer
Assinaturas
list_subscriptions
get_subscription
Faturas
list_bills
get_bill
Cobranças
list_charges
get_charge
Notas fiscais
list_invoices
get_invoice
Planos
list_plans
get_plan
Produtos
list_products
get_product
Meios de pagamento
list_payment_methods
—

Parâmetros das listagens

Query: filtro no formato campo:valor (ex.: status:active). [Validar com o time de API a lista de campos aceitos por recurso.]
page e per_page: paginação (máximo de 50 itens por página).
sort_by e sort_order: ordenação.
Como conectar

ESCOLHA O SEU CAMINHO
Como estamos em piloto a liberalão do arquivo acontece mediante a aprovação,

Realize o dowload do arquivo e faça upload no Claude ou na sua LLM favorita.

COMECE PELO SANDBOX

Teste com uma conta de sandbox antes de conectar a conta de produção. Veja Ambiente para Testes. [Definir o endereço do servidor MCP para sandbox.]

Segurança e privacidade

Somente leitura: todas as ferramentas são marcadas como leitura.
Sem armazenamento: o servidor repassa suas consultas à API da Vindi e [não armazena o conteúdo das respostas nem das conversas — confirmar com Segurança/Jurídico].
Credenciais: sua chave de API é usada apenas para autenticar as chamadas à API da Vindi. Trate-a como uma senha e use chaves com as permissões mínimas necessárias.
Dados pessoais (LGPD): as respostas podem conter dados de clientes finais, como nome, e-mail e documento. Ao usar o Claude, esses dados são processados pelo serviço de IA que você escolheu. [Inserir link para a política de privacidade da Vindi e orientações de LGPD.]

Proteção contra uso indevido: o servidor só aceita chamadas com credenciais válidas e rejeita origens não autorizadas.
Limites e comportamento
Respostas muito grandes são truncadas; use per_page menor ou filtros mais específicos.
Erros da API da Vindi (chave inválida, recurso não encontrado, limite de requisições) são devolvidos ao Claude com uma mensagem clara, para que ele possa explicar o problema.
Valem os mesmos limites de requisições da API da Vindi. [Confirmar números atuais.]
Perguntas frequentes

Preciso programar para usar? Não. Depois de conectado, você conversa com o Claude normalmente.

O Claude e outras LLMs podem cancelar uma assinatura ou estornar uma cobrança? Não. Esta versão só consulta. Para ações, use o painel ou a API.

Funciona com outros assistentes além do Claude? Sim, basta realizar o upload do arquivo.

Onde reporto um problema ou sugiro uma ferramenta? No Fórum ou pelos Canais de Atendimento.