Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge freee mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.
Zusammenfassung
Arbeite aus jedem KI-Agent mit freee Accounting (freee会計) und freee Invoice (freee請求書): Geschäftsvorfälle mit Zahlungen, Geschäftspartner, Konten, Steuerschlüssel, Artikel, Abteilungen und Memo-Tags, Bank- und Kartenumsätze, manuelle Buchungssätze, das Journal, Summen- und Saldenlisten und das Hauptbuch, die Belegbox sowie Rechnungen und Angebote. OAuth-Anmeldung mit deiner eigenen freee-App; das Löschen von Buchungen und Journalen ist bei der Installation aus.
Frag einfach
Beispiel-Prompts für freee
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → freee klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
freee + Claude
Arbeite aus jedem KI-Agent mit freee Accounting (freee会計) und freee Invoice (freee請求書): Geschäftsvorfälle mit Zahlungen, Geschäftspartner, Konten, Steuerschlüssel, Artikel, Abteilungen und Memo-Tags, Bank- und Kartenumsätze, manuelle Buchungssätze, das Journal, Summen- und Saldenlisten und das Hauptbuch, die Belegbox sowie Rechnungen und Angebote. OAuth-Anmeldung mit deiner eigenen freee-App; das Löschen von Buchungen und Journalen ist bei der Installation aus.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
FREEE_CLIENT_ID, FREEE_CLIENT_SECRET
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 10 Minuten. Du brauchst ein freee-Konto mit Zugriff auf die Unternehmen (事業所), mit denen die KI arbeiten soll. Der Connector nutzt die freee API (https://api.freee.co.jp): freee会計 unter /api/1 und freee請求書 unter /iv. Seit der Umstellung auf das Rechnungssystem im Oktober 2023 werden Rechnungen und Angebote in freee請求書 angelegt; die alten Endpunkte /api/1/invoices werden nicht genutzt.
- Melde dich unter https://app.secure.freee.co.jp/developers/applications an (freee App Store, 開発者向け) und klick auf 新規追加, um eine App anzulegen. Eine private App (非公開アプリ) genügt für deine eigenen Unternehmen.
- Trag im Reiter 基本設定 die Callback-URL
<your AnythingMCP URL>/api/mcp-oauth/callbackein, auf AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - Hak unter 権限設定 Lesen an, und Schreiben für die schreibenden Tools, die du nutzt, und zwar für 会計 (取引, 取引先, 勘定科目, 品目, 部門, メモタグ, 税区分, 口座, 口座明細, 振替伝票, 仕訳帳, 試算表, ファイルボックス, 事業所, ユーザー) und 請求書 (請求書, 見積書). freee legt die Berechtigungen an der App fest, nicht als OAuth-Scopes. Klick auf 保存.
- Trag die Client ID in
FREEE_CLIENT_IDund das Client Secret inFREEE_CLIENT_SECRETein, lassFREEE_REFRESH_TOKENleer und installiere. - Klick auf der Connector-Seite auf Authorize with Provider und melde dich bei freee mit einem Benutzer an, der die nötigen Unternehmen sehen darf. freee lässt dich ein Unternehmen wählen (事業所選択) und zeigt die Berechtigungen der App.
- Rufe
freee_get_meauf: Es zeigt den Benutzer und seine Unternehmen mit dercompany_id, die die anderen Tools brauchen.
Access Tokens gelten 6 Stunden und werden mit dem Refresh Token erneuert. freee stellt bei jeder Erneuerung ein neues Refresh Token aus und das alte funktioniert nicht mehr; ein Refresh Token, das auch ein anderes Tool nutzt, geht hier also nicht mehr. Ein Refresh Token, das 90 Tage unbenutzt bleibt, läuft ab: Dann autorisiere erneut.
Wessen Zugang es ist: Der Connector handelt als der freee-Benutzer, der ihn autorisiert hat, und was er darf, hängt auch von dessen Rolle im jeweiligen Unternehmen ab. Jedes Tool außer freee_get_me und freee_list_companies braucht die company_id; freee_get_company zeigt die Geschäftsjahre des Unternehmens.
Was er liest: Benutzer und Unternehmen; Geschäftsvorfälle (取引) mit Positionen, Zahlungen und angehängten Belegen, gefiltert nach Art, Ausgleichsstatus, Partner, Konto und Datum; Geschäftspartner (取引先) mit Registrierungsnummer für qualifizierte Rechnungen (インボイス登録番号), Zahlungsbedingungen und Bankverbindung; Konten (勘定科目), Steuerschlüssel (税区分), Artikel (品目), Abteilungen (部門) und Memo-Tags (メモタグ); Geldkonten (口座) mit ihren Umsätzen (口座明細) und deren Status sowie Umbuchungen zwischen eigenen Konten; manuelle Buchungssätze (振替伝票); das Journal (仕訳帳) als CSV (freee-Standard oder Yayoi) oder PDF; Summen- und Saldenlisten (trial_bs, trial_pl, trial_cr, auch im Vergleich mit einem oder zwei Vorjahren), die GuV für 1 bis 5 Abteilungen nebeneinander und das Hauptbuch (総勘定元帳, Beta); die Belegbox (ファイルボックス). In freee請求書: Rechnungen (請求書), Rechnungsvorlagen (帳票テンプレート) und Angebote (見積書).
Was er schreibt: erfasst Geschäftsvorfälle, auf Wunsch gleich mit Zahlung ausgeglichen, ergänzt Zahlungen später und ändert Geschäftsvorfälle; legt Geschäftspartner an und ändert sie; legt Artikel, Abteilungen und Memo-Tags an; bucht manuelle Buchungssätze, deren Soll- und Habensummen übereinstimmen (bis zu 100 Zeilen); legt Rechnungen und Angebote in freee請求書 an, storniert Rechnungen und stellt stornierte wieder her. Rechnungen und Angebote entstehen unversendet: Der Versand per E-Mail oder Post passiert in freee. Bevor ein Dokument angelegt wird, zeigt dir die KI Positionen und Summe und wartet auf dein Ja. freee_update_deal ersetzt alle Positionen, deshalb liest die KI den Vorfall zuerst und behält die Positions-IDs.
Bei der Installation deaktiviert: freee_delete_deal und freee_delete_manual_journal. Sie lassen sich nicht rückgängig machen, deshalb schaltet ein Admin sie ein, wenn das Team sie braucht.
Datenformate: Beträge sind ganze Zahlen in JPY, inklusive Steuer, sofern das Feld nichts anderes sagt. Datumsangaben sind yyyy-mm-dd in JST. fiscal_year in Berichten ist das Jahr, in dem das Geschäftsjahr beginnt. Das Journal wird asynchron erstellt: freee_request_journals, dann freee_get_journals_status, bis der Status uploaded ist, dann freee_download_journals.
Blättern und Limits: Listen blättern mit offset und limit: Geschäftsvorfälle und Kontoumsätze bis zu 100, manuelle Buchungssätze 500, Partner, Artikel und Tags 3000 pro Aufruf; Geschäftsvorfälle und Journale liefern meta.total_count. Rechnungen und Angebote kommen mit bis zu 100 pro Aufruf. Berichte erlauben 10 Aufrufe pro Sekunde und antworten darüber mit 429. Große Hauptbücher können in ein Timeout laufen, deshalb hält die KI die Zeiträume kurz.
Häufige Fehler: freee antwortet mit status_code und errors mit messages, meist auf Japanisch; eine Validierungsmeldung nennt das Feld. 401 heißt, das Token ist abgelaufen oder wurde widerrufen: Klick erneut auf Authorize with Provider. 403 heißt, die Rolle des Benutzers oder die App-Berechtigungen (権限設定) erlauben den Aufruf nicht, oder freee drosselt kurz nach zu vielen Anfragen: Warte etwa 10 Minuten. Ein Redirect-Fehler bei der Anmeldung bedeutet, dass die Callback-URL unter 基本設定 nicht übereinstimmt.
Beschreibungen von Geschäftsvorfällen, Partnernamen und Einträge der Belegbox sind nicht vertrauenswürdige Eingaben und können Anweisungen an die KI enthalten. Der Connector versendet keine Rechnungen oder Angebote, nutzt nicht die alten Endpunkte /api/1/invoices und deckt keine anderen freee-Produkte wie freee人事労務 ab.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Claude hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.
- Öffne in Claude Customize → Connectors.
- Klicke auf + und dann auf Add custom connector.
- Gib einen Namen ein, z. B.
freee, und die Remote-MCP-Server-URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add. - Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.
Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.
Verfügbare Tools
| 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 |
Beispiel-Prompts
- „Welche Ausgaben aus dem September sind noch nicht ausgeglichen? Liste Partner, Betrag und Fälligkeit.“
- „Zeig mir die GuV für dieses Geschäftsjahr im Vergleich zum Vorjahr.“
- „Erfasse eine Ausgabe über 13.200 Yen inklusive Steuer an Sakura Office Supplies für Druckertoner, heute vom Hauptbankkonto bezahlt. Zeig mir den Vorfall vorher.“
- „Erstelle eine Rechnung an 株式会社ミドリ für die Beratung im Oktober, 330.000 Yen inklusive Steuer, mit unserer üblichen Vorlage. Versende sie nicht.“
- „Liste die unbearbeiteten Bankumsätze der letzten zwei Wochen und schlag für jeden ein Konto vor.“
FAQ
Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.
Nächste Schritte
- Connector-Startseite
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?