摘要
T-Bank Business（T-API，原 Tinkoff Business）：公司信息、账户和余额、含交易对手的账户对账单、付款确认、已开发票状态，以及银行卡收单终端和交易。只读。
试试这样问
T-Bank Business 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
仅限自托管。 T-Bank 的 T-API 使用由 Russian Trusted Root CA 签发的 TLS 证书，而 AnythingMCP Cloud 不信任该根证书，因此该连接器无法在 AnythingMCP Cloud 上使用。按下文说明把该根证书加入你自己运行的 AnythingMCP 实例的信任库后，即可在该实例上使用。
T-Bank Business + Microsoft Copilot
T-Bank Business（T-API，原 Tinkoff Business）：公司信息、账户和余额、含交易对手的账户对账单、付款确认、已开发票状态，以及银行卡收单终端和交易。只读。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TBANK_API_URL, TBANK_API_TOKEN
步骤 1 — 获取凭证
设置大约需要 10 分钟。你需要一个 T-Bank Business 企业账户，以及一个信任 Russian Trusted Root CA 的自托管 AnythingMCP（见下文 证书）。
- 在 T-Business（business.tbank.ru）中打开 Integrations > T-API，点击 Issue token。
- 填写发起调用的 IP 地址；中小企业也可以选择 Disable address check。调用来自你的 AnythingMCP 服务器的地址，因此请允许该地址或关闭检查。
- 在 What the API may access 下，至少勾选公司信息（T-Business ID）、账户信息（
bank-accounts/get）和账户交易（对账单）；如需对应工具，再加上收单终端、发票和 Webhook。你可以把令牌限制在特定账户上。 - 把令牌复制到
TBANK_API_TOKEN。它在最后一次使用后 90 天内有效，因此经常使用的令牌不会过期。要更改地址或访问范围，请签发新令牌。 - 把
TBANK_API_URL设为https://business.tbank.ru/openapi。沙箱请使用https://business.tbank.ru/openapi/sandbox和令牌TBankSandboxToken；沙箱的响应与你的数据无关。 - 安装连接器并运行
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
- 打开
http://localhost:3000并注册。第一个账户会成为管理员。 - 打开连接器商店（
http://localhost:3000/connectors/store），选择 T-Bank Business，填写它要求的凭证（有些连接器不需要），然后安装。 - 在 MCP Servers 中创建一个服务器，并把 T-Bank Business 连接器分配给它。在该服务器的页面上复制 MCP endpoint（
http://localhost:4000/mcp/<server-id>），并在 API keys 下生成一个密钥。
快速启动只监听 localhost。如果需要一个其他人或云端 AI 客户端也能访问的实例，请克隆仓库并运行 ./setup.sh，它会配置域名、HTTPS 和 OAuth（部署指南）。
步骤 3 — 在 Microsoft Copilot 中添加连接器
Copilot Studio 从 Microsoft 的云端连接 MCP 服务器，因此无法访问快速启动的 localhost endpoint。要在 Microsoft Copilot 中使用 T-Bank Business，你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例（见上文的 ./setup.sh）。在 Copilot Studio 中打开你的智能体，进入 Tools → Add a tool → New tool → Model Context Protocol，粘贴该实例的 MCP endpoint，并选择 API key，请求头为 X-API-Key。然后把智能体发布到 Microsoft 365 and Microsoft Teams 渠道。
如果无法提供公网实例，请改用在你电脑上运行的客户端：Claude Code、Cursor 或 Gemini CLI 可以直接访问 localhost。
可用工具
| Tool | What it does |
|---|---|
tbank_get_company | Get the company behind the token: full and short name, INN, KPP, OGRN, legal form, tax regime, legal address, registration date and the… |
tbank_list_accounts | List the company accounts at T-Bank (settlement and, with with_invest, investment accounts; active, closed, blocked or arrested): account… |
tbank_get_statement | Get the operations of an account for a period, from June 2023: operationId, operationDate, operationStatus (Authorization or Transaction)… |
tbank_get_payment_document | Get the bank confirmation of an executed operation (payment order, bank order, memorial order and similar) as a Base64 string of a PDF… |
tbank_get_invoice_info | Get the status of an invoice the company issued through T-API (for example whether it has been paid) |
tbank_list_terminals | List the active card acquiring terminals of the company (terminal key, address, status) |
tbank_list_terminal_operations | List the card operations of one acquiring terminal for at most one day: amounts in kopecks, status, card mask, time |
tbank_list_webhooks | List the webhooks configured for the company (event type and URL), for example the account operation notifications |
示例提示
- “我们所有 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 添加该根证书并重启即可。
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?