Conector MCP Conta Simples

Neste artigo você irá encontrar:

• O que é o conector MCP
• Sugestões de prompts e casos de uso
• Aplicativos compatíveis
• Antes de começar
• Configuração por aplicativo
  • Dados necessários
  • Claude (web e desktop)
  • Claude Code
  • Cursor
  • ChatGPT
  • Gemini CLI
  • Autorização da conta (primeiro acesso)
• Solução de problemas
• Perguntas frequentes

O que é o conector MCP

O conector MCP integra a Conta Simples a assistentes de inteligência artificial como Claude, Cursor e ChatGPT. Com a integração ativa, é possível consultar transações, verificar comprovantes, analisar gastos e executar tarefas financeiras diretamente no assistente — sem precisar alternar entre sistemas.

🔒 As permissões da Conta Simples acompanham o usuário. O conector respeita o perfil e os acessos de cada pessoa. O assistente de IA só visualiza dados e executa ações que o usuário autenticado já tem permissão de realizar na Conta Simples.

Sugestões de prompts e casos de uso

Com o conector ativo, é possível usar linguagem natural para executar tarefas financeiras. Abaixo, sugestões por perfil de uso.

Para times financeiros

Fechamento e controle de período

Identifique pendências de comprovação e analise gastos por categoria antes de fechar o período — sem exportar planilhas manualmente.

• "Quais despesas estão sem comprovante este mês?"
• "Com base neste documento de políticas, existem transações fora da política de gastos nos últimos 30 dias?"
• "Compare o total por categoria esta semana com a semana passada"
• "Qual o percentual de transações com e sem comprovante em março?"

Conciliação e contabilidade

Agrupe e filtre transações para conciliação contábil ou auditoria interna com mais agilidade.

• "Quais transações de março ainda não têm comprovante anexado?"
• “Quais transações ainda não tem centro de custos ou não foram categorizadas”
• "Agrupe as despesas de viagem deste mês por colaborador"
• "Exporte todos os gastos de março com comprovante para o ERP"

Cartões e limites

Consulte o status de cartões e limites disponíveis sem acessar a plataforma.

• "Qual é o limite disponível nos cartões corporativos?"
• "Quais colaboradores têm cartão bloqueado?"
• "Exiba todos os cartões virtuais e os respectivos status"
• "Quem na equipe tem cartão ativo?"

Para colaboradores

Comprovantes e notas fiscais

Anexe comprovantes de despesas diretamente na conversa, sem precisar acessar a plataforma.

• "Quais transações do meu cartão estão sem comprovante?"
• "Anexar este comprovante na respectiva transação"

Consulta de gastos

Acesse o histórico e total de gastos do cartão sem navegação pela plataforma.

• "Quais foram os gastos do meu cartão nos últimos 7 dias?"
• "Qual o total gasto no meu cartão este mês?"
   

Aplicativos compatíveis

Antes de começar

Para configurar o conector, é necessário ter:

• Conta ativa na Conta Simples
• Um dos aplicativos compatíveis instalado ou com plano ativo
• Aplicativo da Conta Simples atualizado no celular — necessário para gerar o código de segurança no primeiro acesso

Configuração por aplicativo

Dados necessários

Todos os aplicativos usam o mesmo endereço do servidor MCP da Conta Simples:

https://mcp.contasimples.com/mcp

Na primeira conexão, o navegador abre a tela de login do Internet Banking. Não há chave de API nem senha para copiar. Alguns aplicativos pedem também um Client ID público, informado no passo a passo de cada um.

Depois de configurar o aplicativo, conclua o acesso seguindo os passos de Autorização da conta (primeiro acesso).

Claude (web e desktop)

1. No Claude, acesse Configurações → Conectores.
2. Clique em Adicionar conector personalizado.
3. Em Nome, informe Conta Simples.
4. Em URL do servidor MCP remoto, informe https://mcp.contasimples.com/mcp.
5. Salve e ative o conector no menu de ferramentas da conversa.

Deixe as Configurações avançadas em branco: o Claude não precisa de Client ID. A configuração é a mesma para o Claude na web e no Claude Desktop.

Nos planos Team e Enterprise, apenas os proprietários da organização podem adicionar conectores personalizados.

Claude Code

1. No terminal, execute:

claude mcp add --transport http conta-simples https://mcp.contasimples.com/mcp

2. Use qualquer ferramenta do conector. O login abre no navegador no primeiro uso.

Não use as opções --client-id nem --callback-port. A porta de retorno muda a cada execução, e isso é esperado.

Cursor

1. Acesse Settings → Tools & MCPs e clique em New MCP Server.
2. Cole o bloco abaixo e salve:

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

3. Reinicie o Cursor. O login abre no navegador no primeiro uso.

O Cursor ainda não faz a identificação automática, por isso precisa do CLIENT_ID. O valor é público, igual para todos e não é uma senha.

ChatGPT

1. Acesse Configurações → Aplicativos → Configurações avançadas e ative o Modo de desenvolvedor.
2. Em Configurações → Aplicativos, clique em Criar aplicativo e preencha:
   • Nome: Conta Simples
   • URL do servidor MCP: https://mcp.contasimples.com/mcp
   • Autenticação: OAuth
3. Salve e conclua o login no navegador.

Deixe o campo ID do cliente em branco: o ChatGPT não precisa de Client ID.

Gemini CLI

1. Edite o arquivo ~/.gemini/settings.json e adicione:

{
  "mcpServers": {
    "conta-simples": {
      "httpUrl": "https://mcp.contasimples.com/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "72ic737n3eng9k1l3s02kbeplk"
      }
    }
  }
}

2. No terminal, execute gemini e, em seguida, /mcp auth conta-simples.
3. Conclua o login no navegador.

Não configure o campo redirectUri. O Gemini CLI escolhe uma porta livre a cada execução, e qualquer porta é aceita.

Outros agentes

Qualquer agente compatível com MCP usa a mesma URL do servidor.

1. Na configuração de servidores MCP do agente, adicione um novo servidor com a URL https://mcp.contasimples.com/mcp.
2. Se o agente perguntar o tipo de conexão, escolha HTTP ou remoto.
3. Na primeira conexão, conclua o login no navegador.

Se o agente pedir Client ID, porta fixa ou chave de API, veja Se algo não funcionar, logo abaixo.

Se algo não funcionar

O agente pede um "Client ID" ou "OAuth Client ID" obrigatório
Informe o Client ID público do conector: 72ic737n3eng9k1l3s02kbeplk. O valor é igual para todos e não é segredo. Sua conta continua protegida pelo login do Internet Banking e pelo token de segurança.

O agente pede uma porta fixa de retorno
Não é necessário. Qualquer porta é aceita: deixe o campo em branco ou use o valor padrão do agente.

O agente só aceita chave de API ou token
Ainda não é possível conectar dessa forma. A conexão é feita sempre pelo login do Internet Banking, no navegador.

Aparece um erro de endereço de retorno não registrado
O agente usa um endereço de retorno que ainda não está na nossa lista. Copie o endereço exibido na mensagem de erro e envie ao suporte, junto com o nome do agente.

O agente roda em outra máquina, no WSL ou em um container
O navegador precisa abrir na mesma máquina em que o agente está rodando. Faça o login a partir dessa máquina.

Aparece um erro que menciona "PKCE"
A versão do agente é antiga demais para conectar. Atualize o agente para a versão mais recente e tente novamente.

Autorização da conta (primeiro acesso)

O fluxo de autorização é o mesmo para todos os aplicativos. Após concluir a configuração da plataforma escolhida:

1. Uma janela do navegador abre automaticamente para o login na Conta Simples
2. Insira e-mail e senha da conta
3. Acesse o aplicativo da Conta Simples no celular, selecione Menu → Segurança → Token de segurança e insira o código de 6 dígitos exibido

O acesso fica salvo para as próximas sessões — não é necessário repetir esse processo, a não ser que o acesso seja revogado diretamente no aplicativo de IA onde o conector foi configurado.

Solução de problemas

Perguntas frequentes

• O uso do conector tem custo adicional? 
  A integração com assistentes de inteligência artificial não possui custo adicional.
   
• É possível realizar pagamentos ou transferências pela integração? 
  Ainda não. As operações de saída não estão disponíveis no momento. O conector suporta leitura de dados e ações operacionais, como a criação de comprovantes de despesa.
   
• Os dados ficam armazenados no aplicativo de IA? 
  Não. O servidor processa as informações em tempo real e não armazena o histórico financeiro entre as sessões.
   
• Como os dados são tratados em relação à LGPD? 
  A integração opera sob a Política de Privacidade da Conta Simples. O acesso ao conector pode ser revogado a qualquer momento diretamente no aplicativo de IA onde foi configurado.
   
• Como o assistente de IA consegue anexar comprovantes de despesas? 
  O assistente aciona uma ferramenta específica que cria o registro fiscal e gera um link seguro para o envio do arquivo. O comprovante é vinculado à transação automaticamente após o upload.
   
• O Client ID é o mesmo para todas as empresas? 
  Sim. O Client ID é público e serve apenas para identificar o aplicativo na conexão. A segurança é garantida pelo login com validação do token de segurança.
   
• Por que é necessário inserir um código do aplicativo no primeiro login? 
  O token de segurança confirma a identidade do usuário na autenticação em duas etapas, evitando acessos indevidos mesmo que as credenciais sejam comprometidas.

Para mais detalhes e configurações avançadas, acesse a documentação técnica oficial do MCP.
 

Se precisar de ajuda ou tiver dúvidas, nossa equipe de suporte está à disposição!