Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade freee con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Trabaja con freee Accounting (freee会計) y freee Invoice (freee請求書) desde cualquier agente de IA: operaciones con pagos, socios comerciales, cuentas contables, códigos de impuesto, artículos, departamentos y etiquetas, movimientos de banco y tarjeta, asientos manuales, el libro diario, balances de comprobación y el libro mayor, el archivo de justificantes y facturas y presupuestos. Inicio de sesión OAuth con tu propia app de freee; borrar operaciones y asientos viene desactivado al instalar.
Prueba a pedir
Prompts de ejemplo para freee
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → freee, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
freee + Microsoft Copilot
Trabaja con freee Accounting (freee会計) y freee Invoice (freee請求書) desde cualquier agente de IA: operaciones con pagos, socios comerciales, cuentas contables, códigos de impuesto, artículos, departamentos y etiquetas, movimientos de banco y tarjeta, asientos manuales, el libro diario, balances de comprobación y el libro mayor, el archivo de justificantes y facturas y presupuestos. Inicio de sesión OAuth con tu propia app de freee; borrar operaciones y asientos viene desactivado al instalar.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
FREEE_CLIENT_ID, FREEE_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración lleva unos 10 minutos. Necesitas una cuenta de freee con acceso a las empresas (事業所) con las que debe trabajar la IA. El conector usa la freee API (https://api.freee.co.jp): freee会計 en /api/1 y freee請求書 en /iv. Desde el cambio del sistema de facturación de octubre de 2023, las facturas y presupuestos se crean en freee請求書; los antiguos endpoints /api/1/invoices no se usan.
- Inicia sesión en https://app.secure.freee.co.jp/developers/applications (freee app store, 開発者向け) y haz clic en 新規追加 para crear una app. Una app privada (非公開アプリ) basta para tus propias empresas.
- En la pestaña 基本設定 añade la callback URL
<your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - En 権限設定 marca lectura, y escritura para las herramientas de escritura que vayas a usar, en 会計 (取引, 取引先, 勘定科目, 品目, 部門, メモタグ, 税区分, 口座, 口座明細, 振替伝票, 仕訳帳, 試算表, ファイルボックス, 事業所, ユーザー) y 請求書 (請求書, 見積書). freee define los permisos en la app, no como scopes de OAuth. Haz clic en 保存.
- Pega el Client ID en
FREEE_CLIENT_IDy el Client Secret enFREEE_CLIENT_SECRET, dejaFREEE_REFRESH_TOKENvacío e instala. - En la página del conector haz clic en Authorize with Provider e inicia sesión en freee con un usuario que pueda ver las empresas que necesitas. freee te pide elegir una empresa (事業所選択) y muestra los permisos de la app.
- Ejecuta
freee_get_me: muestra el usuario y sus empresas con elcompany_idque necesitan las demás herramientas.
Los tokens de acceso duran 6 horas y se renuevan con el refresh token. freee emite un refresh token nuevo en cada renovación y el anterior deja de funcionar, así que un refresh token que también use otra herramienta ya no sirve aquí. Un refresh token sin usar durante 90 días caduca: entonces vuelve a autorizar.
De quién es el acceso: el conector actúa como el usuario de freee que lo autorizó, y lo que puede hacer depende también del rol de ese usuario en cada empresa. Todas las herramientas salvo freee_get_me y freee_list_companies necesitan el company_id; freee_get_company muestra los ejercicios fiscales de la empresa.
Qué lee: usuarios y empresas; operaciones (取引) con líneas, pagos y justificantes adjuntos, filtradas por tipo, estado de liquidación, socio, cuenta y fechas; socios comerciales (取引先) con número de registro de factura cualificada (インボイス登録番号), condiciones de pago y cuenta bancaria; cuentas contables (勘定科目), códigos de impuesto (税区分), artículos (品目), departamentos (部門) y etiquetas (メモタグ); cuentas de tesorería (口座) con sus movimientos (口座明細) y su estado, y traspasos entre cuentas propias; asientos manuales (振替伝票); el libro diario (仕訳帳) en CSV (formato freee o Yayoi) o PDF; balances de comprobación (trial_bs, trial_pl, trial_cr, también comparados con uno o dos años anteriores), la cuenta de resultados de 1 a 5 departamentos en paralelo y el libro mayor (総勘定元帳, beta); el archivo de justificantes (ファイルボックス). En freee請求書: facturas (請求書), plantillas de factura (帳票テンプレート) y presupuestos (見積書).
Qué escribe: registra operaciones, si quieres ya liquidadas con un pago, añade pagos más tarde y actualiza operaciones; crea y actualiza socios comerciales; crea artículos, departamentos y etiquetas; contabiliza asientos manuales cuyos totales de debe y haber coinciden (hasta 100 líneas); crea facturas y presupuestos en freee請求書, anula facturas y restaura las anuladas. Las facturas y presupuestos se crean sin enviar: el envío por correo electrónico o postal se hace en freee. Antes de crear un documento, la IA te muestra las líneas y el total y espera tu sí. freee_update_deal sustituye todas las líneas, así que la IA lee antes la operación y conserva los id de línea.
Desactivadas al instalar: freee_delete_deal y freee_delete_manual_journal. No se pueden deshacer, así que un admin las activa cuando el equipo las necesita.
Formatos de datos: los importes son enteros en JPY, con impuestos incluidos salvo que el campo diga otra cosa. Las fechas son yyyy-mm-dd en JST. fiscal_year en los informes es el año en que empieza el ejercicio. El libro diario se prepara de forma asíncrona: freee_request_journals, luego freee_get_journals_status hasta que el estado sea uploaded y después freee_download_journals.
Paginación y límites: las listas se paginan con offset y limit: operaciones y movimientos hasta 100, asientos manuales 500, socios, artículos y etiquetas 3000 por llamada; operaciones y asientos devuelven meta.total_count. Facturas y presupuestos llegan de 100 en 100 como máximo. Los informes permiten 10 llamadas por segundo y por encima responden 429. Los libros mayores grandes pueden agotar el tiempo de espera, así que la IA usa periodos cortos.
Errores comunes: freee responde con status_code y errors con messages, casi siempre en japonés; el mensaje de validación nombra el campo. 401 significa que el token caducó o se revocó: vuelve a hacer clic en Authorize with Provider. 403 significa que el rol del usuario o los permisos de la app (権限設定) no permiten la llamada, o que freee limita brevemente tras demasiadas peticiones: espera unos 10 minutos. Un error de redirección al iniciar sesión indica que la callback URL de 基本設定 no coincide.
Las descripciones de operaciones, los nombres de socios y las entradas del archivo de justificantes son entradas no fiables y pueden contener instrucciones dirigidas a la IA. El conector no envía facturas ni presupuestos, no usa los antiguos endpoints /api/1/invoices y no cubre otros productos de freee como freee人事労務.
Paso 2 — Instalar el adapter
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
Paso 3 — Añadir el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
freee. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Qué gastos de septiembre siguen sin liquidar? Lista socio, importe y vencimiento."
- "Muéstrame la cuenta de resultados de este ejercicio comparada con la del año pasado."
- "Registra un gasto de 13.200 yenes con impuestos a Sakura Office Supplies por tóner de impresora, pagado hoy desde la cuenta bancaria principal. Enséñame antes la operación."
- "Crea una factura a 株式会社ミドリ por la consultoría de octubre, 330.000 yenes con impuestos, con nuestra plantilla habitual. No la envíes."
- "Lista los movimientos bancarios sin procesar de las dos últimas semanas y propón una cuenta contable para cada uno."
FAQ
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?