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

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

1C:Enterprise + Cursor

通过标准 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 — 在 Cursor 中添加连接器

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

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 1C:Enterprise 的工具。

可用工具

示例提示

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

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

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