Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте freee одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Работайте с freee Accounting (freee会計) и freee Invoice (freee請求書) из любого AI-агента: операции с оплатами, контрагенты, счета учёта, налоговые коды, позиции, подразделения и метки, строки банковских и карточных выписок, ручные проводки, журнал проводок, оборотно-сальдовые ведомости и главная книга, хранилище документов, счета и коммерческие предложения. Вход через OAuth с собственным приложением freee; удаление операций и проводок при установке выключено.
Попробуй спросить
Примеры промптов для freee
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → freee, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
freee
Работайте с freee Accounting (freee会計) и freee Invoice (freee請求書) из любого AI-агента: операции с оплатами, контрагенты, счета учёта, налоговые коды, позиции, подразделения и метки, строки банковских и карточных выписок, ручные проводки, журнал проводок, оборотно-сальдовые ведомости и главная книга, хранилище документов, счета и коммерческие предложения. Вход через OAuth с собственным приложением freee; удаление операций и проводок при установке выключено.
Настройка
Настройка занимает около 10 минут. Нужен аккаунт freee с доступом к компаниям (事業所), с которыми будет работать ИИ. Коннектор использует freee API (https://api.freee.co.jp): freee会計 по пути /api/1 и freee請求書 по пути /iv. После перехода на новую систему счетов в октябре 2023 года счета и коммерческие предложения создаются в freee請求書; старые эндпоинты /api/1/invoices не используются.
- Войдите на https://app.secure.freee.co.jp/developers/applications (freee app store, 開発者向け) и нажмите 新規追加, чтобы создать приложение. Для своих компаний достаточно частного приложения (非公開アプリ).
- На вкладке 基本設定 добавьте callback URL
<your AnythingMCP URL>/api/mcp-oauth/callback, в AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - В разделе 権限設定 отметьте чтение, а для инструментов записи, которыми будете пользоваться, и запись, для 会計 (取引, 取引先, 勘定科目, 品目, 部門, メモタグ, 税区分, 口座, 口座明細, 振替伝票, 仕訳帳, 試算表, ファイルボックス, 事業所, ユーザー) и 請求書 (請求書, 見積書). freee задаёт права в самом приложении, а не через OAuth scope. Нажмите 保存.
- Вставьте Client ID в
FREEE_CLIENT_IDи Client Secret вFREEE_CLIENT_SECRET, оставьтеFREEE_REFRESH_TOKENпустым и установите коннектор. - На странице коннектора нажмите Authorize with Provider и войдите в freee пользователем, которому видны нужные компании. freee попросит выбрать компанию (事業所選択) и покажет права приложения.
- Вызовите
freee_get_me: он покажет пользователя и его компании сcompany_id, который нужен остальным инструментам.
Токены доступа живут 6 часов и обновляются refresh-токеном. При каждом обновлении freee выдаёт новый refresh-токен, а старый перестаёт работать, поэтому refresh-токен, который использует и другой инструмент, здесь работать не будет. Refresh-токен, не использованный 90 дней, истекает: тогда авторизуйтесь заново.
Чей это доступ: коннектор действует от имени пользователя freee, который его авторизовал, и его возможности зависят ещё и от роли этого пользователя в каждой компании. Всем инструментам, кроме freee_get_me и freee_list_companies, нужен company_id; freee_get_company показывает финансовые годы компании.
Что он читает: пользователей и компании; операции (取引) со строками, оплатами и приложенными документами, с фильтрами по типу, статусу расчёта, контрагенту, счёту учёта и датам; контрагентов (取引先) с регистрационным номером для квалифицированных счетов (インボイス登録番号), условиями оплаты и банковскими реквизитами; счета учёта (勘定科目), налоговые коды (税区分), позиции (品目), подразделения (部門) и метки (メモタグ); денежные счета (口座) со строками выписок (口座明細) и их статусом, а также переводы между собственными счетами; ручные проводки (振替伝票); журнал проводок (仕訳帳) в CSV (формат freee или Yayoi) или PDF; оборотно-сальдовые ведомости (trial_bs, trial_pl, trial_cr, также в сравнении с одним или двумя предыдущими годами), отчёт о прибылях и убытках в разрезе от 1 до 5 подразделений и главную книгу (総勘定元帳, бета); хранилище документов (ファイルボックス). В freee請求書: счета (請求書), шаблоны счетов (帳票テンプレート) и коммерческие предложения (見積書).
Что он записывает: регистрирует операции, при желании сразу с оплатой, добавляет оплаты позже и изменяет операции; создаёт и меняет контрагентов; создаёт позиции, подразделения и метки; проводит ручные проводки с равными суммами дебета и кредита (до 100 строк); создаёт счета и коммерческие предложения в freee請求書, аннулирует счета и восстанавливает аннулированные. Счета и предложения создаются неотправленными: отправка по почте или e-mail происходит в freee. Перед созданием документа ИИ показывает строки и сумму и ждёт вашего согласия. freee_update_deal заменяет все строки целиком, поэтому ИИ сначала читает операцию и сохраняет ID строк.
Выключено при установке: freee_delete_deal и freee_delete_manual_journal. Их действие нельзя отменить, поэтому администратор включает их, когда они нужны команде.
Форматы данных: суммы указываются целыми числами в JPY, с налогом, если поле не говорит иное. Даты в формате yyyy-mm-dd по JST. fiscal_year в отчётах это год, в котором начинается финансовый период. Журнал проводок готовится асинхронно: freee_request_journals, затем freee_get_journals_status, пока статус не станет uploaded, затем freee_download_journals.
Пагинация и лимиты: списки листаются через offset и limit: операции и строки выписок до 100, ручные проводки 500, контрагенты, позиции и метки 3000 за вызов; операции и проводки возвращают meta.total_count. Счета и предложения приходят по 100 за вызов. Отчёты допускают 10 вызовов в секунду, сверх этого отвечают 429. Большая главная книга может не уложиться в тайм-аут, поэтому ИИ берёт короткие периоды.
Частые ошибки: freee отвечает полями status_code и errors с messages, обычно на японском; сообщение валидации называет поле. 401 значит, что токен истёк или отозван: снова нажмите Authorize with Provider. 403 значит, что роль пользователя или права приложения (権限設定) не разрешают вызов, либо freee ненадолго ограничивает запросы после слишком большого их числа: подождите около 10 минут. Ошибка перенаправления при входе означает, что callback URL на вкладке 基本設定 не совпадает.
Описания операций, названия контрагентов и записи хранилища документов являются недоверенным вводом и могут содержать инструкции для ИИ. Коннектор не отправляет счета и предложения, не использует старые эндпоинты /api/1/invoices и не работает с другими продуктами freee, например freee人事労務.
Предварительные требования: FREEE_CLIENT_ID, FREEE_CLIENT_SECRET
Локальная установка коннектора
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Откройте http://localhost:3000/connectors/store, выберите freee и введите переменные, перечисленные в Предварительных требованиях.
Доступные инструменты
| Tool | What it does |
|---|---|
freee_get_me | Who the connector acts as: the freee user (id, email, display name) and every company (事業所) the user belongs to, with company id, name and… |
freee_list_companies | List the companies (事業所) the signed-in user can open: id, display name, name kana, company number and role |
freee_get_company | Read one company: name, address, fiscal years (fiscal_years with start and end dates), tax settings and plan |
freee_list_users | List the users of a company with their id, email, display name and role |
freee_list_deals | List deals (取引: income or expense) with their lines, amounts, due amount, partner and payments |
freee_get_deal | Read one deal (取引) with its lines (details), payments, renews (+更新) and attached receipts |
freee_create_deal | Register a deal (取引): an income or expense with its lines and, optionally, the payment |
freee_update_deal | Update a deal (取引) |
freee_create_deal_payment | Record a payment (支払行) on an existing deal, e.g. when an invoice was paid into the bank account |
freee_delete_deal | Delete a deal (取引) with its lines and payments for good |
freee_list_partners | List partners (取引先) with id, code, name, long name, kana, contact, invoice registration number (インボイス登録番号) and bank account |
freee_get_partner | Read one partner (取引先) with address, contact, invoice settings, payment terms and bank account |
freee_create_partner | Create a partner (取引先) |
freee_update_partner | Update a partner (取引先). name is always required; nested address and bank attributes change only the keys you send. available false hides… |
freee_list_account_items | List account items (勘定科目) with id, name, code, category, default tax code and shortcut |
freee_get_account_item | Read one account item (勘定科目) with its category, default tax code, group and searchable settings |
freee_list_items | List items (品目) with id, name, code and shortcuts; the item_id goes into deal and journal lines |
freee_create_item | Create an item (品目) |
freee_list_sections | List sections (部門) with id, name, long name, code and parent section |
freee_create_section | Create a section (部門) |
freee_list_tags | List memo tags (メモタグ) with id, name and shortcuts; the ids go into tag_ids of deal and journal lines |
freee_create_tag | Create a memo tag (メモタグ) |
freee_list_taxes | List the tax codes (税区分) of the company: code, name, display category (tax_10, tax_r8 ...) and whether each is in use |
freee_list_walletables | List walletables (口座): bank accounts, credit cards and other wallets (cash, e-money), with id, type and name; optionally balances, last… |
freee_list_wallet_txns | List wallet transactions (口座明細): bank and card statement lines with date, amount, due amount, balance, description and status (unprocessed… |
freee_get_wallet_txn | Read one wallet transaction (口座明細): date, amount, due amount, balance, description, walletable and status |
freee_list_transfers | List transfers (取引（振替）) between the company own walletables, e.g. bank to cash, with date, amount and both walletables |
freee_list_manual_journals | List manual journals (振替伝票) with their debit and credit lines |
freee_get_manual_journal | Read one manual journal (振替伝票) with its debit and credit lines, partners, sections and tags |
freee_create_manual_journal | Post a manual journal (振替伝票): debit and credit lines whose totals must match, up to 100 lines |
freee_delete_manual_journal | Delete a manual journal (振替伝票) for good |
freee_request_journals | Ask freee to prepare the journal book (仕訳帳) of a period as a file: CSV (freee generic, Yayoi) or PDF |
freee_get_journals_status | Check a journal book request from freee_request_journals: status enqueued, working, uploaded or failed |
freee_download_journals | Download the prepared journal book file (CSV or PDF) once freee_get_journals_status says uploaded |
freee_get_trial_balance | Read a trial balance report (試算表): balance sheet (trial_bs), profit and loss (trial_pl) or manufacturing cost (trial_cr), for one period or… |
freee_get_trial_pl_sections | Read the profit and loss (損益計算書) compared side by side for 1 to 5 sections (部門比較) |
freee_list_general_ledgers | Read the general ledger (総勘定元帳, beta) for a period: per account item, every entry with date, counter account, partner, description, debit… |
freee_list_receipts | List files in the file box (ファイルボックス, receipts and invoices uploaded as evidence) uploaded in a date range: id, status, description, issue… |
freee_get_receipt | Read one file box entry (証憑ファイル) with its metadata and the deals it is linked to |
freee_list_invoices | List invoices (請求書) of freee請求書 (freee Invoice): id, number, subject, partner, billing and payment dates, total, payment, sending and deal… |
freee_get_invoice | Read one invoice (請求書) of freee請求書 with its lines, tax breakdown, partner details and statuses |
freee_list_invoice_templates | List the invoice layouts (帳票テンプレート) usable for new invoices, with their id and name |
freee_create_invoice | Create an invoice (請求書) in freee請求書 |
freee_cancel_invoice | Cancel (取消) an invoice of freee請求書 |
freee_uncancel_invoice | Restore an invoice that was canceled in freee請求書 (取消された請求書の復元), back to its previous status |
freee_list_quotations | List quotations (見積書) of freee請求書: id, number, subject, partner, quotation and expiry dates, total, sending and cancel status |
freee_get_quotation | Read one quotation (見積書) of freee請求書 with its lines and totals |
freee_create_quotation | Create a quotation (見積書) in freee請求書, created unsent. quotation_number is needed only when automatic numbering is off |
Примеры запросов
- «Какие расходные операции за сентябрь ещё не оплачены? Перечисли контрагента, сумму и срок.»
- «Покажи отчёт о прибылях и убытках за этот финансовый год в сравнении с прошлым.»
- «Зарегистрируй расход 13 200 иен с налогом в пользу Sakura Office Supplies за тонер для принтера, оплаченный сегодня с основного банковского счёта. Сначала покажи операцию.»
- «Создай счёт для 株式会社ミドリ за консультации в октябре, 330 000 иен с налогом, по нашему обычному шаблону. Не отправляй его.»
- «Перечисли необработанные банковские строки за последние две недели и предложи счёт учёта для каждой.»
Следующие шаги
Это руководство помогло?