如何通过 MCP 将 1C:Enterprise 连接到 Microsoft Copilot

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → 1C:Enterprise、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

1C:Enterprise + Microsoft Copilot

通过标准 OData 接口读取你的 1C:Enterprise 8.3 信息库 (1С:Бухгалтерия、Управление торговлей、1С:ERP、УНФ 及其他配置)：目录、含表格部分的单据、登记簿的余额、发生额和切片，名称来自你的配置自身的元数据。只读，Basic 认证，使用你自己的服务器。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

ONEC_BASE_URL, ONEC_USER, ONEC_PASSWORD

步骤 1 — 获取凭证

设置大约需要 30 分钟，需要你的 1C 管理员参与。你需要一个 1C:Enterprise 8.3 信息库 (平台 8.3.5 或更高版本)，它已发布到 Web 服务器并开启了标准 OData 接口，另外还需要一个专供连接器使用的 1C 用户。

1. 把信息库发布到 Web 服务器 (Apache 或 IIS，并安装平台自带的 Web 服务器扩展模块)。在 Designer 中打开 Администрирование → Публикация на веб-сервере (Administration → Publish to web server)，用拉丁字母给发布命名，勾选 Публиковать стандартный интерфейс OData (Publish standard OData interface) 后发布。如果信息库托管在 1C 托管服务商 (1cFresh、云租用) 那里，请让服务商为它开启 OData。
2. 决定 OData 可以显示哪些对象。 默认情况下，接口不公开任何对象。在典型配置中，打开 Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData (或 Все функции → Обработки → Настройка стандартного интерфейса OData)，添加允许 AI 读取的目录、单据和登记簿。在其他配置中，由开发人员调用 УстановитьСоставСтандартногоИнтерфейсаOData()。
3. 创建一个专用的 1C 用户：给它这些对象的只读角色，以及使用标准 OData 接口的权限。第 2 步的设置界面也可以帮你创建这个用户。
4. 在浏览器中检查：在发布地址后面加上 /odata/standard.odata/?$format=json 打开，并用该用户登录。看到对象的 JSON 列表说明 OData 正常；列表为空说明第 2 步还没做。
5. 把发布地址填入 ONEC_BASE_URL：也就是你打开 Web 客户端用的地址，不带 /odata，末尾也不带斜杠，例如 https://1c.example.com/trade。在 ONEC_USER 中填写与信息库用户列表完全一致的用户名 (支持西里尔字母)，在 ONEC_PASSWORD 中填写其密码。
6. 安装连接器并运行 onec_enterprise_describe_service：它会列出发布到 OData 的所有对象及其键。列表为空说明 OData 组成中还没有添加任何对象。

服务器必须可访问：AnythingMCP Cloud 只能访问公网地址，所以请在公网主机上通过 HTTPS 发布；密码通过 HTTP Basic 认证发送。如果 1C 服务器在你的内网中，请在内网自行部署 AnythingMCP (或通过 VPN 连接)，并把该主机加入 SSRF_ALLOWED_HOSTS。

可读取的内容：目录、含表格部分的单据、信息登记簿、累积登记簿和会计登记簿、科目表、常量和单据日志，名称来自你的配置的元数据，通常是俄语：Catalog_Номенклатура、Document_РеализацияТоваровУслуг 及其明细行 Document_РеализацияТоваровУслуг_Товары、AccumulationRegister_ТоварыНаСкладах、AccountingRegister_Хозрасчетный。它适用于该平台上的所有配置：1С:Бухгалтерия предприятия、Управление торговлей、1С:ERP、Комплексная автоматизация、УНФ、Розница、ЗУП 以及自定义配置。

余额、发生额和切片：对于登记簿，AI 用 onec_enterprise_get 读取虚拟表 Balance、Turnovers、BalanceAndTurnovers、SliceLast 和 SliceFirst，由 1C 在服务器端筛选和汇总，而不是由 AI 去累加成千上万行单据明细。这样它就能回答某个日期的库存、某段时间的销售额、最新汇率或科目 62.01 的余额等问题。

AI 的工作方式：onec_enterprise_guide 免费讲解名称、筛选和登记簿。onec_enterprise_describe_entity 显示对象的字段及其类型，onec_enterprise_query 按筛选、排序、字段选择和分页读取列表，onec_enterprise_get_entity 按 Ref_Key 读取单个对象及其表格部分。像 Контрагент_Key 这样的引用字段保存的是 GUID；AI 会查出对应名称，而不是把 GUID 展示给你。

准确的合计：AI 只统计已过账的单据 (Posted eq true)，并排除标记为删除的对象，除非你特别要求。日期不带时区，是信息库的本地时间。金额默认是单据币种，除非字段另有说明。

只读：没有任何工具会写入。连接器从不创建、修改、过账或删除任何内容，因此无需确认，安装时也没有被关闭的工具。真正的边界是 1C 用户的权限：1C 在每次调用时都会检查权限，用户无权查看的内容不会出现在结果中，看起来可能像是缺少数据。

限制：没有固定的调用次数上限，但每次查询都在你的 1C 服务器上运行。对于大型目录和登记簿，AI 总会设置 $top 和 $select，并分页读取长列表。

常见错误：401 表示 1C 拒绝了登录，请检查用户名、密码以及使用标准 OData 接口的权限。403 表示用户已登录，但无权读取该对象，请给其角色授予读取权限。404 表示该对象不在 OData 组成中、名称拼写有误，或 ONEC_BASE_URL 不正确 (其中不能包含 /odata)。带有 "Ошибка при разборе опции запроса" 的 400 表示筛选条件或字段名有误。文件型信息库上出现 500，通常是 Web 服务器账户对信息库文件夹没有写权限。

该连接器不会创建、过账或删除单据，并且只能看到管理员加入 OData 组成的对象。

步骤 2 — 安装 adapter

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 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 1C:Enterprise 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

• “主仓库今天每个物料的库存是多少？哪些物料少于 10 件？”
• “9 月我们给 Romashka LLC 发了多少货？请按已过账的销售单据分别列出。”
• “找到 INN 为 7707083893 的往来单位，列出我们上个月给它开具的发票。”
• “1C 里今天登记的美元汇率是多少？”
• “9 月底科目 62.01 的余额是多少？由哪些客户构成？”

FAQ

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse