Fiken Read Only MCP

无花果-MCP

A. 只读 模型上下文协议（MCP） 服务器 菲肯 会计API。将所有Fiken GET端点作为MCP工具公开，以便AI助手（Claude等）可以直接查询您的会计数据。

只读保证： 此服务器只向Fiken API发出HTTP GET请求。不会创建、修改或删除任何数据。

特性

• 61个工具涵盖完整的Fiken v2 read API
• 多公司支持-- companySlug 是每个工具的参数
• 带有元数据的分页列表端点
• 串行请求队列（遵守Fiken的每个用户1个并发请求规则）
• 结构化错误响应-API错误作为工具结果返回，而不是崩溃会话

需求

• Node.js 18+
• A. Fiken API 令牌

安装

git clone https://github.com/yourusername/fiken-mcp
cd fiken-mcp
npm install
npm run build

用法

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "fiken": {
      "command": "node",
      "args": ["/absolute/path/to/fiken-mcp/build/index.js"],
      "env": {
        "FIKEN_API_TOKEN": "your-token-here"
      }
    }
  }
}

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

克劳德代码

使用以下命令将服务器添加到您的Claude Code项目中：

claude mcp add fiken -- node /absolute/path/to/fiken-mcp/build/index.js

然后设置令牌：

claude mcp add fiken -e FIKEN_API_TOKEN=your-token-here -- node /absolute/path/to/fiken-mcp/build/index.js

或者，如果您希望将配置保留在版本控制中，请将其添加到 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "fiken": {
      "command": "node",
      "args": ["/absolute/path/to/fiken-mcp/build/index.js"],
      "env": {
        "FIKEN_API_TOKEN": "your-token-here"
      }
    }
  }
}

要验证服务器是否已连接：

claude mcp list

其他MCP客户端

使用环境中的令牌运行服务器：

FIKEN_API_TOKEN=your-token-here node build/index.js

开发（无构建步骤）

FIKEN_API_TOKEN=your-token-here npm run dev

MCP检查员

FIKEN_API_TOKEN=your-token-here npx @modelcontextprotocol/inspector node build/index.js

获取Fiken API代币

1. 登录 fiken.cn
2. 首选 设置→ API （或参观 https://fiken.no/api/v2/documentation)
3. 生成个人API令牌
4. 保密——把它当作密码

可用工具

从开始 fiken_list_companies 为了得到 companySlug 所有其他工具所需的值。

用户

公司

账户

银行

联系人

发票

贷项凭单

优惠

订单确认

日记账分录

交易

销售

采购

产品

项目

时间追踪

收件箱

备注

• 金额 返回 欧分（Cents） 作为整数，匹配Fiken API-例如。 100000 指1000.00挪威克朗
• 账户代码 是字符串，例如。 "1920" 或 "1500:10001"
• 分页 默认为第0页，每页25个结果（最多100个）
• 日期筛选 使用 YYYY-MM-DD 格式

发展

npm test          # run tests
npm run build     # compile TypeScript
npm run dev       # run without building (uses tsx)

许可证

麻省理工学院