AgentBook
指南 06

连接你的 AI 助理

你的目标

让 Claude、Codex、ChatGPT 或 Gemini 直接回答关于你自己账目的问题——用你真实的数字。

约 3 分钟 · 一个网址，点一次「允许」，不用复制任何密钥

你只需要这一个地址

https://agentbook.brainliber.com/api/v1/mcp

下面每个助理的接法都一样：粘贴这个网址，它会把你带到普通的 AgentBook 登录页， 你点一下允许，它就能读取你的账目。任何会写入账目的操作，每一次都会再问你一遍。

管理员需要先把连接器打开一次，上面这些才会生效——见指南 07。如果始终没有出现登录页面，先去找管理员。

Claude

  1. 桌面版或 claude.ai设置 → 连接器 → 添加自定义连接器，粘贴网址，保存。
  2. Claude Code运行 claude mcp add --transport http agentbook https://agentbook.brainliber.com/api/v1/mcp，然后输入 /mcp 登录。

Codex

  1. 添加codex mcp add agentbook --url https://agentbook.brainliber.com/api/v1/mcp
  2. 登录codex mcp login agentbook 会打开浏览器显示「允许」页面。

ChatGPT

  1. 打开开发者模式设置 → 连接器。自定义连接器属于付费功能；在商业版或企业版里，可能还需要管理员先放行——这通常就是找不到这个选项的原因。
  2. 创建连接器起个名字，粘贴网址，认证方式选 OAuth。不要粘贴令牌：AgentBook 不签发任何令牌。

Gemini

  1. 添加gemini mcp add -t http agentbook https://agentbook.brainliber.com/api/v1/mcp
  2. 启动 Gemini第一次访问 AgentBook 时它会引导你登录。用 gemini mcp list 可以看到是否连上了。

验证它真的连上了

别问「你连上了吗」——没连上的助理照样会爽快地说连上了，然后编造数字。 放一个只有你的账户才会知道的东西，再去找它。

  1. 在 AgentBook 里添加一笔奇怪的支出商家填 Connector Check，金额 7.77，日期今天。用一个你现实中绝不会花的数，就不会碰巧撞上。
  2. 去问你的助理「用 AgentBook 查一下，这个月商家是 Connector Check 的支出有哪些。」
  3. 看答案，别看语气连上了就会返回 7.77 和今天的日期。其他任何结果——数字对不上、客气地说「我没有权限」、或者主动提出帮你添加——都说明没连上，不管它嘴上怎么说。
  4. 删掉这笔测试支出在你删掉之前，它就是一笔真实支出，会进入你的合计和税务数字。
然后试试真正要问的

「我现在手上有多少现金？」·「把我今年的支出按类别拆开。」· 「哪些发票逾期了，逾期多少？」·「记一笔 30 元的客户午餐。」

如果出了问题

你看到的怎么办
「尚未为此账户开启」连接器没打开。把指南 07 发给管理员。
始终不出现登录页删掉连接器重新添加一次。如果助理提供了 API 密钥或请求头的输入框，请留空——填了反而会挡住本来能成功的登录流程。
本来能用，后来不行了在助理里重新登录一次。如果每隔一小时左右就发生，告诉管理员——那是服务端设置，不是你的问题。
能回答问题，但拒绝记录任何东西那个助理没法向你展示确认步骤，所以 AgentBook 不允许它写入。需要改动账目时用 Claude Desktop 或 Claude Code。
税务数字用错了国家在「业务资料」里设置国家和地区。连接器读的和应用是同一份资料。

收回授权

设置 → 已连接应用，会列出你批准过的全部应用，每个后面都有撤销。 撤销会立即断开。只在助理那边删掉连接器并不等于撤销——真要收回访问权，这里也要撤销。

✓
现在助理能读取你的账目了，而要改动账目必须经你同意——每改一次，都会问一次。
← 全部指南