Come collegare T-Bank Business a Microsoft Copilot via MCP

Solo self-hosted. La T-API di T-Bank presenta un certificato TLS emesso dalla Russian Trusted Root CA, di cui AnythingMCP Cloud non si fida, quindi questo connettore non è disponibile su AnythingMCP Cloud. Funziona su un'istanza di AnythingMCP che gestisci tu, una volta aggiunto quel certificato radice al suo trust store, come descritto qui sotto.

T-Bank Business + Microsoft Copilot

T-Bank Business (T-API, ex Tinkoff Business): dati aziendali, conti e saldi, estratti conto con le controparti, conferme di pagamento, stato delle fatture emesse e terminali e operazioni di acquiring con carta. Sola lettura.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TBANK_API_URL, TBANK_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti. Ti servono un conto aziendale su T-Bank Business e un AnythingMCP self-hosted che si fidi della Russian Trusted Root CA (vedi Certificati più sotto).

1. In T-Business (business.tbank.ru) apri Integrations > T-API e clicca Issue token.
2. Inserisci gli indirizzi IP da cui arrivano le chiamate oppure, per piccole e medie imprese, scegli Disable address check. Le chiamate partono dall'indirizzo del tuo server AnythingMCP, quindi consenti quell'indirizzo o disattiva il controllo.
3. In What the API may access spunta almeno le informazioni sull'azienda (T-Business ID), le informazioni sui conti (bank-accounts/get) e le operazioni sui conti (estratti); aggiungi terminali di acquiring, fatture e webhook se vuoi quei tool. Puoi limitare il token a determinati conti.
4. Copia il token in TBANK_API_TOKEN. Resta valido 90 giorni dall'ultimo utilizzo, quindi un token usato con regolarità non scade. Per cambiare indirizzi o accessi, emetti un nuovo token.
5. Imposta TBANK_API_URL su https://business.tbank.ru/openapi. Per la sandbox usa https://business.tbank.ru/openapi/sandbox con il token TBankSandboxToken; le sue risposte non dipendono dai tuoi dati.
6. Installa il connettore ed esegui tbank_get_company per verificare il token.

Certificati: la T-API presenta un certificato TLS emesso dal Ministero dello sviluppo digitale russo (Russian Trusted Root CA); i vecchi certificati pubblici sono stati revocati. Un server che non si fida di quella radice fallisce con un errore di certificato prima di qualsiasi stato HTTP. Aggiungi il certificato radice (da gosuslugi.ru/crt) al trust store di Node del backend di AnythingMCP, per esempio NODE_EXTRA_CA_CERTS=/path/russian_trusted_root_ca.pem, e riavvialo.

Cosa legge: l'azienda a cui appartiene il token (ragione sociale completa e breve, INN, KPP, OGRN, forma giuridica, regime fiscale, sede legale, data di registrazione e coordinate bancarie); i conti aziendali con stato, tipo, valuta, tariffa e saldi; gli estratti conto da giugno 2023 con importo, direzione, categoria, causale e controparte (nome, INN, KPP, conto, BIC della banca) di ogni operazione; la conferma bancaria di un'operazione eseguita in PDF; lo stato delle fatture emesse tramite la T-API; i terminali di acquiring e le loro operazioni con carta; e i webhook configurati.

Come lo usa l'AI: i saldi arrivano da tbank_list_accounts, dove balance.otb è quanto si può spendere subito. Per un estratto chiama tbank_get_statement con account_number e from (e to) e pagina con cursor = nextCursor finché manca; typeOfOperation Credit è denaro in entrata, Debit in uscita, e counterparty_inns filtra per controparte. Come prova di un pagamento recupera tbank_get_payment_document con operationId e operationDate presi dall'estratto, e solo quando vuoi il documento, perché il PDF è grande. Per l'acquiring elenca i terminali con tbank_list_terminals e poi chiama tbank_list_terminal_operations per terminale e giorno.

Sola lettura: tutti gli 8 tool leggono soltanto. Non vengono creati né firmati pagamenti, quindi non c'è niente da confermare e nessun tool è disattivato all'installazione.

Date e importi: i parametri e le risposte con data e ora sono ISO 8601 in UTC; le operazioni del fine settimana vengono contabilizzate il primo giorno lavorativo successivo. Gli importi sono nella valuta del conto (rubli con i copechi come decimali), tranne le operazioni di acquiring, che sono in copechi.

Limiti: estratti 20 chiamate al secondo, conti e azienda 6, documenti di pagamento e acquiring 1 al secondo. Gli estratti partono da giugno 2023.

Errori comuni: 401 significa un token sbagliato o scaduto, oppure una chiamata da un indirizzo che il token non consente. 403 significa che al token manca l'accesso per quel metodo (emetti un nuovo token con la voce spuntata) o che il conto non è consentito per questo token. 422 indica un parametro non valido, per esempio un numero di conto che non ha 20 cifre. Ogni errore ha un errorId da comunicare all'assistenza di T-Bank.

Il connettore non esegue pagamenti, liste stipendi o pagamenti a lavoratori autonomi, e non copre i metodi delle carte dietro mTLS (secured-openapi) né l'integrazione partner (OAuth).

Step 2 — Installa l'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. Apri http://localhost:3000 e registrati. Il primo account diventa amministratore.
2. Apri lo store dei connettori (http://localhost:3000/connectors/store), scegli T-Bank Business, inserisci le credenziali richieste (alcuni connettori non ne hanno bisogno) e installalo.
3. In MCP Servers crea un server e assegnagli il connettore T-Bank Business. Nella pagina del server copia l'MCP endpoint (http://localhost:4000/mcp/<server-id>) e genera una chiave in API keys.

Il quickstart ascolta solo su localhost. Per un'istanza raggiungibile da altre persone o da client AI nel cloud, clona il repository ed esegui ./setup.sh, che configura dominio, HTTPS e OAuth (guida al deployment).

Step 3 — Aggiungi il connettore in Microsoft Copilot

Copilot Studio si collega ai server MCP dal cloud di Microsoft, quindi non raggiunge l'endpoint localhost del quickstart. Per usare T-Bank Business in Microsoft Copilot ti serve un'istanza di AnythingMCP con un indirizzo HTTPS pubblico (vedi ./setup.sh sopra). In Copilot Studio apri il tuo agente, vai su Tools → Add a tool → New tool → Model Context Protocol, incolla l'MCP endpoint dell'istanza e scegli API key con l'header X-API-Key. Poi pubblica l'agente nel canale Microsoft 365 and Microsoft Teams.

Se un'istanza pubblica non è un'opzione, usa un client che gira sul tuo computer: Claude Code, Cursor o Gemini CLI raggiungono localhost direttamente.

Tool disponibili

Esempi di prompt

• "Quali sono adesso i saldi di tutti i nostri conti T-Bank, e quanto possiamo spendere oggi?"
• "Mostrami gli incassi della settimana scorsa sul nostro conto principale con controparte e causale."
• "Quanto abbiamo pagato in questo trimestre alla controparte con INN 7707083893?"
• "Recupera in PDF la conferma bancaria del pagamento in uscita più grande di ieri."
• "Quanto hanno incassato ieri i nostri terminali di acquiring con i pagamenti con carta?"

FAQ

Perché T-Bank Business non è disponibile su AnythingMCP Cloud? La T-API presenta un certificato TLS emesso dal Ministero dello sviluppo digitale russo (Russian Trusted Root CA) e AnythingMCP Cloud non si fida di quella radice, quindi ogni chiamata fallirebbe con un errore di certificato. Nella tua istanza di AnythingMCP aggiungi la radice con NODE_EXTRA_CA_CERTS e riavvii.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse