logo
MCP ServersConta Simples MCP

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, gerir 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 utilizador, limites de taxa 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

Antes de configurar o Conta Simples MCP, precisa de:

  1. Uma conta Conta Simples — Conta de utilizador ativa com acesso ao Internet Banking
  2. 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 definições OAuth num objeto auth na entrada do servidor — daí o CLIENT_ID ali — e reencaminham-no como cabeçalho HTTP CLIENT_ID. Use o formato de configuração documentado para o seu cliente.

DefiniçãoValor
URLhttps://mcp.contasimples.com/mcp
CabeçalhoCLIENT_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-o tal como no exemplo. Integre este bloco no ficheiro completo de definições MCP do cliente, conforme a respetiva documentação.

Ligar 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 utilizador e autorize o MCP a aceder à sua conta.

Iniciar o servidor MCP

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

Iniciar sessão na Conta Simples

Abre-se a página de login Conta Simples. 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. Pode revogar a qualquer momento no Internet Banking.

Pronto a utilizar

Com a autorização, o servidor MCP guarda a sessão e renova tokens automaticamente. Pode interagir com o assistente de IA de imediato.

A autorização persiste entre sessões. Só precisa de voltar a autenticar se revogar o acesso ou a sessão expirar.

Ferramentas disponíveis

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

Transações

FerramentaDescriçãoLê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)✅

Utilizadores

FerramentaDescriçãoLêEscreve
get-users___Lista utilizadores da empresa, com filtro, seleção de campos e paginação✅

Cartões e limites

FerramentaDescriçãoLê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

FerramentaDescriçãoLêEscreve
get-categories___Lista categorias padrão e personalizadas, com ID, nome, tipo e carimbos de data✅

Comprovantes de despesa

FerramentaDescriçãoLêEscreve
create-expense-proof___Cria comprovante e devolve URL assinada para carregar ficheiro (PDF, PNG ou JPEG)✅
get-expense-proof___Obtém comprovante por ID: estado de vinculação, OCR, transação ligada e URL do ficheiro✅

Exemplos de fluxos

O Conta Simples MCP cobre muitas intenções em linguagem natural nas operações financeiras. Seguem-se três exemplos; 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:

  1. Chama get-card-transactions___ com filtro do mês corrente
  2. Filtra transações sem comprovante anexado
  3. Agrupa por utilizador e ordena por valor sem comprovante

Resposta esperada:

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

UtilizadorTransaçõesValor
Ana Lima4R$2.100,00
Carlos Mendes5R$1.620,00
Tech Team3R$1.150,00

Quer que eu gere ligações de carregamento para cada uma destas transações?

Fluxo de caixa e previsão de limite

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

O agente:

  1. Chama get-credit-card-limit___ para obter o limite disponível
  2. Chama get-card-transactions___ para o gasto do mês
  3. Calcula o ritmo diário e projecta 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 actual 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 aparenta risco de exceder o limite.

Anexar comprovante

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

O agente:

  1. Chama get-card-transactions___ para identificar a transação sem comprovante mais relevante
  2. Chama create-expense-proof___ para gerar URL de upload assinada
  3. Devolve a URL para o ficheiro (PDF, PNG ou JPEG)
  4. 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 criada uma ligação segura de upload para a fatura (válida 15 minutos):

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

Carregue o PDF, PNG ou JPEG; o comprovante será associado automaticamente após o upload.

Mapa de capacidade

Fechamento e controlo mensal

Pergunta (exemplo)FerramentasEstado
"Which expenses are still missing receipts this month?"get-card-transactions___✅
"What is the total spend by category this week vs. last week?"get-card-transactions___ get-categories___✅
"What percentage of transactions have receipts vs. are missing receipts in March?"get-card-transactions___✅
"Who are the users with the highest volume of unreceipted spending?"get-card-transactions___ get-users___✅
"Are there any expenses outside the spending policy in the last 30 days?"get-card-transactions___ + policy tools⏳
"List all transactions violating an active control policy"get-card-transactions___ + policy tools⏳
"Are there transactions with suppliers not registered in the system?"get-card-transactions___ + supplier tools⏳

Fluxo de caixa e crédito

Pergunta (exemplo)FerramentasEstado
"What is my available balance on the card account right now?"get-cards___ get-credit-card-limit___✅
"What is the projected spend until end of month — will I exceed the account limit?"get-card-transactions___ get-credit-card-limit___✅
"Do I have any recurring payment that increased in value?"get-banking-transactions___✅
"How is the card account limit distributed across active cards?"get-cards___ get-credit-card-limit___✅
"Which cash outflows recur every month on this date?"get-banking-transactions___✅
"What is my available balance in the checking account right now?"banking balance tool⏳
"Is there any recurring supplier worth negotiating early payment?"get-banking-transactions___ + supplier tools⏳

Gestão de cartões e equipa

Pergunta (exemplo)FerramentasEstado
"Who has a blocked card?"get-cards___✅
"Which team members haven't used their card this month?"get-users___ get-card-transactions___✅
"Are there cards with spending concentrated in a single category — possible misuse?"get-cards___ get-card-transactions___✅
"What is the ranking of users by spending volume this quarter?"get-users___ get-card-transactions___✅
"Is any card's limit close to the total card account limit?"get-cards___ get-credit-card-limit___✅
"Create a virtual card for cost center X with limit Y"card creation tool⏳
"Block the card for user X"card blocking tool⏳
"Unblock the card for user X"card unblocking tool⏳
"Block cards for all users who spent more than R$X this month"get-card-transactions___ + blocking tool⏳

Fluxo de comprovantes

Pergunta (exemplo)FerramentasEstado
"I have an invoice here — attach it for me"create-expense-proof___ get-expense-proof___✅
"I just got back from a trip, I need to upload all receipts at once"create-expense-proof___ get-expense-proof___✅
"Finance asked for the receipts from yesterday's dinner — can you attach them?"create-expense-proof___ get-expense-proof___✅

Conciliação e contabilidade

Pergunta (exemplo)FerramentasEstado
"Which transactions haven't been categorized yet?"get-card-transactions___ get-categories___✅
"Group travel expenses this month by user"get-card-transactions___ get-categories___✅
"Export all March expenses for ERP integration"get-card-transactions___✅
"Are there banking entries without a category for more than 7 days?"get-banking-transactions___ get-categories___✅
"Generate the expense report by user for auditing"get-card-transactions___ get-users___✅
"List transactions where the OCR CNPJ doesn't match the registered supplier"get-card-transactions___ + supplier tools⏳

Brasil (fiscal e compliance)

Pergunta (exemplo)FerramentasEstado
"Are there any expenses that could be deductible for IRPJ this month?"get-card-transactions___ get-categories___✅
"What is the accumulated IOF on international transactions this month?"get-card-transactions___✅
"Identify payments to PJ suppliers that may require IRRF withholding"get-banking-transactions___ + supplier tools⏳
"Are there invoices with inconsistent CNPJ vs. the posted category?"get-card-transactions___ + supplier tools⏳
"Which banking outflows this month have no corresponding issued invoice?"get-banking-transactions___ + supplier tools⏳

Fluxos autónomos multi-ferramenta

Pergunta (exemplo)FerramentasEstado
"For each transaction without a receipt for more than 5 days, create the proof and send the upload URL to the responsible user"get-card-transactions___ create-expense-proof___ get-users___✅
"Based on current spending pace, in how many days will the card account limit be reached?"get-card-transactions___ get-credit-card-limit___✅
"Build the complete monthly report by user: spend, active cards, pending receipts, and deviations"get-users___ get-cards___ get-card-transactions___ get-expense-proof___✅
"After OCR batch closes, consolidate confirmed and inconclusive items and present for review"create-expense-proof___ get-expense-proof___ + OCR tools⏳
"Automatically block cards of users who exceeded the category spending limit"get-card-transactions___ + policy + blocking tools⏳
"Detect split transactions that, summed by supplier, exceed the approval threshold"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 utilizador:

  1. Na primeira utilização, abre-se o Internet Banking no browser
  2. Após autorizar, o servidor MCP recebe um token de acesso com escopos
  3. 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:

EscopoFerramentas ativas
statements:readget-card-transactions___, get-banking-transactions___
cards:readget-cards___, get-credit-card-limit___
users:readget-users___
categories:readget-categories___
receipts:readget-expense-proof___
receipts:writecreate-expense-proof___

Pode rever e revogar o acesso do MCP a qualquer momento nas definições do Internet Banking.

Limites de taxa

O Conta Simples MCP aplica limites de taxa 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 recolha, o uso, o armazenamento e a partilha dos seus dados ao ligar a conta a agentes de IA. Documento completo: Política Corporativa de Privacidade e Cookies (PDF).

Ao autorizar o servidor MCP, aceita os termos da política de privacidade e cookies. Pode revogar a qualquer momento no Internet Banking.

Suporte

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

CanalContactoDisponibilidade
WhatsApp(11) 3003-064024/7 (atendimento humano seg–sáb, 8h–20h)
Emailmeajuda@contasimples.comResposta em até 1 dia útil
Telefone(11) 3003-0640 ou grátis 0800-887-0640seg–sex, 9h30–17h30
Ouvidoriaouvidoria@contasimples.com ou 0800-887-0608seg–sex, 9h–18h

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

Limitações

  • Operações financeiras (pagamentos, transferências) ainda não estão disponíveis via MCP e estão planeadas 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?

Last updated today

Built with Documentation.AI