MCP 経由で T-Bank Business を Cursor に接続する方法

セルフホスト専用。 T-Bank の T-API は Russian Trusted Root CA が発行した TLS 証明書を提示しますが、AnythingMCP Cloud はこのルートを信頼していないため、このコネクタは AnythingMCP Cloud では利用できません。以下の説明どおりにそのルート証明書を信頼ストアに追加すれば、ご自身で運用する AnythingMCP インスタンスで動作します。

T-Bank Business + Cursor

T-Bank Business（T-API、旧 Tinkoff Business）：会社情報、口座と残高、取引相手を含む口座明細、支払確認書、発行した請求書のステータス、カード決済（アクワイアリング）の端末と取引。読み取り専用。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

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 はロシアのデジタル発展省（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

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 — Cursor にコネクタを追加

Cursor はお使いのパソコン上で動くため、ローカルのエンドポイントを使えます。~/.cursor/mcp.json（全プロジェクト）または .cursor/mcp.json（1 つのプロジェクト）にサーバーを追加します。

{
  "mcpServers": {
    "tbank": {
      "url": "http://localhost:4000/mcp/<server-id>",
      "headers": { "X-API-Key": "<your-api-key>" }
    }
  }
}

その後、Cursor の MCP 設定でサーバーが有効になっていて、ツールが一覧に表示されていることを確認します。

利用可能なツール

プロンプトの例

• 「T-Bank の全口座の現在の残高と、今日使える金額を教えてください。」
• 「メイン口座の先週の入金を、取引相手と支払目的とともに表示してください。」
• 「今四半期に INN 7707083893 の取引相手へいくら支払いましたか。」
• 「昨日の最大の出金について、銀行の確認書を PDF で取得してください。」
• 「昨日、アクワイアリング端末でのカード決済の売上はいくらでしたか。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

なぜ T-Bank Business は AnythingMCP Cloud で使えないのですか? T-API はロシアのデジタル発展省（Russian Trusted Root CA）が発行した TLS 証明書を提示しますが、AnythingMCP Cloud はこのルートを信頼していないため、すべての呼び出しが証明書エラーで失敗します。ご自身の AnythingMCP インスタンスでは、NODE_EXTRA_CA_CERTS でルートを追加して再起動します。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続