Cómo conectar freee a Cursor vía MCP

💡 ¿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 + Cursor

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.

1. 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.
2. En la pestaña 基本設定 añade la callback URL <your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
3. 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 保存.
4. Pega el Client ID en FREEE_CLIENT_ID y el Client Secret en FREEE_CLIENT_SECRET, deja FREEE_REFRESH_TOKEN vacío e instala.
5. 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.
6. Ejecuta freee_get_me: muestra el usuario y sus empresas con el company_id que 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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de freee.

Herramientas disponibles

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot