概要
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 + Meta Muse
T-Bank Business（T-API、旧 Tinkoff Business）：会社情報、口座と残高、取引相手を含む口座明細、支払確認書、発行した請求書のステータス、カード決済（アクワイアリング）の端末と取引。読み取り専用。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
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 はロシアのデジタル発展省（Russian Trusted Root CA）が発行した TLS 証明書を提示します。以前の公開証明書は失効しています。このルートを信頼していないサーバーは、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 を呼び出し、nextCursor がなくなるまで cursor = 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 — アダプターをインストール
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 — Muse にコネクタを追加
Muse は Meta のクラウドから MCP サーバーに接続するため、クイックスタートの localhost エンドポイントには届きません。Muse で T-Bank Business を使うには、Russian Trusted Root CA を信頼する（ステップ 1 を参照）、公開 HTTPS アドレスを持つ AnythingMCP インスタンス（上記の ./setup.sh を参照）が必要です。Muse で Settings → Connectors を開いて Add custom connector を選び、インスタンスの MCP endpoint を貼り付け、Muse に求められたら AnythingMCP にサインインします（OAuth。./setup.sh が既定で設定します）。
公開インスタンスを用意できない場合は、パソコン上で動くクライアントを使ってください。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
なぜ T-Bank Business は AnythingMCP Cloud で使えないのですか? T-API はロシアのデジタル発展省（Russian Trusted Root CA）が発行した TLS 証明書を提示しますが、AnythingMCP Cloud はこのルートを信頼していないため、すべての呼び出しが証明書エラーで失敗します。ご自身の AnythingMCP インスタンスでは、NODE_EXTRA_CA_CERTS でルートを追加して再起動します。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?