Mini Accountant

Faturamento, despesas, IVA e multimoeda para pequenas empresas, gerenciados pelo seu assistente de IA por meio de um servidor MCP OAuth remoto — sem necessidade de colar chave de API.

GitHubExperimente este MCPPatrocinado

Documentação

Mini Accountant — configuração do MCP

Conecte seu assistente de IA ao seu espaço de trabalho Mini Accountant através do nosso servidor Model Context Protocol (MCP) hospedado. Sem configuração local, sem chaves de API — o servidor é remoto e protegido por OAuth 2.1, então você faz login uma vez com sua conta Mini Accountant e seu assistente age em seu nome.

  • Servidor: mini-accountant
  • Transporte: streamable HTTP
  • URL: https://mcp.miniaccountant.app/v1beta
  • Autenticação: OAuth 2.1 / OIDC (Authorization Code + PKCE) — você será solicitado a fazer login.

O que você pode fazer

Depois de conectado, o assistente pode:

  • Faturas — criar, ler, atualizar, excluir; adicionar/atualizar/remover posições e transações; alterar o cliente em uma fatura.
  • Clientes — criar, ler, atualizar, excluir; definir o método de pagamento de um cliente.
  • Despesas — criar, ler, atualizar, excluir; buscar despesas por período.
  • Serviços — gerenciar seu catálogo reutilizável de produtos/serviços.
  • Configurações de pagamento — gerenciar os documentos de método de pagamento que os clientes referenciam.
  • Análises — executar consultas de relatórios; obter faturas/transações/despesas para um intervalo de datas; estimar impostos para um período.
  • Conta — ler e atualizar seu perfil de usuário e configurações do aplicativo.

Habilidades guiadas e prompts (por exemplo, "criar uma fatura") também são expostos para que o assistente descubra o fluxo de trabalho correto automaticamente.

Instalação no Claude Code (plugin)

O caminho mais rápido — instala o servidor remoto como um plugin, sem arquivo de configuração manual.

/plugin marketplace add miniaccountant/mcp-setup
/plugin install mini-accountant@miniaccountant
/reload-plugins

Em seguida, execute /mcp e conclua o login OAuth quando solicitado. É isso — as ferramentas mini-accountant agora estão disponíveis na sua sessão.

Prefere não usar o marketplace? Adicione o servidor diretamente:

claude mcp add --transport http mini-accountant https://mcp.miniaccountant.app/v1beta

Conecte-se a partir de outros clientes

Mesma URL remota, mesmo login OAuth — apenas o local da configuração difere.

Conectores do Claude Desktop / claude.ai

Adicione um conector personalizado apontando para a URL do servidor:

  1. Abra Configurações → Conectores → Adicionar conector personalizado (claude.ai) ou o equivalente no Claude Desktop.
  2. Nome: Mini Accountant
  3. URL: https://mcp.miniaccountant.app/v1beta
  4. Salve, depois conecte e faça login com sua conta Mini Accountant quando solicitado.

Cursor

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

{
  "mcpServers": {
    "mini-accountant": {
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

Recarregue o Cursor e autorize o servidor quando o Cursor abrir o prompt OAuth.

VS Code (GitHub Copilot / MCP) e outros clientes

Qualquer cliente que suporte servidores MCP remotos/HTTP transmissível funciona com o mesmo endpoint. Use o formulário de servidor HTTP do cliente:

{
  "servers": {
    "mini-accountant": {
      "type": "http",
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}

Autenticação

O servidor implementa OAuth 2.1 / OpenID Connect com:

  • Concessão de Código de Autorização + PKCE (S256), tokens de atualização.
  • Registro Dinâmico de Cliente (RFC 7591) — os clientes se registram automaticamente.
  • Documentos de descoberta:
    • https://mcp.miniaccountant.app/.well-known/oauth-authorization-server
    • https://mcp.miniaccountant.app/.well-known/oauth-protected-resource
    • https://mcp.miniaccountant.app/.well-known/openid-configuration

Clientes MCP compatíveis descobrem isso automaticamente — você só precisa da URL do servidor. Os tokens são emitidos para sua conta; o assistente só pode ver e alterar seus dados.

Solução de problemas

  • 401 Unauthorized / solicitado a fazer login novamente — o token de acesso expirou (TTL de 1h). Execute novamente a ação de conectar/autorizar do cliente.
  • As ferramentas não aparecem — confirme que o cliente concluiu o fluxo OAuth (no Claude Code, execute /mcp e verifique se o servidor mostra conectado).
  • Espaço de trabalho errado — saia do conector e reconecte com a conta Mini Accountant correta.

Suporte