如何通过 MCP 将 T-Bank Business 连接到 Claude

仅限自托管。 T-Bank 的 T-API 使用由 Russian Trusted Root CA 签发的 TLS 证书，而 AnythingMCP Cloud 不信任该根证书，因此该连接器无法在 AnythingMCP Cloud 上使用。按下文说明把该根证书加入你自己运行的 AnythingMCP 实例的信任库后，即可在该实例上使用。

T-Bank Business + Claude

T-Bank Business（T-API，原 Tinkoff Business）：公司信息、账户和余额、含交易对手的账户对账单、付款确认、已开发票状态，以及银行卡收单终端和交易。只读。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

TBANK_API_URL, TBANK_API_TOKEN

步骤 1 — 获取凭证

设置大约需要 10 分钟。你需要一个 T-Bank Business 企业账户，以及一个信任 Russian Trusted Root CA 的自托管 AnythingMCP（见下文 证书）。

1. 在 T-Business（business.tbank.ru）中打开 Integrations > T-API，点击 Issue token。
2. 填写发起调用的 IP 地址；中小企业也可以选择 Disable address check。调用来自你的 AnythingMCP 服务器的地址，因此请允许该地址或关闭检查。
3. 在 What the API may access 下，至少勾选公司信息（T-Business ID）、账户信息（bank-accounts/get）和账户交易（对账单）；如需对应工具，再加上收单终端、发票和 Webhook。你可以把令牌限制在特定账户上。
4. 把令牌复制到 TBANK_API_TOKEN。它在最后一次使用后 90 天内有效，因此经常使用的令牌不会过期。要更改地址或访问范围，请签发新令牌。
5. 把 TBANK_API_URL 设为 https://business.tbank.ru/openapi。沙箱请使用 https://business.tbank.ru/openapi/sandbox 和令牌 TBankSandboxToken；沙箱的响应与你的数据无关。
6. 安装连接器并运行 tbank_get_company 检查令牌。

证书：T-API 使用俄罗斯数字发展部签发的 TLS 证书（Russian Trusted Root CA）；旧的公共证书已被吊销。不信任该根证书的服务器会在返回任何 HTTP 状态之前因证书错误而失败。请把根证书（来自 gosuslugi.ru/crt）加入 AnythingMCP 后端的 Node 信任库，例如 NODE_EXTRA_CA_CERTS=/path/russian_trusted_root_ca.pem，然后重启。

可读取的内容：令牌所属的公司（全称和简称、INN、KPP、OGRN、法律形式、税制、法定地址、注册日期和银行信息）；公司账户及其状态、类型、币种、资费和余额；2023 年 6 月以来的账户对账单，每笔交易含金额、方向、类别、付款用途和交易对手（名称、INN、KPP、账户、银行 BIC）；已执行交易的银行确认书（PDF）；通过 T-API 开具的发票的状态；银行卡收单终端及其刷卡交易；以及已配置的 Webhook。

AI 如何使用它：余额来自 tbank_list_accounts，其中 balance.otb 是当前可用金额。查对账单时，它用 account_number 和 from（以及 to）调用 tbank_get_statement，并用 cursor = nextCursor 翻页，直到不再返回 nextCursor；typeOfOperation 为 Credit 表示入账，Debit 表示出账，counterparty_inns 可按交易对手筛选。需要付款凭证时，它用对账单中的 operationId 和 operationDate 获取 tbank_get_payment_document，但只在你需要该文件时才获取，因为 PDF 很大。对于银行卡收单，它先用 tbank_list_terminals 列出终端，再按终端和日期调用 tbank_list_terminal_operations。

只读：全部 8 个工具都只读取。不会创建或签署任何付款，因此无需确认，安装时也没有关闭的工具。

日期和金额：日期时间参数和响应均为 UTC 的 ISO 8601；周末的交易在下一个工作日入账。金额以账户币种表示（卢布，小数部分为戈比），收单交易除外，它以戈比为单位。

限制：对账单每秒 20 次调用，账户和公司信息每秒 6 次，付款文件和收单每秒 1 次。对账单从 2023 年 6 月开始。

常见错误：401 表示令牌错误或已过期，或者调用来自令牌不允许的地址。403 表示令牌缺少该方法的访问权限（勾选后签发新令牌），或该账户不允许此令牌访问。422 会指出无效参数，例如账号不是 20 位。每个错误都有一个 errorId，可以提供给 T-Bank 客服。

该连接器不执行付款、工资名单或向自雇人士付款，也不涵盖 mTLS（secured-openapi）背后的银行卡方法和合作伙伴（OAuth）集成。

步骤 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

1. 打开 http://localhost:3000 并注册。第一个账户会成为管理员。
2. 打开连接器商店（http://localhost:3000/connectors/store），选择 T-Bank Business，填写它要求的凭证（有些连接器不需要），然后安装。
3. 在 MCP Servers 中创建一个服务器，并把 T-Bank Business 连接器分配给它。在该服务器的页面上复制 MCP endpoint（http://localhost:4000/mcp/<server-id>），并在 API keys 下生成一个密钥。

快速启动只监听 localhost。如果需要一个其他人或云端 AI 客户端也能访问的实例，请克隆仓库并运行 ./setup.sh，它会配置域名、HTTPS 和 OAuth（部署指南）。

步骤 3 — 在 Claude 中添加连接器

Claude 连接 MCP 服务器有两种方式，其中只有一种适用于 localhost 快速启动。

Claude Code 运行在你的电脑上，因此可以直接使用本地 endpoint：

claude mcp add --transport http tbank http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"

运行 claude mcp list 检查是否已连接。

Claude.ai 和 Claude Desktop 通过自定义连接器添加远程服务器：进入 Customize → Connectors，点击 +，选择 Add custom connector（在 Team 和 Enterprise 套餐中，需要所有者先在 Organization settings → Connectors 中添加）。Claude 是从 Anthropic 的云端而不是从你的电脑建立这个连接的，所以 localhost 地址在这里不可用。你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例（见上文的 ./setup.sh），并且该实例信任 Russian Trusted Root CA（见步骤 1）。粘贴该实例的 MCP endpoint，并在 Claude 提示时登录 AnythingMCP。

可用工具

示例提示

• “我们所有 T-Bank 账户现在的余额是多少？今天可用多少？”
• “列出我们主账户上周的入账，带上交易对手和付款用途。”
• “本季度我们向 INN 为 7707083893 的交易对手付了多少钱？”
• “把昨天金额最大的一笔出账的银行确认书以 PDF 形式取出来。”
• “昨天我们的收单终端通过刷卡收了多少钱？”

FAQ

为什么 AnythingMCP Cloud 上没有 T-Bank Business？ T-API 使用俄罗斯数字发展部签发的 TLS 证书（Russian Trusted Root CA），而 AnythingMCP Cloud 不信任该根证书，因此每次调用都会因证书错误而失败。在你自己的 AnythingMCP 实例上，用 NODE_EXTRA_CA_CERTS 添加该根证书并重启即可。

下一步

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