将 DATEV Sandbox MCP 连接到 ChatGPT

💡 不想安装？直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → DATEV Online APIs (Sandbox)，粘贴你的凭据，生成 MCP API 密钥——完成。无需 Docker，无需 git clone，无需本地服务器。

DATEV Online APIs (Sandbox) + ChatGPT

DATEV Online APIs 的沙盒环境——基于 DATEV 测试数据读取会计 Mandanten（客户）、文档类型和 DUO 版本元数据。在构建和测试阶段使用；在 DATEV 授予正式环境批准之前，每个新的 DATEV 应用都必须在沙盒中运行。与正式环境相同的 OAuth2 Authorization Code + PKCE 流程，只是指向 DATEV 的沙盒端点。

前提条件

请参阅连接器内置的完整设置说明（在应用内商店中选择该连接器即可看到）。此连接器所需的环境变量如下：

DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

步骤 1 — 获取凭据

设置大约需要 10 分钟。你需要在 DATEV-Entwicklerportal 上有一个应用，以及一个用于登录的 DATEV-Konto。

1. 在 DATEV-Entwicklerportal (https://developer.datev.de) 上，创建一个使用 OpenID Connect Authorization Code Flow 的 Confidential 应用。将重定向 URI 设置为 <your AnythingMCP URL>/api/mcp-oauth/callback（在 AnythingMCP Cloud 上为：https://cloud.anythingmcp.com/api/mcp-oauth/callback）。
2. 为该应用订阅沙盒 API 产品 accounting:clients 2.0 和 accounting:documents 2.0。
3. 将客户端 ID 复制到 DATEV_CLIENT_ID，将客户端密钥复制到 DATEV_CLIENT_SECRET。请完整复制密钥：门户只会显示一次。
4. 安装连接器。它已针对 DATEV 的沙盒端点完成配置，并在令牌端点使用 HTTP Basic（client_secret_basic）进行认证，这是 DATEV 的要求。
5. 在连接器页面上，点击 Authorize with Provider，并使用你的 DATEV-Konto 登录。这只需登录一次：刷新令牌随后会被加密存储。
6. 运行 datev_list_clients：它会列出你的 DATEV-Konto 用户被分配的 Mandanten，包含 UUID、顾问编号、客户编号和名称。

沙盒，而非正式环境：在 DATEV 完成正式环境审批之前，每个 DATEV 应用都在沙盒中运行，因此这里是你构建和测试的地方。沙盒使用的是 DATEV 的测试数据。一旦 DATEV 批准你的应用进入正式环境，请使用单独的 DATEV Online APIs 连接器：它使用相同的凭据，并指向正式环境端点。

权限范围（Scopes）：连接器请求 datev:accounting:clients accounting:clients:read accounting:documents。不要添加 openid：它是颁发者名称，而不是权限范围。

两种客户端 ID：每个针对单个客户的工具都需要一个 clientId，即 datev_list_clients 返回的 Mandant UUID。它与 DATEV_CLIENT_ID 不同，后者用于标识你的 OAuth 应用，并在每次调用时与 Bearer 令牌一起通过 X-DATEV-Client-Id 请求头发送。

可读取的内容：Mandant 的主数据（顾问编号和客户编号、名称、地址）；拥有 DATEV Unternehmen online (DUO) 文档访问权限的 Mandanten，数量可能少于全部 Mandanten，因为只有拥有有效 DUO 订阅的客户才会出现；Mandant 的文档类型（Belegtypen）；以及 DUO 版本和 DUO 允许上传的文件扩展名。全部六个工具均为只读。

步骤 2 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 ChatGPT 中添加连接器

你的服务器 URL： 在 AnythingMCP 中，打开 MCP Servers → 此连接器所在的服务器，并复制其 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都使用它。

ChatGPT 在其 Plugins 页面上将 MCP 服务器作为插件添加，支持网页端和付费套餐。不再需要开发者模式。在 Business 工作区中，只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。

1. 前往 chatgpt.com/plugins，点击 Add，然后点击 Add custom MCP server。
2. 输入名称，例如 Name: DATEV Online APIs (Sandbox)。
3. 在 Connection 下，输入 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，并将 Authentication 保持为 OAuth。
4. 选择 I understand and want to continue，然后点击 Create as a plugin。当 ChatGPT 提示时，登录 AnythingMCP 并允许访问。
5. 从你的个人插件中安装新插件，然后在聊天中输入 @ 并选择它。

可用工具

常见问题

免费版 ChatGPT 可以使用自定义 MCP 服务器吗？ OpenAI 仅为付费套餐提供自定义 MCP 服务器的文档说明；免费版不在其列表中。

后续步骤

• 连接器落地页
• 连接到 Claude