账单管理API连接器

MCP API 发票

非官方 MCP（模型上下文协议） 提供完全访问权限的服务器 发票 账单和订阅管理API。将您的AI助手连接到Fakturia，并通过自然语言管理客户、合同、发票、订阅等。

免责声明： 这是一个非官方的社区建设项目。它不隶属于、认可或支持 Luminea IT服务有限公司“Fakturia”是Luminea IT Services GmbH的产品 docs/api/ 从Fakturia的公共API文档端点获取。

这是什么？

此MCP服务器包装整个Fakturia REST API，并将每个端点公开为MCP工具。这意味着任何兼容MCP的AI客户端（例如 克劳德代码, 克劳德桌面，或其他MCP客户端）可以直接与您的Fakturia帐户交互——创建客户、管理订阅、生成发票、提取报告等。

可用工具

123工具 跨越14个API域：

所有工具都包括全面的描述和参数文档，使其易于从任何MCP客户端发现和使用。

快速开始

先决条件

• Node.js 24+
• 已启用API访问的Fakturia帐户(如何获取API密钥)

使用Claude代码

将以下内容添加到您的项目中 .mcp.json 或 ~/.claude/.mcp.json 全球访问：

{
  "mcpServers": {
    "fakturia": {
      "command": "npx",
      "args": ["-y", "@edjufy/fakturia-mcp"],
      "env": {
        "FAKTURIA_API_HOST": "https://api.sandbox.fakturia.de",
        "FAKTURIA_API_KEY": "<your-api-key>"
      }
    }
  }
}

替换 <your-api-key> 使用您的Fakturia API密钥。使用 https://api.fakturia.de 用于生产。

与其他MCP客户端一起使用

此服务器通过stdio进行通信。使用所需的环境变量运行它：

FAKTURIA_API_HOST=https://api.sandbox.fakturia.de FAKTURIA_API_KEY=<your-api-key> npx -y @edjufy/fakturia-mcp

环境变量

API主机

API文档可在 /documentation/ 在每个主机上（例如。 api.fakturia.de/文档).

提示： 使用沙盒环境进行开发和测试。它的行为与生产相同，但不会影响真实数据。

获取API密钥

1. 登录Fakturia后台(网站 backoffice.fakturia.de 或 后台沙盒文件 对于沙盒）
2. 确保您的Fakturia计划包括API访问
3. 导航到您的项目设置并配置API界面(配置 API 接口)
4. 激活项目的API
5. 生成API密钥
6. 为项目配置IP白名单（添加客户的IP地址，或留空以允许所有）

有关更多详细信息，请参阅 账单维基：REST API.

⚠️ 警告： 如果您的API密钥具有写访问权限，则MCP服务器可以执行以下操作 创建、修改或永久删除数据 在您的Fakturia账户中（例如取消合同、支付发票、删除客户）。当与可能自主采取行动的人工智能助手一起使用时，这尤其危险。考虑使用 只读API密钥 为了防止意外的更改-您可以在API配置下的Fakturia项目设置中对此进行配置。

发展

git clone https://github.com/edjufy/fakturia-mcp.git
cd fakturia-mcp
pnpm install          # Install dependencies
pnpm build            # Compile TypeScript to dist/
pnpm bundle           # Compile + bundle to bundle/fakturia-mcp.mjs
pnpm start            # Run from compiled dist/
pnpm release          # Create a new release (via release-it)

链接

• Fakturia网站
• Fakturia API文档
• 账单维基：REST API
• OpenAPI规范 （OpenAPI 3.0.1）
• 模型上下文协议

建造于

edjufy软件有限公司 --构建教育数字解决方案。在以下网址查找更多我们的开源工作 GitHub.

许可证

麻省理工学院