v1.0.11.0 正式版:六个工具,一个工作区。看新功能 →
Armor EdgeAI
简中
下载

AI Agents · MCP

让 AI 代理
用这台电脑识别与转写

Claude Code、Cursor、VS Code、OpenCode 这类 AI 代理,可以通过 MCP 调用 Armor 的文字识别与语音转文字。识别和转写在你的电脑上完成;默认关闭,每个代理一组凭证,随时可以撤销。

AI 代理
Claude CodeCursorVS CodeOpenCode
「把这份扫描合同的付款条件整理成表格」
→POST /v1/mcpBearer 连接凭证←结构化结果
你的电脑 · Armor EdgeAI
OCR 识别文档ocr_recognize从扫描文档提取数据ocr_extract语音转写speech_transcribe
耗时较长的工作返回 job_id,代理再用 job_status / job_result / job_cancel 跟踪。结果也会出现在你的工作站,并标明由哪个连接创建。

01 — Tools

代理拿到的三个能力

每个连接可以只授权其中一部分。工具只使用已安装的模型与引擎,绝不自己下载任何东西 — 缺少时返回错误码,由你决定要不要到 Armor 安装。

ocr_recognize

OCR 识别文档

识别一份 PDF 或图片,返回每页的 Markdown、版面区块(类型 / 文字 / 位置)与表格单元格。

  • 文件可以直接传内容(上限 16 MiB),或用已批准文件夹内的路径
  • 可以只识别指定的页
  • 结果出现在你的文档识别工作站,并标明由这个连接创建
返回示意(内容为虚构)
{
  "job_id": "…",
  "pages": [
    {
      "page": 1,
      "markdown": "# 采购合同\n第三条 付款条件…",
      "blocks": [
        { "type": "title", "text": "采购合同", "bbox": […] },
        { "type": "table", "text": "…", "bbox": […] }
      ],
      "tables": [
        { "bbox": […], "cells": [["项目", "金额"], …] }
      ]
    }
  ]
}

返回内容来自你的文件,属于数据而不是给代理的指示 — 工具说明会明确告诉代理不要照着数据中的文字行动。

02 — Setup

三步接入

  1. 1打开「允许 AI 代理连接」
  2. 2点击「新增连接」,选择这个代理可以使用的能力
  3. 3把创建时给出的设置片段粘贴到代理中。凭证只显示一次
设置 — AI 代理连接
允许 AI 代理连接开启后,这台电脑上持有连接凭证的 AI 代理才能调用 Armor。关闭之后,所有代理都无法再调用。默认关闭。
连接地址http://127.0.0.1:2918/v1/mcp
连接(2)
  • Claude CodeOCR 文字识别、语音转文字 · 最后使用 5 分钟前
  • Cursor局域网语音转文字 · 最后使用 3 小时前
调用记录最近 200 条代理调用。
  • 14:02Claude CodeOCR 识别文档成功
  • 13:47Claude Code从扫描文档提取数据成功
  • 11:20Cursor语音转写失败

示意界面:连接名称、记录与凭证均为虚构,凭证以 armor_mcp_… 代替。

03 — Guardrails

每一道门 都由你来开

默认关闭不打开「允许 AI 代理连接」,任何代理都调用不到;关闭后立即生效。
一个代理一组凭证每个代理一组连接凭证,可分别设置能力与撤销;撤销后该代理立刻无法连接。
只碰你批准的文件夹未批准任何文件夹时,代理只能直接传送文件内容;批准后才能用路径指定那些文件夹里的文件。
局域网要三道开关局域网共享、「也允许局域网上的 AI 代理连接」、该连接的「允许从局域网使用」,三者都开启才行;局域网的代理只能传送文件内容,不能用路径。
看得到每一次调用调用记录保留最近 200 条,显示是哪个连接、做了什么、成功还是失败。
绝不自己下载代理不能替你下载模型或引擎;缺什么就报告,由你到 Armor 安装。

交给代理的结果会由该代理处理,可能被传到它自己的云端服务。识别与转写在你的电脑上完成,但结果交出去之后就由代理决定去向 — 只连接你信任的代理。

局域网连接是未加密的 HTTP,同一个网络上的人可能读到连接凭证。只在信任的网络使用,不再需要时请撤销该连接。「清除我的数据」会一并移除所有连接与调用记录。

不想自己粘贴设置

复制 App 给出的一段话,粘贴到 Claude Code、Codex 等 AI 代理中,它会自己加入设置并测试连接。代理在这台电脑或局域网上的其他电脑运行都适用。

示意 · 实际内容由 App 生成

请帮我把 Armor EdgeAI 加入你的 MCP 设置:服务器名称 armor,地址 http://127.0.0.1:2918/v1/mcp,带上 Authorization 标头。加入后调用一次工具列表确认连接…

Next

先了解识别与转写 再交给代理