mcp -adfin

This MCP serverset provides automation tools for interacting with Adfin via Claude Desktop. The Adfin entry runs the main Adfin MCP module (main_adfin_mcp.py) which exposes business workflow capabilities such as credit control status checks and invoice creation. The filesystem entry runs a separate module (filesystem.py) that offers file-based operations within the configured Adfin MCP environment. After configuring Claude Desktop as shown, your assistant gains access to the most recent Adfin API tools automatically on startup. The included environment variables (ADFIN_EMAIL and ADFIN_PASSWORD) are used to authenticate with Adfin if your workflow requires direct account access. Example prompts you might use include asking for a credit control status, creating invoices, or uploading multiple invoices from a folder, all mediated by the Claude Desktop integration.

Prerequisites:\n- Python 3.10 or higher installed on your system.\n- uv (the unified interface for Claude tools) installed via the installation script.\n\nStep-by-step installation:\n1) Install uv:\n - macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh\n - Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"\n2) Prepare MCP directory (any path you will reference as <absolute_path_to_adfin_mcp_folder>). This directory should contain main_adfin_mcp.py and filesystem.py as used by the MCP configuration.\n3) Configure Claude Desktop to point to the MCP scripts:\n - Open Claude Desktop settings: Developer > Edit Config.\n - Update claude_desktop_config.json with the Adfin entries shown in the mcp_config section, ensuring <home_path> is your home directory and <absolute_path_to_adfin_mcp_folder> points to the location of the MCP scripts.\n4) Launch Claude Desktop. The first launch may take 10-20 seconds as dependencies are installed and API docs are fetched.\n5) Authenticate if prompted using the provided ADFIN_EMAIL and ADFIN_PASSWORD. After setup, you can start issuing natural language requests that map to the MCP’s capabilities.\n\nNotes:\n- If you change the MCP folder location, update the <absolute_path_to_adfin_mcp_folder> accordingly.\n- Ensure the environment variables ADFIN_EMAIL and ADFIN_PASSWORD are kept secure and not shared publicly.

Tips and caveats:\n- The Adfin MCP exposes actions via main_adfin_mcp.py and filesystem.py. Use prompts that map to the available actions (e.g., credit control status, creating invoices, uploading invoices).\n- If you encounter authentication issues, verify that the email/password are correct and that the uv tool is properly installed and in your PATH.\n- The first run may be slower as dependencies are installed and Adfin API docs are downloaded; subsequent runs should be quicker.\n- When using the filesystem tool, ensure the directory permissions allow read/write access for the files you want to process.\n- Keep your MCP scripts in the <absolute_path_to_adfin_mcp_folder> and reference them precisely in the config to avoid runtime errors.