spiris-mcp

# 斯皮里斯 MCP 将您的 AI 工具连接到斯皮里斯。使用Claude、ChatGPT 或任何其他与 MCP 兼容的 AI 平台直接与您的会计系统交互 - 创建发票、查询信息、管理客户等，无需离开您已经使用的 AI 工具。 在第一个阶段，斯皮里斯 MCP 适用于 **记账 & 发票**。更多的功能将陆续推出。 本仓库存放公开的发行说明。服务器由斯皮里斯托管 - 无需安装或运行任何程序。 > **早期访问**。斯皮里斯 MCP 处于测试阶段。它可以运行，但功能有限，未来可能会有所变动。可能会出现一些问题，如果您遇到任何不符合预期的情况，请不要惊讶。如果您遇到问题或发现缺少某些功能 - 我们希望听到您的反馈。 *** ## 什么是 MCP？ MCP（模型上下文协议）是一种开放标准，允许 AI 助手直接连接到外部工具和数据源。可以将其视为 AI 和您已经使用的软件之间的通用连接器。 MCP 由 Anthropic 开发，并得到越来越多的 AI 平台和工具的支持。 *** ## 您可以使用 MCP 执行的操作 连接后，您可以使用 AI 处理 **记账 & 发票**。在第一个阶段，可用的工具包括： **销售** * **客户** - 查找、创建和更新客户信息；查看客户分组 * **订单** - 创建、搜索和更新订单，并将订单转换为发票 * **客户发票** - 创建、发送和搜索发票，注册付款，发送提醒和作废 * **商品** - 创建、搜索和更新产品和服务，包括其会计规则；查看商品分组 **采购** * **供应商** - 查找、创建和更新供应商信息 * **供应商发票** - 创建和搜索供应商发票 **会计** * **凭证** - 创建和搜索会计分录，包括按财政年度划分 * **账户** - 浏览、创建和更新会计科目表和账户类型；查看特定日期的余额 * **公司概要** - 查看公司财务健康状况的多年度概览 **其他** * **附件** - 列出和链接文件到您的文档 * **项目** - 创建、搜索和更新项目 * **成本中心** - 列出成本中心 * **公司设置** - 查看公司设置 我们将不断改进现有的工具，并根据用户需求添加新的工具。 *** ## 开始使用前 要使用斯皮里斯 MCP，您需要两样东西： 1. **斯皮里斯订阅** - 您需要成为我们的客户。 2. **支持 MCP 的 AI 平台** - 您自己的账户或订阅，且 AI 平台已启用 MCP 连接器（例如 Claude 或 ChatGPT）。 ## 激活服务 激活斯皮里斯 MCP 需要三个步骤： 1. 在 **我的服务** 下的 **[管理订阅](https://vismaonline.com/subscriptions)** 中，添加 **MCP - 测试版** 服务。这使该服务对公司可用，但尚未授予任何人访问权限。 2. 在 **[管理用户](https://vismaonline.com/users)** 下，为每个应能连接的用户（包括您自己）启用该服务。 3. 在 **首页** 上，打开 **MCP - 测试版** 并点击 **接受条款和条件**。 步骤 1 和 2 需要 **管理员** 角色。 *** ## 快速入门 服务激活后，使用以下 URL 连接您的 AI 工具：`https://mcp.spiris.se/mcp` 一般步骤如下： 1. 在您的 AI 工具中找到 MCP 或自定义连接器设置。 2. 添加一个新的连接器，网址为上述 URL。 3. 完成 OAuth 登录以授权访问您的斯皮里斯账户。 4. 在聊天或工作区中激活连接器。 以下是针对最常用平台的具体说明。如果您的平台未列出，请在设置中查找“MCP”、“自定义连接器”或“外部工具”。 ### Claude Claude Free、Pro、Max、Team 和 Enterprise 版本支持远程 MCP 连接器。 #### 在 Pro 或 Max 上 1. 进入 **设置 → 连接器**。 2. 点击 **+** 并添加名称 `斯皮里斯` 和网址 `https://mcp.spiris.se/mcp`。 3. 点击 **添加** 并完成斯皮里斯登录。 4. 通过聊天中的 **+** 菜单在对话中激活斯皮里斯。 #### 在 Team 或 Enterprise 上 所有者必须先在 **组织设置 → 连接器 → 添加** 下添加连接器。用户可以自行激活。 #### Claude 代码 ```bash claude mcp add --transport http 斯皮里斯 https://mcp.spiris.se/mcp ``` 然后在 Claude Code 中运行 `/mcp` 以完成浏览器中的 OAuth 登录。 ### ChatGPT 需要开发者模式，适用于 Plus、Pro、Business 和 Enterprise 版本。 1. 启用开发者模式：**工作区设置 → 权限和角色 → 连接数据 → 开发者模式**。 2. 进入 **设置 → 应用和连接器 → 添加新连接器**。 3. 名称：`斯皮里斯` · 网址：`https://mcp.spiris.se/mcp` · 身份验证：`OAuth`。 4. 勾选 _“我信任此应用程序”_ 并点击 **创建**。 5. 完成 OAuth 登录，然后通过聊天中的工具菜单激活斯皮里斯。 ### VS Code VS Code 中的 MCP 支持通过 GitHub Copilot 和 Continue 等扩展提供。一般步骤如下： 1. 打开您的 MCP 配置文件（通常为 `.vscode/mcp.json` 或扩展程序的设置）。 2. 添加新的服务器条目，网址为 `https://mcp.spiris.se/mcp`，类型为 `http`。 3. 保存并重新加载。登录时根据提示完成 OAuth 登录。 *** ## 登录和重新身份验证 连接时，您通过斯皮里斯使用 OAuth 登录。AI 永远不会看到您的密码 - 它会收到一个与您的用户账户绑定的、时间有限的访问令牌。当令牌过期时，系统将提示您再次登录。 *** ## 数据和隐私 当您要求 AI 查询或在斯皮里斯中执行操作时，这些数据会通过 AI 平台 - 而不仅仅是斯皮里斯 - 进行传输。AI 需要看到数据才能处理，就像您一样。平台随后如何处理这些数据受您与其签订的订阅协议的约束。 ### 按计划划分的差异 * **消费者计划** （免费和个人付费层级）：您的对话 - 包括在此期间共享的任何会计数据 - 在某些情况下可能会被用于改进模型，除非您主动选择退出。规则因提供商而异，因此请检查您的具体设置。 * **商业计划** （Team、Business、Enterprise 及同等）：通常不会使用数据进行训练，数据处理协议（DPAs）到位，您对数据处理有更多控制权。 **我们的建议：** 如果您代表客户处理财务数据（例如，作为会计师），或公司政策要求数据保留在定义的范围内，请与您的 AI 提供商使用商业计划。始终直接与您的 AI 提供商核实当前条款，因为政策可能会发生变化。 在斯皮里斯方面：我们按照我们的隐私政策处理数据，就像处理我们的其他产品一样。我们不会存储您的 AI 对话 - 我们像对待所有其他 API 调用一样对待 API 调用。 *** ## 您负责您的会计 AI 可能会出错。它可能会记入错误的账户，创建错误的发票，或建议您不打算采取的操作。请始终在确认之前检查 AI 的操作 - 尤其是那些发送、记入或修改您的账户的操作。 您始终负责确保您的账户准确性。 *** ## 定价 **每月价格：免费** _(测试版)_ 在测试阶段，斯皮里斯 MCP 免费使用。我们将在正式发布前引入月费 - 我们将清楚地沟通这一点，以便您不会感到意外。 *** ## 版本发布 版本说明在此仓库中以 [GitHub Releases](https://github.com/Spiris-Visma/spiris-mcp/releases) 发布。可以通过 GitHub 的“观察 → 版本发布”订阅以接收通知。 *** ## 反馈 我们根据您的反馈进行建设。如果您发现某些功能无法正常工作或缺少某些工具，请联系我们 - 这将直接影响下一阶段的开发。 最快捷的方式是直接从您的 AI 中使用：MCP 服务器具有内置的 `submit_feedback` 工具。只需告诉 AI 您要向斯皮里斯开发团队发送反馈，AI 就会处理剩下的事情 - 无需填写表格或复制粘贴。 在斯皮里斯 MCP 测试阶段，我们不通过正常的支持渠道提供支持。但是，我们会积极监控通过 `submit_feedback` 收到的所有信息，并利用它来修复问题并优先改进。