MCP Server Adfin

🚀 Adfin Integration with Claude Desktop

This project enables seamless integration of Adfin tools with the Claude desktop application, allowing users to leverage Adfin's functionalities through the AI assistant in Claude.

🚀 Quick Start

📦 Installation

• Python Version Requirement: Python 3.10 or higher is required.
• Install uv:
  • MacOS/Linux: Run the following command in your terminal:

curl -LsSf https://astral.sh/uv/install.sh | sh

- **Windows**: Run the following command in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

⚙️ Configuration

1. Download Claude Desktop: Get the Claude Desktop.
2. Edit Configuration:
   • Open Claude and go to Settings > Developer > Edit Configuration.
   • Modify the claude_desktop_config.json file as follows:

{
  "mcpServers": {
    "Adfin": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "main_adfin_mcp.py"
      ],
      "env": {
        "ADFIN_EMAIL": "<your_email>",
        "ADFIN_PASSWORD": "<your_password>"
      }
    },
    "filesystem": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "filesystem.py"
      ]
    }
  }
}

3. Restart Claude Desktop: After modifying the configuration file, restart the Claude desktop application.

💻 Usage Examples

🚀 First Launch

When you first open the Claude desktop application, it may take 10 - 20 seconds for the Adfin tools to appear because the necessary packages need to be installed and the latest Adfin API documentation needs to be downloaded.

🚀 Daily Use

Each time you start the Claude desktop application, the latest Adfin API tools will be available to your AI assistant. Here are some examples of how to use the Adfin tools through the AI assistant:

Request Credit Control Status

Give me a credit control status report.

Create a New Invoice

Generate an invoice for £60 for the customer Abe Dave, due in one week. His email address is abc.def@example.com.

Upload Multiple Invoices from Your Folder

Upload all PDF invoices from my desktop invoices folder.