O que é o MCP Vindi?

O conector MCP da Vindi permite que o Claude e outras 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.

O que é MCP?

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 liberação do arquivo acontece mediante aprovação. Realize o download do arquivo e faça o upload no Claude ou na sua LLM favorita.

Baixar o arquivo

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.