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 de IA utilizam os mesmos dados de conexão abaixo.

🔐 Sobre o Client ID: o Client ID fornecido neste guia é uma chave pública e padrão para todas as integrações — não é uma senha. Serve apenas para identificar o serviço que está se conectando. A proteção dos dados financeiros é garantida no login, que exige as credenciais de acesso à Conta Simples e a validação pelo token de segurança.

Claude (web e desktop)

A configuração visual é a mesma para o Claude na web (claude.ai) e o Claude Desktop. Se a preferência for configurar o Claude Desktop via arquivo, utilize a Opção B.

Opção A — Interface visual

1. Acesse Personalizar → Conectores
2. Clique no botão “+” e selecione Adicionar conector personalizado
3. Preencha os campos:
   • Nome: Conta Simples (ou outro nome de identificação)
   • URL: https://mcp.contasimples.com/mcp
4. Expanda Configurações avançadas e insira o Client ID: 72ic737n3eng9k1l3s02kbeplk
5. Selecione Adicionar

Siga os passos de Autorização da conta abaixo para concluir.
 

Opção B — Arquivo de configuração (Claude Desktop)

1. Acesse o arquivo claude_desktop_config.json no computador
2. Insira o bloco abaixo dentro de mcpServers:

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

3. Salve o arquivo e inicie o Claude Desktop

Siga os passos de Autorização da conta abaixo para concluir.
 

Claude Code

1. Inicie o Claude Code no terminal
2. Execute o comando abaixo:

claude mcp add --transport http \
  --client-id 72ic737n3eng9k1l3s02kbeplk \
  --callback-port 8080 \
  conta-simples https://mcp.contasimples.com/mcp

A porta 8080 é obrigatória — deve corresponder exatamente ao valor registrado para este Client ID.

Siga os passos de Autorização da conta abaixo para concluir.

Cursor

Opção A — Interface visual

1. Acesse Settings → Cursor Settings → MCP
2. Selecione a opção para adicionar um novo servidor remoto
3. Preencha os campos:
   • Nome: Conta Simples
   • URL: https://mcp.contasimples.com/mcp
4. No campo de autenticação, insira o Client ID: 72ic737n3eng9k1l3s02kbeplk
5. Confirme a criação

Siga os passos de Autorização da conta abaixo para concluir.

Opção B — Arquivo de configuração

1. Acesse o arquivo ~/.cursor/mcp.json
2. Insira o bloco abaixo dentro de mcpServers:

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

3. Salve o arquivo

Siga os passos de Autorização da conta abaixo para concluir.

ChatGPT

1. Acesse Configurações → Aplicativos → Configurações Avançadas
2. Selecione a opção para adicionar um novo aplicativo conectado
3. Preencha os campos:
   • Nome: Conta Simples
   • URL do servidor MCP: https://mcp.contasimples.com/mcp
   • Autenticação: OAuth
   • Client ID: 72ic737n3eng9k1l3s02kbeplk
4. Salve as definições

Siga os passos de Autorização da conta abaixo para concluir.

Gemini CLI

1. Confirme que o Gemini CLI está instalado e operacional
2. Acesse o arquivo ~/.gemini/settings.json
3. Insira o bloco abaixo dentro de mcpServers:

{
  "mcpServers": {
    "conta-simples": {
      "url": "https://mcp.contasimples.com/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "72ic737n3eng9k1l3s02kbeplk",
        "redirectUri": "http://localhost:7777/oauth/callback"
      }
    }
  }
}

A porta 7777 e o endereço http://localhost são obrigatórios. O uso de http://127.0.0.1 não é aceito.

4. Salve o arquivo e inicie o Gemini CLI

Siga os passos de Autorização da conta abaixo para concluir.

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!