Unofficial Official Mf MCP Skill

非官方mf-mcp技能

金融前锋云会计的官方MCP服务器使用方法非正式技能是。

它同时适用于聊天网络。AI自动理解MF云会计的MCP的使用方法·API的癖好·限制事项对应。

v2.3.0更改

• getTermSettings 添加工具 —运营商的経理方式（税込/税抜）・课税方式（简易/本则/免税）・都道府県・业种区分・端数处理中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。试算表API include_tax 打两下就不用比较了
• complete_authentication 添加工具 -在beta版认证中localhost重定向失败时的回退（手动粘贴URL完成认证）
• available 添加参数实测规格 — getAccounts / getSubAccounts / getDepartments 的，之 available 查询为\*\*false 返回指定的“全部（有效+无效）”\*\*的规格（与直觉相反）。true /仅限有效科目。通过实测确定
• deleteVouchers 真身 —不是“删除凭证” “取消关联日记帐和凭证” 的API。凭证本身是孤立的
• 将OpenAPI本地副本替换为2026-04最新版 -以前的本地拷贝在2025-01时很旧

v2.2.0更改

• per_page 将上限从500修改为10000 -实测 per_page=10000 已验证是否接受API。100001以上为错误。v2.1.0以前的“上限500”是错误的
• 大多数公司可以通过一次API调用获得所有日记账 —大多数情况下都不需要页码+merge_journals.py
• 已验证数据完整性 —以per_page=500和per_page=10000对同一日记账进行JSON完全比较，确认没有缺失、劣化

v2.1.0

• 明确alpha版的认证流程 — mfc_ca_authorize → mfc_ca_exchange 的2个步骤（修正跳过exchange后连接失败的问题）
• 在比较表中追加无头支持 —写明alpha版在没有Telegram机器人等浏览器的环境下也可以认证

v2.0.0版本

• alpha版/beta版的区分使用指南追加 -梅里德梅比较表、多法人同时处理的区分使用
• 成批检索日记帐功能 —以per_page=10000一次性取得+merge_journals.py结合（仅在超过10000件的情况下）
• Claude Code対応 —添加安装过程
• .claude.json の设定例（alpha/beta両方の同时登録）

包含的内容

• alpha版/beta版的区分使用指南（认证方式、令牌有效期、多法人对应的比较）
• 验证流程（alpha版：手动代码复制/beta版：PKCE自动回调）
• 所有工具列表和使用方法
• API癖好（PL累计、end_month陷阱、含税/不含税差异、无科目标识、起始日记帐、混合制造成本报告、无法按部门获取数据等）
• 日记帐登记的事前准备（主控检索、ID的URL编码、无子科目的处理）
• 需要对日记账更新进行所有替换和备份
• 成批获取日记帐处方（其中per_page=10000，大多数法人一次性完成）+合并脚本（scripts/merge_journals.py）
• REST API直接敲打时的基本URL、ID的%2F编码问题及对策
• 如何生成日记账URL
• 复数法人同时利用
• 能做的事、不能做的事一览

安装，安装

前提：注册MF官方MCP服务器

除了技能以外，还需要注册MF官方MCP服务器（远程MCP连接器）。

对于Claude Desktop

1. 左边栏的“连接器”→“+”
2. 选择自定义
3. 输入以下URL：

- beta版（推奨）: https://beta.mcp.developers.biz.moneyforward.com/mcp/ca/v3 - alpha版: https://alpha.mcp.developers.biz.moneyforward.com/mcp/ca/v3

1. 两者登录的话可以同时使用

对于Claude Code

~/.claude.json 添加：

{
  "mcpServers": {
    "mf-official-beta": {
      "type": "http",
      "url": "https://beta.mcp.developers.biz.moneyforward.com/mcp/ca/v3"
    },
    "mf-official-alpha": {
      "type": "http",
      "url": "https://alpha.mcp.developers.biz.moneyforward.com/mcp/ca/v3"
    }
  }
}

哪一方都可以。

安装技能

对于Claude Desktop

1. 发布 从中下载zip文件
2. 打开Claude Desktop
3. 左边栏的“自定义”→“技能”→“+”
4. 选择并安装下载的zip

对于Claude Code

# スキルフォルダに配置
mkdir -p ~/.claude/skills/unofficial-official-mf-mcp-skill
cd ~/.claude/skills/unofficial-official-mf-mcp-skill

# GitHubからファイルを取得（zipダウンロード → 展開でもOK）
curl -L https://github.com/kentaroajisaka/unofficial-official-mf-mcp-skill/archive/refs/tags/v2.3.0.tar.gz | tar xz --strip-components=1

alpha版 vs beta版

｜认证方式｜手动（复制认证代码）｜自动（PKCE+localhost回调）｜ 标记过期时间约1小时（需要频繁的重新认证） |复数法人同时利用| 可能（按法人认证并同时保存）｜不可（切换时再认证）｜ ｜无头环境｜ 対応（通过聊天等方式传递代码即可）｜不可（需要重定向至localhost）｜

• 只工作一家公司时 →beta版很轻松
• 同时处理多个法人时 → alpha版
• Telegram机器人等没有浏览器的环境 →alpha版（只需通过聊天发送认证代码即可认证）

注意事项

• 这非公式的技能。不是货币前锋提供和支持的
• MF云会计的正式MCP服务器（远程MCP连接器）需要另外设定（参照上述“设置”）

作成者

竹坂健太郎

• 税理士 / 鯵坂税理士事務所 代表
• https://office-wing.net/
• 十、 @萨巴吉0113

许可证

MIT许可证