Cómo conectar T-Bank Business a Gemini vía MCP

Solo autoalojado. La T-API de T-Bank presenta un certificado TLS emitido por la Russian Trusted Root CA, en la que AnythingMCP Cloud no confía, así que este conector no está disponible en AnythingMCP Cloud. Funciona en una instancia de AnythingMCP que ejecutes tú mismo, una vez añadido ese certificado raíz a su almacén de confianza, como se describe abajo.

T-Bank Business + Gemini

T-Bank Business (T-API, antes Tinkoff Business): datos de la empresa, cuentas y saldos, extractos con contrapartes, confirmaciones de pago, estado de las facturas emitidas y terminales y operaciones de adquirencia con tarjeta. Solo lectura.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TBANK_API_URL, TBANK_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos. Necesitas una cuenta de empresa en T-Bank Business y un AnythingMCP autoalojado que confíe en la Russian Trusted Root CA (ver Certificados más abajo).

1. En T-Business (business.tbank.ru) abre Integrations > T-API y pulsa Issue token.
2. Introduce las direcciones IP desde las que llegan las llamadas o, para pequeñas y medianas empresas, elige Disable address check. Las llamadas salen de la dirección de tu servidor de AnythingMCP, así que permite esa dirección o desactiva la comprobación.
3. En What the API may access, marca como mínimo la información de la empresa (T-Business ID), la información de cuentas (bank-accounts/get) y las operaciones de cuenta (extractos); añade terminales de adquirencia, facturas y webhooks si quieres esas herramientas. Puedes limitar el token a ciertas cuentas.
4. Copia el token en TBANK_API_TOKEN. Es válido durante 90 días desde su último uso, así que un token que se usa con regularidad no caduca. Para cambiar direcciones o accesos, emite un token nuevo.
5. Pon TBANK_API_URL en https://business.tbank.ru/openapi. Para el sandbox usa https://business.tbank.ru/openapi/sandbox con el token TBankSandboxToken; sus respuestas no dependen de tus datos.
6. Instala el conector y ejecuta tbank_get_company para comprobar el token.

Certificados: la T-API presenta un certificado TLS emitido por el Ministerio de Desarrollo Digital ruso (Russian Trusted Root CA); los antiguos certificados públicos fueron revocados. Un servidor que no confía en esa raíz falla con un error de certificado antes de cualquier estado HTTP. Añade el certificado raíz (de gosuslugi.ru/crt) al almacén de confianza de Node del backend de AnythingMCP, por ejemplo NODE_EXTRA_CA_CERTS=/path/russian_trusted_root_ca.pem, y reinícialo.

Qué lee: la empresa del token (nombre completo y corto, INN, KPP, OGRN, forma jurídica, régimen fiscal, domicilio legal, fecha de registro y datos bancarios); las cuentas de la empresa con estado, tipo, moneda, tarifa y saldos; extractos desde junio de 2023 con importe, sentido, categoría, concepto y contraparte (nombre, INN, KPP, cuenta, BIC del banco) de cada operación; la confirmación bancaria de una operación ejecutada en PDF; el estado de las facturas emitidas a través de la T-API; los terminales de adquirencia y sus operaciones con tarjeta; y los webhooks configurados.

Cómo lo usa la IA: los saldos salen de tbank_list_accounts, donde balance.otb es lo que se puede gastar ahora. Para un extracto llama a tbank_get_statement con account_number y from (y to) y pagina con cursor = nextCursor hasta que falte; typeOfOperation Credit es dinero que entra, Debit dinero que sale, y counterparty_inns filtra por contraparte. Como prueba de un pago obtiene tbank_get_payment_document con el operationId y el operationDate del extracto, y solo cuando quieres el documento, porque el PDF es grande. Para la adquirencia con tarjeta lista los terminales con tbank_list_terminals y después llama a tbank_list_terminal_operations por terminal y día.

Solo lectura: las 8 herramientas solo leen. No se crean ni se firman pagos, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Fechas e importes: los parámetros y respuestas de fecha y hora son ISO 8601 en UTC; las operaciones del fin de semana se contabilizan el siguiente día hábil. Los importes están en la moneda de la cuenta (rublos con los kopeks como decimales), salvo las operaciones de adquirencia, que vienen en kopeks.

Límites: extractos 20 llamadas por segundo, cuentas y empresa 6, documentos de pago y adquirencia 1 por segundo. Los extractos empiezan en junio de 2023.

Errores comunes: 401 significa un token incorrecto o caducado, o una llamada desde una dirección que el token no permite. 403 significa que al token le falta el acceso a ese método (emite un token nuevo con esa casilla marcada) o que la cuenta no está permitida para este token. 422 indica un parámetro no válido, por ejemplo un número de cuenta que no tiene 20 dígitos. Cada error trae un errorId que conviene dar al soporte de T-Bank.

El conector no realiza pagos, nóminas ni pagos a autónomos, y no cubre los métodos de tarjetas detrás de mTLS (secured-openapi) ni la integración de partners (OAuth).

Paso 2 — Instalar el 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. Abre http://localhost:3000 y regístrate. La primera cuenta pasa a ser la administradora.
2. Abre la tienda de conectores (http://localhost:3000/connectors/store), elige T-Bank Business, introduce las credenciales que pida (algunos conectores no necesitan ninguna) e instálalo.
3. En MCP Servers, crea un servidor y asígnale el conector T-Bank Business. En la página del servidor, copia el MCP endpoint (http://localhost:4000/mcp/<server-id>) y genera una clave en API keys.

El quickstart solo escucha en localhost. Para una instancia a la que puedan llegar otras personas o clientes de IA en la nube, clona el repositorio y ejecuta ./setup.sh, que configura dominio, HTTPS y OAuth (guía de despliegue).

Paso 3 — Añadir el conector en Gemini

Gemini CLI se ejecuta en tu ordenador, así que puede usar el endpoint local:

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

Así el servidor se guarda en .gemini/settings.json del proyecto actual; añade -s user para guardarlo en ~/.gemini/settings.json para todos los proyectos. Inicia gemini y ejecuta /mcp para ver las herramientas de T-Bank Business.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuáles son ahora los saldos de todas nuestras cuentas de T-Bank, y cuánto podemos gastar hoy?"
• "Muéstrame los cobros de la semana pasada en nuestra cuenta principal con contraparte y concepto."
• "¿Cuánto hemos pagado este trimestre a la contraparte con INN 7707083893?"
• "Obtén en PDF la confirmación bancaria del mayor pago saliente de ayer."
• "¿Cuánto ingresaron ayer nuestros terminales de adquirencia con pagos con tarjeta?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

¿Por qué T-Bank Business no está disponible en AnythingMCP Cloud? La T-API presenta un certificado TLS emitido por el Ministerio de Desarrollo Digital ruso (Russian Trusted Root CA), y AnythingMCP Cloud no confía en esa raíz, así que todas las llamadas fallarían con un error de certificado. En tu propia instancia de AnythingMCP añades la raíz con NODE_EXTRA_CA_CERTS y reinicias.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot