Fakturoid
Official MCP server for Fakturoid — Czech invoicing for freelancers and small businesses.
Что умеет
- Accounts: Manage user accounts. Use action=index first to discover available account slugs, then action=show for full details.
- Subjects: Manage contacts (subjects). Use action=index to list, action=show for details, action=create to add new contact, action=search for fulltext search.
- Invoices: Manage invoices. Use action=index to list (with optional filters), action=show for full details, action=create to issue new invoice, action=search for fulltext search, action=pay to record a
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Official MCP server for Fakturoid — Czech invoicing for freelancers and small businesses. Issue invoices, check overdue receivables, manage contacts, expenses and bank accounts directly from your AI assistant.
Fakturoid is a Czech invoicing platform (since 2009, 500k+ invoices/month). Its MCP server lets AI assistants work with your invoices, expenses, contacts, bank accounts and document inbox (Krabice) — create an invoice, check what's overdue, add a contact, or upload a receipt, all in natural language without logging into the app.
Как подключить
Как подключить Fakturoid к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://fakturoid--fakturoid.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Fakturoid к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://fakturoid--fakturoid.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Fakturoid к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://fakturoid--fakturoid.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (7)
Технические названия из tools/list. Нужны только разработчикам.
| accounts | Manage user accounts. Use action=index first to discover available account slugs, then action=show for full details. |
| subjects | Manage contacts (subjects). Use action=index to list, action=show for details, action=create to add new contact, action=search for fulltext search. |
| invoices | Manage invoices. Use action=index to list (with optional filters), action=show for full details, action=create to issue new invoice, action=search for fulltext search, action=pay to record a payment on a regular invoice or proforma (proforma_followup_document controls what is created when proforma is paid). Create a subject first using subjects tool. For revenue sums, filter by document_type (invoice, proforma, correction, tax_document) — these categories are disjoint and safe to sum separately; summing across them double-counts. Use issued_from/issued_to for historical analysis by issue date (works for retroactively dated documents); since filters by created_at, not issued_on. Use order=asc for chronological walks. To check whether an invoice is paid, use status (paid/open/overdue/cancelled/uncollectible) and paid_on — not remaining_amount. The remaining_amount field tracks how much of the invoice is NOT covered by a linked proforma/advance (equals total for regular invoices, regardless of payments), not the outstanding balance. |
| expenses | Manage expenses. Use action=index to list (with optional filters), action=show for full details, action=create to record a new expense, action=search for fulltext search, action=add_attachment to attach a file to an existing expense (returns upload instructions for curl), action=mark_as_paid to mark expense as paid (creates payment for remaining amount). Create a subject first using subjects tool. |
| bank_accounts | List bank accounts for an account. Use before creating invoices to check available accounts and their IDs. |
| inbox_files | Manage inbox files (Krabice). Use action=index to list uploaded files, action=create to upload a file (returns upload instructions for curl), action=send_to_ocr to send a file for document extraction. |
| reports | Aggregate financial reports. Use action=yearly to get income/expense/profit totals broken down by month, quarter, or year. For period=month or quarter, totals equal the sum of lines for the requested year. For period=year, response contains 4 lines (current year and 3 previous years) for trend context, while totals reflect only the requested year. Choose date_column based on what you want to measure: issued_on for revenue analysis (what was billed), taxable_fulfillment_due for VAT periods (what is reportable for VAT returns), paid_on for cash actually received/spent on documents, cashflow for bank-account cashflow including payments without documents (always with VAT). When the response contains payment_summary (date_column=cashflow or paid_on with period=year), always display its adjustment (payment adjustment) and rate_difference (exchange rate difference) alongside the totals table — they show the gap between document amounts and actual payments. |