exactonline mcp
一种模型上下文协议（MCP）服务器，提供对精确在线会计数据的只读访问。直接从Claude查询您的财务数据、收入报告和账户余额。
特性
- 18工具 用于查询精确在线数据
- 收入分析 -按时期、客户或项目进行同比比较
- 财务报告 -损益概览、资产负债表、总账账户余额
- 账龄报告 -按账龄段分列的未清应收账款和应付账款
- 未清应收账款 -个人发票详细信息、客户特定视图、逾期跟踪
- 银行和购买数据 -银行交易行、供应商的采购发票
- 发现工具 -探索任何Exact Online API端点
安全考虑
此MCP服务器设计为只读。 它只对Exact Online API执行GET请求，因此无法修改、删除或损坏您的会计数据。
但是，请注意：
- 数据暴露风险：LLM可以访问您的财务数据（收入、客户姓名、账户余额、发票）。如果您使用其他可以向外部发送数据的MCP工具（电子邮件、webhooks、文件上传），敏感信息可能会泄露。
- LLM护栏各不相同：Claude有很强的护栏，但其他LLM或自定义配置可能没有。在将此MCP用于限制较少的型号时要小心。
- 对话历史：根据LLM提供商的数据保留政策，您的查询和返回的财务数据可能会存储在对话日志中。
建议:
- 仅在需要时启用此MCP服务器
- 查看配置中其他哪些MCP工具处于活动状态
- 注意在共享或日志环境中查询哪些财务数据
先决条件
在开始之前，请确保您已经：
- Python 3.11或更高版本 -查看
python --version - uv包管理器 - 安装指南
- 精确的在线帐户 启用API访问
- ngrok帐户 （免费）- 在ngrok.com注册
安装
1.安装uv（如果尚未安装）
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"2.克隆并安装
git clone https://github.com/TimPelgrim/exactonline-mcp.git
cd exactonline-mcp
uv sync3.创建配置文件
创建 .env 项目根目录中的文件：
EXACT_ONLINE_CLIENT_ID=your_client_id
EXACT_ONLINE_CLIENT_SECRET=your_client_secret
EXACT_ONLINE_REGION=nl替换为您的实际凭据（见下一节）。
更新中
我们定期发布更新，包括新功能、错误修复和安全改进。我们建议定期检查更新。
如何更新
打开终端，然后运行以下命令：
# 1. Go to the installation folder
cd exactonline-mcp
# 2. Download the latest version
git pull origin main
# 3. Update dependencies
uv sync在更新之后， 重新启动克劳德桌面 使用新版本。
检查您当前的版本
要查看您安装的版本，请执行以下操作：
cd exactonline-mcp
git describe --tags --always这将显示类似的内容 v0.1.0 （豁免）或 v0.1.0-5-g1234abc （v0.1.0之后提交5次）。
有什么新鲜事吗？
您可以检查自上次更新以来发生了什么变化：
- 在GitHub上：访问 发布页面 用于发布说明
- 航站楼内：运行
git log --oneline v0.1.0..HEAD查看最近的更改
发布历史
| 版本 | 日期 | 亮点 |
|---|---|---|
| v0.2.0 | 2024年12月 | 增加了5个新工具：未结应收账款（3）、银行和采购数据（2） |
| v0.1.0 | 2024年12月 | 首次发布，包含13个用于收入、财务报告和发现的工具 |
精确的在线应用程序设置
获取API证书：
- 转到 精确在线应用中心
- 使用您的Exact Online帐户登录
- 点击 “管理我的应用程序” → “添加新应用程序”
- 填写应用程序详细信息：
- 名字：例如，“MCP服务器” - 重定向URI：您的ngrok URL+ /callback （请参阅身份验证部分）
- 创建应用程序后，复制 客户端ID 和 客户端密钥 给你的
.env文件
认证
为什么是ngrok？
Exact Online需要一个可公开访问的HTTPS URL用于OAuth回调。他们拒绝 localhost URL，所以我们使用ngrok来创建一个安全的隧道。
设置ngrok
- 安装ngrok：
brew install ngrok（macOS）或 下载 - 身份验证：
ngrok config add-authtoken YOUR_TOKEN（从ngrok仪表板获取令牌） - 启动隧道：
ngrok http 8080- 复制HTTPS URL（例如。，
https://abc123.ngrok.io)
配置重定向URI
- 返回您的Exact Online应用程序设置
- 更新 重定向URI 致：
https://YOUR-NGROK-URL/callback
运行身份验证
ngrok在单独的终端中运行：
EXACT_ONLINE_REDIRECT_URI=https://YOUR-NGROK-URL/callback uv run python -m exactonline_mcp.auth这将：
- 打开浏览器进行精确在线登录
- 请求访问您的数据的权限
- 将令牌安全地存储在系统密钥环中
使用Claude Desktop
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"exactonline": {
"command": "uv",
"args": ["--directory", "/path/to/exactonline-mcp", "run", "python", "-m", "exactonline_mcp"],
"env": {
"EXACT_ONLINE_CLIENT_ID": "your_client_id",
"EXACT_ONLINE_CLIENT_SECRET": "your_client_secret",
"EXACT_ONLINE_REGION": "nl"
}
}
}
}替换 /path/to/exactonline-mcp 安装的实际路径。
可用工具
发现工具
| 工具 | 说明 |
|---|---|
list_divisions | 列出可访问的精确在线部门（行政部门） |
explore_endpoint | 使用示例数据探索任何API端点 |
list_endpoints | 按类别浏览已知API端点 |
收入工具
| 工具 | 说明 |
|---|---|
get_revenue_by_period | 按月/季度/年划分的收入总额，同比比较 |
get_revenue_by_customer | 客户收入排名与发票计数 |
get_revenue_by_project | 基于项目的收入，可选择小时跟踪 |
财务报告工具
| 工具 | 说明 |
|---|---|
get_profit_loss_overview | 损益表总结及同比比较 |
get_gl_account_balance | 特定GL账户的余额（分类账户） |
get_balance_sheet_summary | 按类别（资产、负债、权益）划分的资产负债表总计 |
list_gl_account_balances | 列出有余额的账户，可按类型筛选 |
get_aging_receivables | 按年龄段（0-30、31-60、61-90、>90天）列出的未付客户发票 |
get_aging_payables | 按年龄段列出的未付供应商发票 |
get_gl_account_transactions | 深入了解帐户的单个交易 |
开放式应收账款工具
| 工具 | 说明 |
|---|---|
get_open_receivables | 列出已过滤的未结发票（按客户，仅限逾期） |
get_customer_open_items | 特定客户的所有未结项目 |
get_overdue_receivables | 按逾期天数分类的逾期应收账款 |
银行和采购数据工具
| 工具 | 说明 |
|---|---|
get_bank_transactions | 带日期/账户过滤的银行交易行 |
get_purchase_invoices | 供应商采购发票（需要采购模块） |
示例提示
"Show me revenue by quarter for 2024"
"Who are our top 5 customers?"
"What's the revenue per project this year?"
"Compare Q1 revenue to last year"
"Show me the profit and loss overview"
"What's the balance on account 1300 (Debiteuren)?"
"Show me the balance sheet summary"
"List all P&L accounts with balances"
"Show aging receivables - who owes us money?"
"What transactions were made to account 8000 this year?"
"Show me all open invoices"
"Which invoices are overdue?"
"What's outstanding for customer 400?"
"Show invoices more than 30 days overdue"
"Show bank transactions from last month"
"What payments did we make from the ING account?"
"List purchase invoices from December"故障排除
“分区不可访问”
此错误意味着API终结点需要未为您的Exact Online订阅启用的模块。例如， project/Projects 需要项目模块。
解决方案：使用 list_divisions 查看您有权访问哪些部门，并检查您的Exact Online订阅以获取可用模块。
身份验证失败/令牌过期
令牌在30天不活动后过期。
解决方案：重新运行身份验证流：
EXACT_ONLINE_REDIRECT_URI=https://YOUR-NGROK-URL/callback uv run python -m exactonline_mcp.authngrok隧道错误
常见问题：
- 隧道未运行：确保ngrok在单独的终端中运行
- URL已更改：ngrok免费层为每个会话提供一个新的URL-更新您的重定向URI
- 速率限制：请稍候几分钟，然后重试
解决方案：重新启动ngrok，并在Exact Online应用程序设置和auth命令中更新重定向URI。
速率限制错误
Exact Online将API调用限制为每分钟60次。
解决方案：服务器具有内置的重试逻辑。如果您看到速率限制错误，请等待一分钟，然后重试。
“请添加$select或$top=1语句”
某些精确在线端点需要明确的字段选择。
解决方案：使用 select 调用时的参数 explore_endpoint，或使用自动处理此问题的专用工具。
许可证
麻省理工学院