Conta Simples MCP

Permita que agentes de IA executem operações reais na plataforma Conta Simples

Visão geral

O servidor Conta Simples MCP permite que agentes de IA interajam diretamente com a plataforma Conta Simples. Expõe um conjunto de ferramentas com as quais os agentes podem consultar dados financeiros, gerenciar cartões e automatizar fluxos operacionais — tudo em linguagem natural.

Este servidor MCP executa operações reais na sua conta Conta Simples. As ações realizadas por agentes de IA via este servidor estão sujeitas às suas permissões de usuário, limites de requisição e requisitos de auditoria.

O que pode fazer

O Conta Simples MCP suporta fluxos com IA nas principais operações financeiras:

Fechamento mensal e controlo

"Quais despesas ainda não têm comprovante este mês?"
"Há transações fora da política de gastos nos últimos 30 dias?"
"Comparar o total por categoria esta semana com a semana passada"

Conciliação e contabilidade

"Exportar todas as despesas de março com notas fiscais para o meu ERP"
"Quais transações ainda não foram categorizadas?"
"Agrupar despesas de viagem deste mês por utilizador"

Limite de crédito e cartões

"Qual é o meu limite de cartão disponível agora?"
"Mostrar todos os cartões virtuais e o estado de cada um"
"Quem na equipa tem cartão ativo?"

Comprovantes e recibos

"Quais transações ainda não têm comprovante?"
"Enviar um comprovante para esta transação"
"Mostrar os dados de OCR deste comprovante de despesa"

Configuração

Pré-requisitos

Para configurar o Conta Simples MCP, você precisa de:

Uma conta Conta Simples — Conta de usuário ativa com acesso ao Internet Banking
Um cliente compatível com MCP — Qualquer cliente que suporte MCP remoto via HTTP e permita definir o URL do servidor e cabeçalhos de autenticação (ou um mapeamento auth equivalente)

URL do servidor e autenticação

Aponte o cliente MCP para o endpoint Conta Simples. O início de sessão usa OAuth 2.x / OpenID Connect; o CLIENT_ID fixo é o identificador de cliente OAuth público deste MCP (não é um segredo). Os clientes MCP em geral agrupam as configurações OAuth num objeto auth na entrada do servidor — daí o CLIENT_ID ali — e encaminham-no como cabeçalho HTTP CLIENT_ID. Use o formato de configuração documentado para o seu cliente.

Definição	Valor
URL	`https://mcp.contasimples.com/mcp`
Cabeçalho	`CLIENT_ID` — identificador de cliente OAuth público deste MCP; copie do exemplo

Exemplo de configuração:

{
  "mcpServers": {
    "conta-simples": {
      "url": "https://mcp.contasimples.com/mcp",
      "auth": {
        "CLIENT_ID": "72ic737n3eng9k1l3s02kbeplk"
      }
    }
  }
}

O valor acima não é pessoal nem por empresa — identifica o cliente Conta Simples MCP no fluxo OAuth. Use como no exemplo. Integre este bloco no arquivo completo de configurações MCP do cliente, conforme a respectiva documentação.

Conectar a sua conta

Na primeira utilização, o servidor MCP abre uma janela do browser na página de login do Internet Banking Conta Simples. Inicie sessão com as credenciais do usuário e autorize o MCP para acessar sua conta.

Iniciar o servidor MCP

Inicie o cliente MCP. O servidor Conta Simples MCP inicia automaticamente conforme a configuração.

Iniciar sessão na Conta Simples

A página de login da Conta Simples será aberta. Use as credenciais pessoais com que acede ao Internet Banking.

Autorizar o acesso

Reveja as permissões e autorize o servidor MCP a agir em seu nome. Você pode revogar o acesso a qualquer momento pelo Internet Banking.

Pronto a utilizar

Com a autorização, o servidor MCP guarda a sessão e renova tokens automaticamente. Você pode interagir com o assistente de IA imediatamente.

A autorização persiste entre sessões. Você só precisa se autenticar novamente se revogar o acesso ou a sessão expirar.

Ferramentas disponíveis

O Conta Simples MCP expõe as seguintes ferramentas, por domínio:

Transações

Ferramenta	Descrição	Lê	Escreve
`get-card-transactions___`	Transações de cartão de crédito paginadas, com intervalo de datas ISO opcional (máx. 62 dias), limite (5–100) e filtros (valor, cartões, categorias, conciliação, anexos)	✅
`get-banking-transactions___`	Transações bancárias (conta) paginadas, com intervalo de datas, ordenação e filtros (tipos, valores, categorias, conciliação)	✅

Usuários

Ferramenta	Descrição	Lê	Escreve
`get-users___`	Lista usuários da empresa, com filtro, seleção de campos e paginação	✅

Cartões e limites

Ferramenta	Descrição	Lê	Escreve
`get-cards___`	Lista cartões, com filtro por tipo (VIRTUAL/FÍSICO), estado e email; itens com paginação	✅
`get-credit-card-limit___`	Retorna o limite de cartão de crédito disponível para a empresa autenticada	✅

Categorias

Ferramenta	Descrição	Lê	Escreve
`get-categories___`	Lista categorias padrão e personalizadas, com ID, nome, tipo e carimbos de data	✅

Comprovantes de despesa

Ferramenta	Descrição	Lê	Escreve
`create-expense-proof___`	Cria comprovante e devolve URL assinada para anexar o arquivo (PDF, PNG ou JPEG)		✅
`get-expense-proof___`	Obtém comprovante por ID: estado de vinculação, OCR, transação ligada e URL do arquivo	✅

Exemplos de fluxos

O Conta Simples MCP cobre muitas intenções em linguagem natural nas operações financeiras. A seguir, veja três exemplos e, depois, um mapa de capacidade por domínio.

Pedidos assinalados com em breve dependem de ferramentas ainda em desenvolvimento e estarão disponíveis numa versão futura.

Revisão de fechamento mensal

Você: "Quais despesas ainda não têm comprovante este mês?"

O agente:

Chama get-card-transactions___ com filtro do mês corrente
Filtra transações sem comprovante anexado
Agrupa por usuário e ordena por valor sem comprovante

Resposta esperada:

Encontrei 12 transações neste mês sem comprovante, no total de R$4.870,00:

Usuário Transações Valor
Ana Lima 4 R$2.100,00
Carlos Mendes 5 R$1.620,00
Tech Team 3 R$1.150,00

Quer que eu gere links de upload para cada uma destas transações?

Usuário	Transações	Valor
Ana Lima	4	R$2.100,00
Carlos Mendes	5	R$1.620,00
Tech Team	3	R$1.150,00

Fluxo de caixa e previsão de limite

Você: "Quanto vou gastar até o fim do mês no ritmo atual — vou exceder o limite?"

O agente:

Chama get-credit-card-limit___ para obter o limite disponível
Chama get-card-transactions___ para o gasto do mês
Calcula o ritmo diário e projeta até ao fim do mês

Resposta esperada:

Limite disponível da conta de cartão: R$80.000,00 Gasto do mês até agora: R$48.200,00 (60,3%)

Ao ritmo diário atual de R$2.230,00/dia, o gasto previsto no fim do mês é R$66.900,00 — sobrando R$13.100,00 de folga.

Neste mês, não há risco aparente de exceder o limite

Anexar comprovante

Você: "Tenho aqui uma fatura — anexe para mim"

O agente:

Chama get-card-transactions___ para identificar a transação sem comprovante mais relevante
Chama create-expense-proof___ para gerar URL de upload assinada
Retorna a URL para o arquivo (PDF, PNG ou JPEG)
Pode chamar get-expense-proof___ após o upload para confirmar a vinculação

Resposta esperada:

Encontrei a transação correspondente: Restaurante Figueira Rubaiyat — R$340,00 em 29 de mar.

Foi criado um link seguro de upload para a fatura (válido por 15 minutos):

https://upload.contasimples.com/receipts/signed/xyz789...

Faça upload do PDF, PNG ou JPEG; o comprovante será associado automaticamente após o upload.

Mapa de capacidades e exemplos

Fechamento e controle mensal

Pergunta (exemplo)	Ferramentas	Estado
"Quais despesas ainda estão sem comprovante neste mês?"	`get-card-transactions___`	✅
"Qual é o total gasto por categoria nesta semana em comparação com a semana passada?"	`get-card-transactions___` `get-categories___`	✅
"Qual percentual das transações tem comprovante versus está sem comprovante em março?"	`get-card-transactions___`	✅
"Quais usuários têm o maior volume de gastos sem comprovante?"	`get-card-transactions___` `get-users___`	✅
"Há despesas fora da política de gastos nos últimos 30 dias?"	`get-card-transactions___` + policy tools	⏳
"Liste todas as transações que violam uma política de controle ativa"	`get-card-transactions___` + policy tools	⏳
"Há transações com fornecedores não cadastrados no sistema?"	`get-card-transactions___` + supplier tools	⏳

Fluxo de caixa e crédito

Pergunta (exemplo)	Ferramentas	Estado
"Qual é o saldo disponível da conta de cartão neste momento?"	`get-cards___` `get-credit-card-limit___`	✅
"Qual é a projeção de gastos até o fim do mês — vou exceder o limite da conta?"	`get-card-transactions___` `get-credit-card-limit___`	✅
"Tenho algum pagamento recorrente que aumentou de valor?"	`get-banking-transactions___`	✅
"Como o limite da conta de cartão está distribuído entre os cartões ativos?"	`get-cards___` `get-credit-card-limit___`	✅
"Quais saídas de caixa se repetem todo mês nesta data?"	`get-banking-transactions___`	✅
"Qual é o saldo disponível na conta corrente neste momento?"	banking balance tool	⏳
"Há algum fornecedor recorrente com o qual valha negociar pagamento antecipado?"	`get-banking-transactions___` + supplier tools	⏳

Gestão de cartões e equipe

Pergunta (exemplo)	Ferramentas	Estado
"Quem tem um cartão bloqueado?"	`get-cards___`	✅
"Quais membros da equipe não usaram o cartão neste mês?"	`get-users___` `get-card-transactions___`	✅
"Há cartões com gastos concentrados em uma única categoria — possível uso indevido?"	`get-cards___` `get-card-transactions___`	✅
"Qual é o ranking de usuários por volume de gastos neste trimestre?"	`get-users___` `get-card-transactions___`	✅
"O limite de algum cartão está próximo do limite total da conta de cartão?"	`get-cards___` `get-credit-card-limit___`	✅
"Criar um cartão virtual para o centro de custo X com limite Y"	card creation tool	⏳
"Bloquear o cartão do usuário X"	card blocking tool	⏳
"Desbloquear o cartão do usuário X"	card unblocking tool	⏳
"Bloquear cartões de todos os usuários que gastaram mais de R$X neste mês"	`get-card-transactions___` + blocking tool	⏳

Fluxo de comprovantes

Pergunta (exemplo)	Ferramentas	Estado
"Tenho uma nota fiscal aqui — anexe para mim"	`create-expense-proof___` `get-expense-proof___`	✅
"Acabei de voltar de uma viagem e preciso fazer upload de todos os comprovantes de uma vez"	`create-expense-proof___` `get-expense-proof___`	✅
"O financeiro pediu os comprovantes do jantar de ontem — você pode anexá-los?"	`create-expense-proof___` `get-expense-proof___`	✅

Conciliação e contabilidade

Pergunta (exemplo)	Ferramentas	Estado
"Quais transações ainda não foram categorizadas?"	`get-card-transactions___` `get-categories___`	✅
"Agrupe as despesas de viagem deste mês por usuário"	`get-card-transactions___` `get-categories___`	✅
"Exporte todas as despesas de março para integração com o ERP"	`get-card-transactions___`	✅
"Há lançamentos bancários sem categoria há mais de 7 dias?"	`get-banking-transactions___` `get-categories___`	✅
"Gere o relatório de despesas por usuário para auditoria"	`get-card-transactions___` `get-users___`	✅
"Liste as transações em que o CNPJ do OCR não corresponde ao fornecedor cadastrado"	`get-card-transactions___` + supplier tools	⏳

Brasil (fiscal e compliance)

Pergunta (exemplo)	Ferramentas	Estado
"Há alguma despesa que possa ser dedutível para IRPJ neste mês?"	`get-card-transactions___` `get-categories___`	✅
"Qual é o IOF acumulado em transações internacionais neste mês?"	`get-card-transactions___`	✅
"Identifique pagamentos a fornecedores PJ que possam exigir retenção de IRRF"	`get-banking-transactions___` + supplier tools	⏳
"Há notas fiscais com CNPJ inconsistente em relação à categoria lançada?"	`get-card-transactions___` + supplier tools	⏳
"Quais saídas bancárias deste mês não têm uma nota fiscal emitida correspondente?"	`get-banking-transactions___` + supplier tools	⏳

Fluxos autônomos multi-ferramenta

Pergunta (exemplo)	Ferramentas	Estado
"Para cada transação sem comprovante há mais de 5 dias, crie o comprovante e envie a URL de upload para o usuário responsável"	`get-card-transactions___` `create-expense-proof___` `get-users___`	✅
"Com base no ritmo atual de gastos, em quantos dias o limite da conta de cartão será atingido?"	`get-card-transactions___` `get-credit-card-limit___`	✅
"Monte o relatório mensal completo por usuário: gastos, cartões ativos, comprovantes pendentes e desvios"	`get-users___` `get-cards___` `get-card-transactions___` `get-expense-proof___`	✅
"Após o fechamento do lote de OCR, consolide os itens confirmados e inconclusivos e apresente para revisão"	`create-expense-proof___` `get-expense-proof___` + OCR tools	⏳
"Bloqueie automaticamente os cartões dos usuários que excederam o limite de gastos da categoria"	`get-card-transactions___` + policy + blocking tools	⏳
"Detecte transações fracionadas que, somadas por fornecedor, excedam o limite de aprovação"	`get-card-transactions___` + supplier + policy tools	⏳

Autenticação e segurança

O Conta Simples MCP usa OAuth 2.0 para autenticar a sua conta de usuário:

Na primeira utilização, abre-se o Internet Banking no browser
Após autorizar, o servidor MCP recebe um token de acesso com escopos
Os tokens são armazenados de forma segura e renovados antes de expirar

Permissões

As ferramentas disponíveis dependem dos escopos que autorizar no login e do seu papel na empresa:

Escopo	Ferramentas ativas
`statements:read`	`get-card-transactions___`, `get-banking-transactions___`
`cards:read`	`get-cards___`, `get-credit-card-limit___`
`users:read`	`get-users___`
`categories:read`	`get-categories___`
`receipts:read`	`get-expense-proof___`
`receipts:write`	`create-expense-proof___`

Você pode revisar e revogar o acesso do MCP a qualquer momento nas configurações do Internet Banking.

Limites de requisição

O Conta Simples MCP aplica limites de requisição para manter a estabilidade. Quando excedidos, o agente recebe 429 Too Many Requests e pode repetir a requisição com backoff exponencial.

Política de privacidade

O Conta Simples MCP opera no âmbito da política de privacidade Conta Simples, que descreve a coleta, o uso, o armazenamento e o compartilhamento dos seus dados ao conectar a conta a agentes de IA. Documento completo: Política Corporativa de Privacidade e Cookies (PDF).

Ao autorizar o servidor MCP, você aceita os termos da política de privacidade e cookies. Você pode revisar e revogar o acesso do MCP a qualquer momento no Internet Banking.

Suporte

Se tiver problemas para conectar a conta ou a usar o Conta Simples MCP, nossa equipe de suporte está disponível em:

Canal	Contato	Disponibilidade
WhatsApp	(11) 3003-0640	24/7 (atendimento humano seg–sáb, 8h–20h)
Email	meajuda@contasimples.com	Resposta em até 1 dia útil
Telefone	(11) 3003-0640 ou grátis 0800-887-0640	seg–sex, 9h30–17h30
Ouvidoria	ouvidoria@contasimples.com ou 0800-887-0608	seg–sex, 9h–18h

Em questões de MCP, indique o nome do cliente MCP e a descrição do erro. Isso ajuda a nossa equipe a resolver mais depressa.

Limitações

Operações financeiras (pagamentos, transferências) ainda não estão disponíveis via MCP e estão planejadas para versões futuras
O servidor processa dados em tempo real e não mantém estado local entre sessões

Próximos passos

Developer MCP

Obtenha ajuda com IA para integrar a API.

Visão geral dos MCP

Conheça todos os servidores MCP e como escolher o certo.

Was this page helpful?