English Français العربية

io.github.SamuelMoraesF/mcp-organizze

السجل الرسمي المالية والمدفوعات

MCP para integração com o gestor financeiro Organizze. Crie transações, consulte saldos e metas.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-organizze
Claude Code 
claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -- uvx mcp-organizze==0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-organizze": {
            "command": "uvx",
            "args": [
                "mcp-organizze==0.1.2"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<your organizze_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • ORGANIZZE_EMAIL إلزامي Email de login da sua conta Organizze
  • ORGANIZZE_API_KEY إلزامي سري Sua chave de API do Organizze
OCI package samuelmoraesf/mcp-organizze
Claude Code 
claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -e 'MCP_PORT=8000' -e 'MCP_HOST=0.0.0.0' -- docker run -i --rm samuelmoraesf/mcp-organizze
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-organizze": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "samuelmoraesf/mcp-organizze"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<your organizze_api_key>",
                "MCP_PORT": "8000",
                "MCP_HOST": "0.0.0.0"
            }
        }
    }
}

متغيرات البيئة

  • ORGANIZZE_EMAIL إلزامي Email de login da sua conta Organizze
  • ORGANIZZE_API_KEY إلزامي سري Sua chave de API do Organizze
  • MCP_PORT Porta do servidor HTTP
  • MCP_HOST Host do servidor HTTP

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP Organizze
  2. ✨ Funcionalidades
  3. 🚀 Como Usar
  4. 🛠 Desenvolvimento e Publicação

MCP Organizze

Servidor MCP para integração com o gestor financeiro Organizze, compatível com qualquer cliente MCP (Claude Desktop, etc).

Este projeto expõe a API v2 do Organizze como ferramentas de IA, permitindo criar transações, consultar saldos, metas e muito mais.

✨ Funcionalidades

  • Contas: Listar, criar e detalhar contas bancárias.
  • Transações: Criar (despesas/receitas) e listar movimentações.
  • Cartões de Crédito: Listar e detalhar faturas.
  • Categorias e Metas: Gerenciamento completo.

🚀 Como Usar

Pré-requisitos

Você precisará das suas credenciais do Organizze:

  • ORGANIZZE_EMAIL: Seu email de login.
  • ORGANIZZE_API_KEY: Sua chave de API.
Opção 1: Via UVX (Recomendado)

Se você tem o uv instalado, pode rodar diretamente sem instalar nada:

# Executa em modo STDIO (padrão para Claude Desktop)
ORGANIZZE_EMAIL=seu@email.com ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

Para integrar ao Claude Desktop, adicione ao seu arquivo de configuração:

{
  "mcpServers": {
    "organizze": {
      "command": "uvx",
      "args": ["mcp-organizze"],
      "env": {
        "ORGANIZZE_EMAIL": "seu_email",
        "ORGANIZZE_API_KEY": "sua_chave_api"
      }
    }
  }
}
Opção 2: Via Docker

A imagem Docker roda por padrão em modo Streamable HTTP (SSE) na porta 8000, ideal para uso remoto ou em servidores.

Executar com SSE (Porta 8000):

docker run -p 8000:8000 \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze

Executar com STDIO (Interativo):

docker run -i \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze --transport stdio
Opção 3: Instalação Local (Pip/UV)

Clone o repositório e instale:

uv pip install .
# ou
pip install .

Rode o servidor:

python -m mcp_organizze

🛠 Desenvolvimento e Publicação

Estrutura do Projeto
  • src/mcp_organizze: Código fonte do pacote.
  • pyproject.toml: Configuração de build e dependências.
  • Dockerfile: Configuração para containerização.
  • .github/workflows: Actions para CI/CD.

الأسئلة الشائعة

ما هو io.github.SamuelMoraesF/mcp-organizze؟

MCP para integração com o gestor financeiro Organizze. Crie transações, consulte saldos e metas.

كيف أثبّت io.github.SamuelMoraesF/mcp-organizze؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -- uvx mcp-organizze==0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.SamuelMoraesF/mcp-organizze إلى مفتاح API؟

نعم. يتطلب ORGANIZZE_EMAIL, ORGANIZZE_API_KEY، وتضبطها في إعداداته.

هل io.github.SamuelMoraesF/mcp-organizze مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.SamuelMoraesF/mcp-organizze؟

ينشره SamuelMoraesF. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.