Fortnox API文档服务器

Fortnox MCP服务器

用于探索Fortnox API文档的模型上下文协议（MCP）服务器。提供 377 Fortnox API端点 来自官方OpenAPI规范的文档。

概述

• 仅文档服务器 -提供API端点信息，不进行API调用
• 377 Fortnox API端点 来自官方OpenAPI 3.0规范
• 7个MCP工具 用于探索API文档
• 无需认证 -纯文档浏览
• AI优化 采用结构化markdown格式的响应

安装

npm install -g fortnox-doc-mcp

或与 npx:

npx fortnox-doc-mcp

可用工具

1. get_api_overview -获取API概述、统计信息和推荐的工作流程
2. list_all_endpoints -浏览所有Fortnox API端点（带可选过滤器）
3. get_endpoint_details -获取特定端点的完整文档
4. get_endpoints_by_resource -获取按操作分组的资源的所有端点
5. search_endpoints -按关键字搜索端点
6. list_resource_groups -列出所有81个API资源类别
7. get_schema_details -查看数据模型架构

快速开始

适用于克劳德桌面

添加到您的Claude Desktop配置文件中：

窗户： %APPDATA%\Claude\claude_desktop_config.json
雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fortnox-docs": {
      "command": "npx",
      "args": ["-y", "fortnox-doc-mcp"]
    }
  }
}

重新启动Claude Desktop以访问工具。

对于其他MCP客户端

{
  "servers": {
    "fortnox-doc-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "fortnox-doc-mcp"]
    }
  }
}

使用示例

配置后，您可以询问AI助手：

• “给我一个Fortnox API的概述” → Uses get_api_overview
• “列出所有Fortnox客户端点” → Uses get_endpoints_by_resource
• “显示GET/3/客户的详细信息” → Uses get_endpoint_details
• “搜索发票端点” → Uses search_endpoints
• “有哪些可用的资源组？” → Uses list_resource_groups
• “显示客户架构” → Uses get_schema_details

发展

来源

# Clone repository
git clone https://github.com/yourusername/fortnox-doc-mcp.git
cd fortnox-doc-mcp

# Install dependencies
npm install

# Build
npm run build

# Test
npm test

项目结构

fortnox-doc-mcp/
├── src/
│   ├── index.ts              # MCP server with 7 tools
│   ├── openapi-parser.ts     # OpenAPI spec parser
│   └── test-docs.ts          # Documentation test
├── openapi (1).json          # Fortnox OpenAPI specification
└── dist/                     # Compiled JavaScript

技术细节

• OpenAPI版本: 3.0.3
• 端点：377 Fortnox API端点
• 资源组：81个类别
• 加载中：单例模式（一次性加载到内存中）
• 演出：O（1）端点查找，无外部API调用
• 节点版本: 18+

常见问题解答

Q： 我需要Fortnox API代币吗？
A： 不！这是一个文档服务器。不需要API凭据。

Q： 这能让API调用Fortnox吗？
A： 不是。它只提供OpenAPI规范中关于端点的文档。

Q： 如何在Claude Desktop中使用此功能？
A： 将配置添加到 claude_desktop_config.json 并重新启动克劳德桌面。

Q： 我可以用它来构建Fortnox集成吗？
A： 是的！在构建集成之前，使用它可以浏览API文档，了解端点、参数和架构。

许可证

麻省理工学院

链接

• Fortnox API文档
• 模型上下文协议
• GitHub存储库