{
  "markdown": "# MCP Organizze\n\nServidor MCP para integração com o gestor financeiro Organizze, compatível com qualquer cliente MCP (Claude Desktop, etc).\n\nEste projeto expõe a API v2 do Organizze como ferramentas de IA, permitindo criar transações, consultar saldos, metas e muito mais.\n\n## ✨ Funcionalidades\n\n- **Contas**: Listar, criar e detalhar contas bancárias.\n- **Transações**: Criar (despesas/receitas) e listar movimentações.\n- **Cartões de Crédito**: Listar e detalhar faturas.\n- **Categorias e Metas**: Gerenciamento completo.\n\n## 🚀 Como Usar\n\n### Pré-requisitos\n\nVocê precisará das suas credenciais do Organizze:\n- `ORGANIZZE_EMAIL`: Seu email de login.\n- `ORGANIZZE_API_KEY`: Sua chave de API.\n\n### Opção 1: Via UVX (Recomendado)\n\nSe você tem o `uv` instalado, pode rodar diretamente sem instalar nada:\n\n```bash\n# Executa em modo STDIO (padrão para Claude Desktop)\nORGANIZZE_EMAIL=seu@email.com ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze\n```\n\nPara integrar ao **Claude Desktop**, adicione ao seu arquivo de configuração:\n\n```json\n{\n  \"mcpServers\": {\n    \"organizze\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-organizze\"],\n      \"env\": {\n        \"ORGANIZZE_EMAIL\": \"seu_email\",\n        \"ORGANIZZE_API_KEY\": \"sua_chave_api\"\n      }\n    }\n  }\n}\n```\n\n### Opção 2: Via Docker\n\nA imagem Docker roda por padrão em modo **Streamable HTTP (SSE)** na porta 8000, ideal para uso remoto ou em servidores.\n\n**Executar com SSE (Porta 8000):**\n\n```bash\ndocker run -p 8000:8000 \\\n  -e ORGANIZZE_EMAIL=seu_email \\\n  -e ORGANIZZE_API_KEY=sua_chave \\\n  mcp-organizze\n```\n\n**Executar com STDIO (Interativo):**\n\n```bash\ndocker run -i \\\n  -e ORGANIZZE_EMAIL=seu_email \\\n  -e ORGANIZZE_API_KEY=sua_chave \\\n  mcp-organizze --transport stdio\n```\n\n### Opção 3: Instalação Local (Pip/UV)\n\nClone o repositório e instale:\n\n```bash\nuv pip install .\n# ou\npip install .\n```\n\nRode o servidor:\n```bash\npython -m mcp_organizze\n```\n\n## 🛠 Desenvolvimento e Publicação\n\n### Estrutura do Projeto\n\n- `src/mcp_organizze`: Código fonte do pacote.\n- `pyproject.toml`: Configuração de build e dependências.\n- `Dockerfile`: Configuração para containerização.\n- `.github/workflows`: Actions para CI/CD.\n\n<!-- mcp-name: io.github.SamuelMoraesF/mcp-organizze -->",
  "bytes": 2222,
  "sha": "d9376ecf24214b63c6208aa867f80351544a9ae7d8fb486414ad959083e561b7",
  "repo_slug": "samuelmoraesf/mcp-organizze",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_samuelmoraesf_mcp_organizze_1b0a015f/readme"
}