Комплексная реализация сервера Model Context Protocol (MCP) для Fakturoid API, позволяющая моделям ИИ взаимодействовать с данными учета и выставления счетов с помощью богатого набора инструментов, ресурсов и управляемых рабочих процессов.

Обзор

Этот MCP-сервер обеспечивает полную интеграцию с Fakturoid API v3, демонстрируя весь потенциал протокола Model Context, реализуя все три основные функции MCP:

** Инструменты ** - 18+ интерактивных функций для выполнения действий на данных Fakturoid ** Ресурсы** - 10 источников контекстных данных, обеспечивающих понимание бизнеса в режиме реального времени

• ** mp Оперативность** - 6 шаблонов профессиональных рабочих процессов для общих задач бухгалтерского учета

** Размещение**: Сервер доступен по адресу https://fakturoid-mcp.cookielab.ai через Cloudflare Workers. Вы можете подключиться непосредственно к этой конечной точке при использовании режима передачи MCP HTTP.

Особенности

Инструменты ### (интерактивные функции)

Сервер обеспечивает полное покрытие Fakturoid API:

Управление учетными записями - Получать и обновлять информацию об учетных записях, включая поддержку нескольких учетных записей с помощью инструмента Change the Active Fakturoid Account

Fakturoid MCP Server

A comprehensive Model Context Protocol (MCP) server implementation for the Fakturoid API, enabling AI models to interact with accounting and invoicing data through a rich set of tools, resources, and guided workflows.

Overview

This MCP server provides a complete integration with Fakturoid API v3, demonstrating the full potential of the Model Context Protocol by implementing all three core MCP features:

• 🔧 Tools - 18+ interactive functions for performing actions on Fakturoid data
• 📚 Resources - 10 contextual data sources providing real-time business insights
• 💡 Prompts - 6 professional workflow templates for common accounting tasks

👉 Hosted deployment: The server is publicly available at https://fakturoid-mcp.cookielab.ai via Cloudflare Workers. You can connect directly to this endpoint when using the MCP HTTP transport mode

Features

Tools (Interactive Functions)

The server implements comprehensive coverage of the Fakturoid API:

• Account Management - Get and update account information, including multi-account support via switching using the Change the Active Fakturoid Account tool
• Invoice Operations - Full CRUD operations, search, filtering, and PDF generation
• Expense Tracking - Create, read, update, delete, and categorize expenses
• Contact Management - Manage subjects (companies and individuals)
• Payment Processing - Track and manage invoice and expense payments
• Document Management - Upload and manage files through inbox
• Advanced Features - Recurring generators, inventory management, webhooks

Resources (Contextual Data)

Real-time business context through custom fakturoid:// URI scheme:

• fakturoid://account - Account information and settings
• fakturoid://dashboard/summary - Financial overview and key metrics
• fakturoid://invoices/recent - Latest 20 invoices
• fakturoid://invoices/open - All unpaid invoices
• fakturoid://invoices/overdue - Overdue invoices requiring attention
• fakturoid://expenses/recent - Recent business expenses
• fakturoid://expenses/open - Unpaid expenses
• fakturoid://subjects/recent - Recently added contacts
• fakturoid://subjects/customers - Customer contacts
• fakturoid://subjects/suppliers - Supplier contacts

Prompts (Workflow Templates)

Professional templates for common accounting workflows:

• create_invoice - Guided invoice creation with best practices
• expense_categorization - Tax-compliant expense handling
• payment_followup - Professional payment reminder communications
• monthly_summary - Comprehensive financial reporting
• tax_preparation - Tax documentation organization
• client_analysis - Customer relationship and profitability analysis

Installation

Prerequisites

• Node.js 24.2.0 (see .node-version)
• pnpm package manager
• Fakturoid API credentials

Setup

1. Clone the repository:

   git clone