ainecto——AiNecto CLI和MCP连接器
发表于 ainecto, (中文(简体) ), @ainecto/mcp 财务报告和审定财务报表 @ainecto/cli - 同一个代码。 命令 : ainecto。 。 。 .
每台机器一次: npx -y ainecto@latest setup ——通过浏览器(一次)将您签入,检查
连接,并将 Claude 代码、 Cursor 和 Codex 连接到 AiNecto 服务器地址
(单位:千美元)https://ainecto.com/mcp) (中文(简体) ). 每一个特工在第一次连接时就自己签到AiNecto.
每个AI会场都可以看到相同的AiNecto工具. 您的 AiNecto 将决定要改变什么工具 在它所触及的工作空间、项目或文档上的权限——服务器拒绝其余的。 还有 没有会话角色(设计/开发/测试/验证在0.8.0中被删除).
对于人工智能特工
运行 npx -y ainecto@latest setup (使用长命令超时——至少6分钟:登录等待)
至用户5分钟)。 然后运行 npx -y ainecto@latest doctor 并按其说.
setup注册服务器地址,所以每个代理签名 第一次: Claude Code - 运行/mcp并签名到ainecto; 光标-何时签名ainecto在其 MCP 中询问 设置; 编码器 - 符号在setup连接它( 浏览器标签打开, 登录链接为 打印到 stderr; 如果未完成, 运行codex mcp login ainecto) (中文(简体) ).- 要将 AiNecto 的工作规则添加到仓库中, 运行
npx -y ainecto@latest init从它的根。 这个 不要求角色或项目. - 会话期间添加的服务器在该会话中没有可用 . 继续通过CLI:
npx -y ainecto@latest tools list财务报告和审定财务报表npx -y ainecto@latest tools call <tool> '<json>'。一个新的 会话加载 MCP 工具. - 如果结果指定了一个工具名称,该工具未包含在您的工具列表中,则会话开始于该工具之前 添加 —— 启动新的会话,或如上通过CLI调用.
- Claude Code 的自动模式可能用
npx如果有,请询问用户 允许命令. - ChatGPT, Claude等应用程序:参见 https://ainecto.com/docs/被启动/连接-你的代理/
设置这个机器
npx -y ainecto@latest setup # sign in, check, connect Claude Code · Cursor · Codex
npx -y ainecto@latest setup --dry-run # show what it would do — no sign-in, no changes
npx -y ainecto@latest setup --local # connect through the local relay instead (see below)
npx -y ainecto@latest setup --undo # remove the connections setup made (sign-in stays)
npx -y ainecto@latest status # who is signed in, your AiNecto role, what is connected
npx -y ainecto@latest doctor # what is missing, and the one command that fixes each item
setup 连接每个客户端并报告 connected, (中文(简体) ), updated, (中文(简体) ), kept (别人的)
ainecto 进入,未触及), not installed,或 failed如果有任何客户失败,它说“部分”和
1号出入口:
- 克劳德代码..
claude mcp add --transport http -s user ainecto https://ainecto.com/mcp(用户范围). 签名/mcp在一个会议. - 光标 — 合并
"ainecto": { "url": "https://ainecto.com/mcp" }输入~/.cursor/mcp.json,保留 您的其他服务器 。 Cursor 请您从它的 MCP 设置中签名 . - 编码 -
codex mcp add ainecto --url https://ainecto.com/mcp. Codex 立即开始登录 (浏览器标签打开;);setup通过 Codex 的输出, 与登录链接, 通到 stderr. 如果是这样 未在90秒内完成, Codex 显示为failed但保持连接——运行codex mcp login ainecto(重运行)setup说相同).
与 --env dev (或 --endpoint地址是环境的。 服务器地址没有版本
针:服务器更新立即到达每个代理。 输入一个年长者 setup 写
(单位:千美元)npx -y @ainecto/mcp@<version>,有或无 --role当您重写到服务器地址时
重新运行 setup· ; setup --undo 删除任意一种.
setup --local 登记本地中继器 npx -y @ainecto/mcp@<version> (stodio,钉住)
使用此机的 CLI 版本 ainecto 每个特工都签到 只在
代理无法自行签名到服务器地址; 正在运行 setup 又没有 --local 向后移动
到服务器地址.
您的 AiNecto 角色( 您的工作, 在 AiNecto 的账户设置中设置) 由 setup 财务报告和审定财务报表 status; 大赦国际使用
对投出的解释来说,它不会改变权限.
设置寄存器( 可选)
npx -y ainecto@latest init # .ainecto/HARNESS.md, an AGENTS.md block (and CLAUDE.md if present), .ainecto/config.json
npx -y ainecto@latest init --mcp # also .mcp.json (Claude Code) and .cursor/mcp.json (Cursor), with the server address
npx -y ainecto@latest init --mcp --local # the same files with the local relay instead
npx -y ainecto@latest init --dry-run # the same plan, nothing written
npx -y ainecto@latest init --undo # remove what init wrote
npx -y ainecto@latest init --agent tester # name the agent working in this folder (see below)
-
--agent <name>指定在此文件夹中工作的代理。 它把名字写给.ainecto/agent.local(保持它关闭) 并把它放入.mcp.json, (中文(简体) ),.cursor/mcp.json财务报告和审定财务报表.codex/config.toml——服务器地址条目获得信头X-AiNecto-Agent-Name,本地继电器 获得--agent <name>。重新运行init保持名称.ainecto tools call …在此文件夹中运行 同一个名字。 服务器检查名称; 拒绝的名称停止init在文件被写入之前 ..codex/config.toml仅当它尚未存在时才写出(或者它写出) 一个值得信赖的项目. -
init从服务器获取规则——--dry-run所以计划是真实的 如果不行的话 (没有签名, 离线), 它表示哪个文件会得到这个包的默认文本 . -
如果这台机器还没签字,
init打开浏览器一次( e)--dry-run从来没有。 这个 登录的 URL 先被打印( 与--json作为JSON的一条线在 Stderr:{"event":"login_url","url":…}) (中文(简体) ). -
它从 git 寄存器的子文件夹中运行时停止,并告诉你根.
-
--mcp写入服务器地址, 如setup数字 :.mcp.json获得"ainecto": { "type": "http", "url": "https://ainecto.com/mcp" }(Claude代码需要type和.cursor/mcp.json获得"ainecto": { "url": "https://ainecto.com/mcp" }。每个代理签名 第一次的时候.--local写入被绑定的本地中继器取而代之(参见 Connectionor Mode). -
先前设立的仓库 (单位:千美元)
.mcp.json与npx -y @ainecto/mcp…,有或无--role: 重新运行npx -y ainecto@latest init它重写现有的ainecto输入服务器地址 (或与--local,以不包含--role),并放弃了旧的project从字段.ainecto/config.json(除非你换了) 一个ainecto条目指向 别的地方就剩一个人了 在那之前,旧条目继续工作:--role已接受,并 被忽略 。 旧旗( 二--role, (中文(简体) ),--project, (中文(简体) ),--project-name, (中文(简体) ),--yes) 被一行音符忽略.
图标
偏爱 npx -y ainecto@latest <command>。要安装一次,请使用 npm install -g ainecto - 不过..
只安装 一个 联 合 国 ainecto, (中文(简体) ), @ainecto/mcp 财务报告和审定财务报表 @ainecto/cli 全球范围:它们是相同的代码
和所有船只 ainecto 命令,所以第二个全局安装冲突。 ()@ainecto/mcp 还携带
mcp,桥. )
ainecto auth login # once per machine (and per --env) — `setup` does this for you
ainecto auth status
ainecto auth logout
ainecto tools list
ainecto tools call list_projects --json
ainecto tools call erd_apply_changes -f changes.json --json
cat payload.json | ainecto tools call erd_apply_changes --json
ainecto projects list
ainecto erd apply-changes -f erd-operations.json --yes
工具名称是服务器的自有名称( T)list_projects, (中文(简体) ), erd_apply_changes(中文(简体) ). 你的人工智能客户端
以自己的前缀显示它们, 例如 mcp__ainecto__list_projects claude 代码; CLI
不使用前缀。 开始的工具名称
服务器老了 mcp__ainecto__ 前缀仍然被接受.
每个命令都用 --env dev 页:1 https://dev.ainecto.com/mcp。结束点分辨率优先级:
--endpoint <url>AINECTO_MCP_ENDPOINT--env dev- 生产默认,
https://ainecto.com/mcp
端点 URL 必须使用 https:常规 http: 只接受本地主机回回转目标
作为 127.0.0.1时 AINECTO_TOKEN 设置, CLI 只将其发送到默认的 prod/ dev 端点
除非 AINECTO_ALLOW_CUSTOM_ENDPOINT_TOKEN=1 为明确信任的自定义终点设置.
命令是 ainecto 财务报告和审定财务报表 mcp (哪个) npx -y @ainecto/mcp 运行)。 这个 AINECTO_* 环境
以上变量为 仅限 这些设置的名称 – 不要猜测另一个前缀 .
生成友好命令
每个已检查的生成目录工具可以通过它的决定性命令路径到达 。 斯卡尔 schema 字段作为旗帜被曝光,同时接受kebab 和 schema 字段:
ainecto documents list --project-uuid <projectUuid>
ainecto documents list --projectUuid <projectUuid>
阵列或物体有效载荷使用第一当事方的CLI JSON有效载荷读取器:
ainecto documents create -f create-documents.json
cat erd-operations.json | ainecto erd apply-changes --json
破坏生成的命令在人类模式中迅速,除非 --yes 提供。 单位 --json 模式
除非 --yes 已存在.
附件文件的上传可通过一个执行上传脚本、生字的铃声命令提供 PUT 和附件注册流程 :
ainecto attachments upload --document-uuid <documentUuid> ./diagram.png ./notes.pdf
生成的 request_upload_token 财务报告和审定财务报表 upload_attachments 路径仍为原始 MCP 辩证合同
命令,不读取本地文件.
收件箱投票——为计时器(cron, slowingd),仅在某事出新时才叫醒代理. 退出
代码 : 0 新项目, 3 没有什么新鲜事, 1 错误, 2 使用错误. notifications poll 保存批次
至光标文件后再打印,再打印同一批,直到 notifications ack (运行)
只有在代理商处理了这批货之后才这样做. agent-todos poll --only-new 仅对待办事宜退出 0
从未见过(见所见文件)。 两个都拿 --workspace <uuid> 财务报告和审定财务报表 --project <uuid>, (中文(简体) ),
每个重复:任何给定的工作空间和任何给定的项目。 每个过滤器是它的
拥有通知流, 所以每个过滤器使用一个光标文件 .
ainecto notifications poll --direct-only --cursor-file ~/.ainecto/inbox.cursor --json > /tmp/inbox.json \
&& claude -p "Summarize these AiNecto notifications: $(cat /tmp/inbox.json)" \
&& ainecto notifications ack --cursor-file ~/.ainecto/inbox.cursor
ainecto agent-todos poll --only-new --seen-file ~/.ainecto/todos.seen --json > /tmp/todos.json \
&& claude -p "Review these AiNecto to-dos and only summarize them: $(cat /tmp/todos.json)"
背后的服务器工具( Namelist_notifications, (中文(简体) ), list_agent_todos, (中文(简体) ), update_agent_todos, (中文(简体) ),
list_history)也是生成命令(ainecto notifications list, (中文(简体) ), ainecto agent-todos list, (中文(简体) ),
ainecto agent-todos update -f …, (中文(简体) ), ainecto history list一旦服务器曝光了它们.
终端会话
ainecto term 关闭终端窗口后继续运行终端会话 — 没有 tmux 或 cmux
需要帮助。 一个背景进程,根据需要开始,拥有每个会话并保持它的屏幕,所以代理和
脚本可以键入会话并读取其屏幕,也可以从任何终端应用中附加. 它继续运行
仅此机器; 它不使用您的 AiNecto 登录 .
ainecto term new api --cwd ~/code/api -- claude # start a session (without a command: your login shell)
ainecto term ls [--json]
ainecto term send api "run the tests" # types the text, without Enter
ainecto term key api enter # one key — see below
ainecto term read api [--lines N] [--scrollback] [--json]
ainecto term wait api --match 'passed' [--timeout 600] # until a screen line matches (seconds)
ainecto term attach api # detach with Ctrl-\ then d
ainecto term kill api
ainecto term kill-server # every session and the background process
ainecto term restore # after a reboot: start again what was running
- 密钥
key数字 :enter, (中文(简体) ),tab, (中文(简体) ),shift-tab, (中文(简体) ),escape, (中文(简体) ),backspace, (中文(简体) ),delete, (中文(简体) ),space, (中文(简体) ),up, (中文(简体) ),down, (中文(简体) ),left, (中文(简体) ),right, (中文(简体) ),home, (中文(简体) ),end, (中文(简体) ),pageup, (中文(简体) ),pagedown, (中文(简体) ),ctrl-a.ctrl-z(单位:千美元)ctrl+c, (中文(简体) ),esc财务报告和审定财务报表return也接受. send --paste当应用程序要求时, 将文本作为括号内粘贴发送 。 发送开始的文本 与-,放在后面--。 。 。 .- 单位
attach按钮Ctrl-\两次发送一个Ctrl-\对应用程序. - 在会场里,
AINECTO_TERM_SESSION持有它的名字。 名称不变; 要重命名, 杀死 重新开始. restore重新启动正在运行的每个会话( 名称、 文件夹、 命令) , 环境为 贝壳你运行它。 它不会带回 程序在记忆中拥有的, 没有重启它 在重启后拥有的 自行退出的会话被遗忘;kill财务报告和审定财务报表kill-server忘记他们的.- 文件在
~/.ainecto/term/控制套接字,sessions.json(怎样)restore开始)和daemon.log(每个请求一行,每个答复一行;保留到10 MB+1个更老) 文档,daemon.log.1) (中文(简体) ). 输入的文本、屏幕和环境值没有记录. - 一个命令等待了多久, 三个不同的限制:
- 运行中的背景进程每次请求最多等待10秒的答案;然后是 命令以错误停止,并删除任何内容.
- 开始背景进程每次尝试最多等待10秒,最多3次尝试即可报告.
wait自己等待着--timeout(没有它,直到模式出现或会话结束).
- 平台:macOS,和有glibc在20.js 20.8.0或更新(其余CLI运行于Node 18)上的Linux.
还没有Windows。 它使用可选依赖
node-pty,用于预建的二进制 — 没有编译器 需要帮助。 如果无法安装,ainecto term说到这里,其他命令继续运作.
连接模式
ainecto mcp [--env dev]
包作为解决的 stdio- to- HTTP 代理 /mcp 终点 它代表着
initialize, (中文(简体) ), tools/list,以及 tools/call,不重写远程计划,也不解释
本地文件引用 。 它使用这台机器的 单个登录(ainecto setup, (中文(简体) ), ainecto auth login,或
登录 ainecto init ),从不单独打开浏览器.
这是条目 setup --local 财务报告和审定财务报表 init --mcp --local 写 —— 一般不用手加入
(无) --local 他们写服务器地址,如上:
{
"mcpServers": {
"ainecto": {
"command": "npx",
"args": ["-y", "@ainecto/[email protected]"]
}
}
}
旧条目 --role <name> (或 AINECTO_ROLE)仍然开始:数值被忽略,单行
注释到 stderr,服务器只记录旧设置仍在使用中。 如果有会议
不见 AiNecto 工具, 另一个 ainecto 条目(例如Claude Code的地方范围)可能是
藏起来 ainecto doctor 检查这个.
MCP 书记官处
server.json 是书记官处条目 com.ainecto/mcp (与 package.json#mcpName) (中文(简体) ). 这个
列出服务器地址 https://ainecto.com/mcp (远程可流式HTTP——什么) setup 登记册)和
npm 软件包 @ainecto/mcp (桥梁) setup --local 财务报告和审定财务报表 init --mcp --local ),写作. 书记官处
发布时需要npm版本 它的引用 mcpName所以先发布npm.
登记由下列人员进行:
npm run release -- --otp=<code>(以下)这样@ainecto/mcp@<version>这是npm.- 域名登录
ainecto.com(HTTP: ) (韩语)https://ainecto.com/.well-known/mcp-registry-auth必须 服务公钥; 私钥位于macOS密钥链:mcp-publisher login http --domain ainecto.com --private-key "$(security find-generic-password -s codelive-mcp-registry -a ainecto.com -w)"。 。 。 . mcp-publisher publish从此文件夹中.
最多为0.8.1 io.github.codelives/ainecto (只有包装);在
首个 com.ainecto/mcp 发布。 详细情况 docs/mcp-registry-registration.md。 。 。 .
发展
npm install
npm run typecheck
npm test
npm run build
npm link # puts `ainecto` on your PATH
目录同步
sync:tools --check 用于发布时间的活体漂流检查。 当它迅速失效时
AINECTO_CATALOG_SYNC_TOKEN 缺少,所以自动发布不能无声地回到固定状态.
为了地方发展, sync:tools 也可以使用来自 ainecto auth login --env <env>。 。 。 .
AINECTO_CATALOG_SYNC_TOKEN=... npm run sync:tools -- --env prod --check
AINECTO_CATALOG_SYNC_TOKEN=... npm run sync:tools -- --env dev --check
已检查生成的目录是确定性产出 tools/list从,活的 - synced from
https://ainecto.com/mcp 财务报告和审定财务报表 https://dev.ainecto.com/mcp。演示文稿元数据分别存在于
src/core/catalog/enrichments.ts。 。 。 . ainecto tools catalog 打印本地生成的目录.
当地打球烟
npm pack
npm exec --package ./ainecto-mcp-<version>.tgz -- ainecto --help
现场直播Dev MCP 烟
这需要从 ainecto auth login --env dev 或本地开发者
AINECTO_TOKEN。 。 。 .
npm run smoke:mcp -- --env dev
烟雾将MCP初始化 tools/list,电话 list_projects,仅打印汇总
元数据,如工具计数和任务工具曝光.
本地附件上传烟雾
这充分锻炼 attachments upload 相对于本地 API dev 服务器的流: OAuth MCP 令牌
, REST 固定文档创建, CLI 上传, list_attachments,和服务器文件系统字节
核查.
npm run smoke:attachments -- --base-url http://localhost:8080 --endpoint http://localhost:8080/mcp --api-root <path-to-api-repo>
烟雾造成一个临时用户/工作空间/项目/文件,并去除固定账户,当地
临时文件,并存储上传文件,除非 --keep 提供.
释放
npm run release -- --otp=<code> 运行类型检查、测试和构建一次,然后发布在
三个名字: @ainecto/mcp (小学), ainecto,以及 @ainecto/cli (仅限 ainecto 页:1.
--dry-run 显示什么会出去。 已发布的名称被跳过, 因此在过期后重试
代码是安全的。 npm 账户需要写入访问权限 @ainecto org(脚本检查)。 别
解开任何名字.
已知的限制
- MCP连接器执行新线限制的stio JSON-RPC到HTTP JSON-RPC. 可流式 HTTP SSE
答复和答复
MCP-Session-Id未执行会话处理 .