Norman Finance MCP 服务器
该模型上下文协议 (MCP)服务器使 AI 能够与 Norman Finance API 交互，允许通过标准化协议访问会计、发票、公司、客户、税收等。
[！笔记]
Norman Finance MCP 服务器目前处于测试阶段。我们欢迎您的反馈，并鼓励您在此处提交问题报告。
特征
🔐身份验证：使用 Norman Finance 帐户进行安全身份验证
💼公司管理：管理您的公司详细信息，获取公司余额、增值税信息等
📊会计：密切关注您的交易、分类
📝 （电子）发票：制作、查看、发送和处理发票。您甚至可以根据合同设置定期发票
👥客户管理：创建和管理您的客户（CRM）
💰税务：查看税务信息和报告，生成官方 Finanzamt PDF 预览并申报税务
📄文件：上传和管理附件（收据、发票、文件等）
👇 使用 Claude Desktop 的案例示例 — 切换
Related MCP server: Nornir MCP Server
先决条件
使用此 MCP 服务器之前，您需要：
在Norman Finance上创建账户
准备好电子邮件和密码以进行身份验证
远程 MCP 服务器
Norman 现在提供托管远程 MCP 服务器：
建议使用远程 MCP，因为它采用 OAuth 身份验证，使您能够直接使用 Norman 帐户登录，而无需手动创建或管理访问令牌。
安装
Claude.ai集成
将 Norman MCP 服务器添加到 Claude.ai：
对于克劳德·马克斯来说：
前往*“设置”>“个人资料”*
找到“集成”部分
点按“添加更多”
输入 Norman MCP 服务器 URL：
https://mcp.norman.finance/sse点击“添加”完成
对于 Claude 企业和团队：
转至*“设置”>“集成”* （针对团队）或*“设置”>“数据管理*”（针对企业）
找到“集成”部分
点击“添加更多”
输入 Norman MCP 服务器 URL：
https://mcp.norman.finance/sse点击“添加”完成
启用 Norman 集成：
开始与 Claude 聊天。
打开搜索和工具菜单。
单击“连接”以链接您的 Norman 帐户。
连接后，使用相同的菜单打开特定的 Norman 工具。
添加到 Claude 桌面
要使用 Claude Desktop 运行 Norman Finance MCP 服务器，您可以使用上述说明或按照以下步骤手动添加：
1.下载并配置Claude Desktop
下载Claude 桌面。
启动 Claude 并导航至：设置 > 开发者 > 编辑配置。
使用以下配置更新您的
claude_desktop_config.json文件：
远程 MCP
{
"mcpServers": {
"norman-mcp-server": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.norman.finance/sse"]
}
}
}本地 MCP
安装 uv
按照此处的说明操作：安装 uv
{
"mcpServers": {
"norman-mcp-server": {
"command": "<home_path>/.local/bin/uvx",
"args": [
"--from",
"norman-mcp-server@latest",
"norman-mcp"
],
"env": {
"NORMAN_EMAIL": "your-email@example.com",
"NORMAN_PASSWORD": "your-password",
"NORMAN_ENVIRONMENT": "production"
}
}
}
}配置
身份验证方法
Norman MCP 服务器支持两种身份验证方法：
1. OAuth 身份验证（用于 SSE 传输）
当将服务器与 MCP Inspector、Claude 或其他 SSE 客户端一起使用时，服务器使用 OAuth 2.0 身份验证：
使用 SSE 传输启动服务器：
python -m norman_mcp --transport sse连接到服务器后，您将被引导至登录页面
输入您的 Norman Finance 凭证
您将被重定向回您的应用程序并带有身份验证令牌
2. 环境变量（用于 stdio 传输）
当使用带有 Claude Desktop 或 stdin/stdout 通信的服务器时，请通过环境变量提供凭据：
# .env
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production # or "sandbox" for the development environment
NORMAN_API_TIMEOUT=200 # Request timeout in seconds环境变量
可以使用以下环境变量配置服务器：
# Authentication (for stdio transport)
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production # or "sandbox" for the development environment
# Server configuration
NORMAN_MCP_HOST=0.0.0.0 # Host to bind to
NORMAN_MCP_PORT=3001 # Port to bind to
NORMAN_MCP_PUBLIC_URL=http://example.com # Public URL for OAuth callbacks (important for remote access)
NORMAN_API_TIMEOUT=200 # Request timeout in seconds发展
本节适用于想要开发或扩展 Norman Finance MCP 服务器的贡献者。
本地设置
git clone https://github.com/norman-finance/norman-mcp-server.git
cd norman-mcp-server
pip install -e .然后更新您的 claude_desktop_config.json 文件以直接指向 Python 模块：
{
"mcpServers": {
"norman-mcp-server": {
"command": "<path_to_your_python>/python",
"args": ["-m", "norman_mcp"],
"env": {
"NORMAN_EMAIL": "your-email@example.com",
"NORMAN_PASSWORD": "your-password",
"NORMAN_ENVIRONMENT": "production"
}
}
}
}你有什么功能创意或希望看到的内容吗？分享你的建议