MCP 服务器

Conta Simples MCP Server

Integrates with Conta Simples to manage business banking, credit cards, and team accounts through natural language. Provides tools for viewing statements, managing cards, categories, users, and invites.

README

Conta Simples

Conta Simples para Claude, Cursor e agentes de IA

Gestão financeira PJ no Conta Simples, extratos bancário e de cartão, cartões corporativos (listar/bloquear/desbloquear), categorias, usuários, papéis e convites. Gere suas credenciais em https://ib.contasimples.com/integracoes/api/credenciais

📊 14 ferramentas
✏️ Leitura e escrita
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Conta Simples e URL https://api.mcp.ai/p_contasimples.

Cursor

➕ Instalar Conta Simples no Cursor

VS Code (Copilot Chat)

➕ Instalar Conta Simples no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_contasimples

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Liste meus cartões corporativos ativos
Mostre o extrato bancário deste mês
Liste os convites pendentes da empresa

14 ferramentas disponíveis

Tool	Descrição
`contasimples_list_accounts`	Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição.
`contasimples_summary`	Resumo agregado do período (bancário + cartão) — uma chamada em vez de paginar centenas de transações. Retorna totais (entradas/saídas, PIX/TED, cartão compras/IOF/estorno), top categorias e top estabelecimentos, cash_flow e flags _meta (truncated se passar do limite de páginas). Período máximo 62 dias (API). Por padrão só transações bancárias processadas (status=2); include_canceled=true busca todas e exclui canceladas (status=1) dos totais, contando-as em banking.canceled_excluded. Opcional: accounts — agrega N empresas em paralelo, resposta vem em `accounts[]` (uma entrada por conta) + `errors[]` se alguma falhar. Opcional: keywords — restrinja o agregado às transações cuja descrição/contraparte/categoria/tipo contenham qualquer uma das palavras (_meta.keyword_filter mostra matched vs scanned).
`contasimples_card`	Lista cartões corporativos (crédito). Filtros opcionais: status (ACTIVATED
`contasimples_card_write_block`	Mutações em cartão: block (body reason opcional), unblock. Aceita `accounts` com 1 entrada (ou omitido em install single-account) — o card_id existe em apenas uma empresa. [Flattened action: block] Bulk support: accepts card_ids for batched execution.
`contasimples_card_write_unblock`	Mutações em cartão: block (body reason opcional), unblock. Aceita `accounts` com 1 entrada (ou omitido em install single-account) — o card_id existe em apenas uma empresa. [Flattened action: unblock] Bulk support: accepts card_ids for batched execution.
`contasimples_category`	Lista categorias financeiras. Aceita `accounts` (agrupa por conta em `accounts[]`).
`contasimples_statement_card`	Extrato de cartão de crédito. start_date e end_date (YYYY-MM-DD) emparelhados; janela ≤ 62 dias. types opcional (ex. PURCHASE). limit 5–100. Opcional: keywords — filtro textual client-side nesta página (_meta.keyword_filter). Opcional: accounts — agrega N empresas em paralelo (`accounts[]` + `errors[]`). `next_page_start_key` proibido quando accounts > 1; pagine por conta isoladamente.
`contasimples_statement_banking`	Extrato bancário (transações). start_date e end_date devem vir juntos ou omitidos. No máximo um entre amount_eq, amount_gt, amount_lt. limit 1–50. Opcional: keywords — filtro textual client-side nesta página (_meta.keyword_filter). Opcional: accounts — agrega N empresas em paralelo (`accounts[]` + `errors[]`). `next_page_start_key` proibido quando accounts > 1; pagine por conta isoladamente.
`contasimples_attachment`	Baixa anexo por ID (PNG/JPEG/PDF) — retorna content_base64, content_type, size_bytes. Aceita `accounts` com 1 entrada (ou omitido em install single-account). Bulk support: accepts attachment_ids for batched execution.
`contasimples_user`	Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita `accounts` (agrupa por conta).
`contasimples_user_write_delete`	Remove usuário da empresa (DELETE na API). action: delete. Aceita `accounts` com 1 entrada. [Flattened action: delete] Bulk support: accepts user_ids for batched execution.
`contasimples_role`	Lista papéis (roles) para convites de usuário. Aceita `accounts` (agrupa por conta).
`contasimples_invite`	Lista convites pendentes ou histórico (status, role_id, limit, next_page_start_key). Aceita `accounts` (agrupa por conta). Bulk support: accepts role_ids for batched execution.
`contasimples_invite_write_create`	Cria convite: action create com role_id e email. Aceita `accounts` com 1 entrada. [Flattened action: create] Bulk support: accepts role_ids for batched execution.

Detalhe de cada tool: docs/ferramentas.md

Preços

Grátis.

Privacidade & LGPD

Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.