伊诺-米克p

用于 伊诺 爱普。 将克劳德,Cursor或VS代码等AI助手连接到你自己的Inio数据:客户,发票,暂停,重试尝试和支付.

状态 : 0.7.0. 默认情况下只读, 带有选入的写工具; stdio 或 a 共享 HTTP 服务器已公布为 @dnmitev/inio-mcp 直到它移动到 @inio 范围.

安装

您需要Node.js 24或后期的Inio API客户端证书(OAuth2客户端证书用于您的Inio API域).

export INIO_CLIENT_ID=...       # your Inio API client id
export INIO_CLIENT_SECRET=...   # your Inio API client secret
export INIO_AUTH_URL=...        # token endpoint (or realm issuer URL) of your Inio API realm
export INIO_URL=...             # Inio API gateway base URL, including /v1
npx -y @dnmitev/[email protected]

快速启动( Claude 桌面)

将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (温道: %APPDATA%\Claude\claude_desktop_config.json)并重新启动 Claude 桌面 :

{
  "mcpServers": {
    "inio": {
      "command": "npx",
      "args": ["-y", "@dnmitev/[email protected]"],
      "env": {
        "INIO_CLIENT_ID": "your-client-id",
        "INIO_CLIENT_SECRET": "your-client-secret",
        "INIO_AUTH_URL": "https://<your-keycloak>/realms/<realm>/protocol/openid-connect/token",
        "INIO_URL": "https://<your-inio-api-gateway>/v1"
      }
    }
  }
}

文件以平白文本保存客户端的秘密; 仅由您保存可读( Namechmod 600) (中文(简体) ). 然后问,例如:"C-1001客户的开出发票是哪张?" 更多提示 : 实例。 。 。 .

设置客户端

每个指南覆盖本地服务器(npx)在多克运行,并连接到主机团队服务器:

Claude在网络上,桌面和移动可以使用主机服务器作为连接器,您自己登录,没有安装任何信息: 文件/设置/声明-网络.md。 。 。 .

为整个团队运行一个服务器 托管共享服务器。 。 。 .

想要在自己的云或代理平台运行的Inio客户端,拥有自己的Inio API认证: 为Inio客户提供自营服务。 。 。 .

固定和核查

实例pin版本0.7.0. 升级时故意更改版本;不要丢弃. pin 覆盖了套件本身: npx 仍然在每一个新安装上解决其声明范围内的依赖性.

• 无 : 软件包以 npm 出处发布。 软件包npmjs.com页面上的"证明"部分显示其构建的源寄存器和工作流程; 2; npm view @dnmitev/[email protected] dist.attestations 给出记录它们的证明包的 URL. npm audit signatures,在安装软件包的工程中运行(例如 npm init -y && npm i --ignore-scripts @dnmitev/[email protected] && npm audit signatures),检查登记签名和安装的所有设备的出处证明.
• 嵌入器 : 查阅摘要 docker buildx imagetools inspect ghcr.io/dnmitev/inio-mcp:0.7.0 和使用情况 ghcr.io/dnmitev/inio-mcp@sha256:<digest>。将文摘包固定在您下面不会改变标记;它本身并不能证明是谁创建了图像.

工具

这些工具只读取. 结果被压缩(空值下降)。 调整取决于客户类型:业务客户(B只有发票链接和SSN已编辑;消费者(C)和未知类型也有联系方式,地址,城市,名称,参考文献,SSN和银行细节被编辑. INIO_REVEAL_PII=true 关掉 见 数据保护 准确的名单.

细节工具的选项 :

• get_invoice 带 withInherited 添加继承值(IBAN、银行、有效暂停)。 有了发票号码,就给API打了两次电话.
• get_invoice 财务报告和审定财务报表 get_customer 带 includeWorkflowSettings 应添加 workflowsSettings (分配方法、升级费和时间、启用阶段)。 它很大,所以默认关闭.

如果 Inio API 限制请求( HTTP 429), 服务器等待 Retry-After (最多5 s) 并重试一次;第二个429作为返回 RATE_LIMITED。 。 。 .

写作工具( opt- in)

写入工具仅在服务器运行时注册 INIO_ALLOW_WRITES=true。它们被标记为破坏性,所以MCP客户端可以要求您确认每个呼叫(Claude桌面确实如此,除非您永久允许该工具). 印地安组织的审计领域记录的每封信 inio-mcp。 Inio API 对 API 客户端没有作用 : 已启用写入, 这些工具所能做的都允许您的证书 。 要缩小范围, 请只列出您需要的工具 INIO_WRITE_TOOLS 上限付款 INIO_MAX_PAYMENT_AMOUNT。 。 。 .

不要永久允许(自动批准)在客户端中写入工具 。 确定步骤是,在到达伊尼奥之前,你捕捉到错误的数量,客户或日期.

如果一个写出时间,无法到达API或得到服务器错误(HTTP 5xx),修改可能已经应用,也可能没有应用,结果说在再次尝试之前先检查客户或发票. 如果 API 接受一个书写但无法读取其答案,则工具报告成功,在重试前要检查一个注释.

无法提供:倒置付款(公共API不披露倒置需要的付款分配标识)并开具发票(创建一张立即发送给终端客户)。 用伊尼奥的后台做这些.

日志

服务器将 JSON 日志行写入 stderr (stout 包含 MCP 协议). Claude 桌面保存到 ~/Library/Logs/Claude/mcp-server-inio.log。每个工具调用记录其持续时间、结果、大约象征性成本(approxTokens)和称为它的MCP客户端(名称和版本,例如克洛德桌面;仅当客户端与每个请求一起发送时,在HTTP之上). 写入通话并日志 write: true 和他们更改的识别标志target:客户、发票、信用发票或暂停编号或号码;金额、联系方式和其他论点不记录。 启动行列出已注册的写作工具和支付限额. 设定 INIO_LOG_LEVEL=debug 也可以看到每个 API 呼叫和符号刷新。 秘密和信物从未被记录.

解决问题

数据保护

工具的服务器编辑结果( 除非 INIO_REVEAL_PII=true)取决于客户类型(customerType) (中文(简体) ). 结果中的每个对象都使用自己的类型;没有一种对象(发票,暂停)跟随它所坐入的对象.

商业客户(B) (中文(简体) ). 公司和联系方式都是商业数据,经常公开,所以只有发票链接(任何持有链接的人都可以打开发票)和个人身份号码(唯一交易商的SSN)才会被修改:

• pdfURL, (中文(简体) ), digitalInvoiceURL, (中文(简体) ), ssn

消费者C)和未知类型. 个人的详情是个人资料:

• 名称中包含的任何字段 email (例如:. distributionEmailAddress)和任何文本中的电子邮件地址
• 名称中包含的任何字段 phone (例如:. mobilePhoneNo(中文(简体) )
• 地址行 : addressLine, (中文(简体) ), addressLine1, (中文(简体) ), addressLine2,, , , , , , , ,
• zipCode, (中文(简体) ), city
• customerName, (中文(简体) ), yourReference
• ssn
• iban, (中文(简体) ), bankAccount, (中文(简体) ), accountNumber
• 发票链接 : pdfURL, (中文(简体) ), digitalInvoiceURL

发票上没有客户类型,所以 get_invoice 查一查发票的客户(在服务器重启前一直被查取,因此其类型改变的客户会将旧规则保存到那时),如果查取失败,则使用消费者规则. 通过写作工具退回的发票总是使用消费者规则.

错误消息总是隐藏电子邮件地址,以及上面列出的消费字段的每字段错误消息(对于两种客户类型),即使有 INIO_REVEAL_PII=true。其他错误文本按 API 给定时返回。 其他一切随API的提供而归还,包括组织和增值税号码、票据和其他免费文本、发票说明、金额和发票阶段.

• 工具结果到您的助手后面的 LLM 提供者( 例如 Claude 的 Anthropic, 或是您在 Cursor 或 VS 代码中选择的模型提供者) 。 贵组织需要与提供商达成数据处理协议,涵盖客户数据.
• SSN等写作工具的参数、联系方式和地址 create_customer 财务报告和审定财务报表 update_customer,在您的即时和工具呼叫中。 不管怎样,他们都会找到供货商 INIO_REVEAL_PII 说.
• 服务器什么也不存. 它只把Inio访问符记在记忆中.
• 日志(stderr)包含工具名称,期限和结果. API 失败的电话通过路径登录,路径可以包括客户或发票号码或ID debug 平分每个API呼叫是。 日志中从不包含符号,秘密或工具结果.

发布模式

inio-mcp有一个单一的维护者. 发行版本仅由GitHub Actions发布工作流程发布,从版本标记:它发布到npm并有出处,将图像推向GHCR. 见 固定和核查 如何检查释放。 软件包移动到 @inio gitHub公司组织;README将说何时.

发展

要从源头运行, 克隆寄存器, 运行 npm ci && npm run build,并指定客户端 node /absolute/path/to/iniomcp/dist/index.js。 。 。 .

许可证

Apache 许可证 2.0。许可证只涵盖此源代码。 它不允许访问 Inio API; 您需要自己的 Inio API 证书 .