Cómo funciona el servidor MCP
Esta página ofrece una visión breve de cómo funciona el servidor, lo suficiente para entender qué ocurre cuando usa el MCP. Para el paso a paso práctico, vaya directamente a Uso local con el Claude Code.
La autenticación está delegada a BTG Id
El servidor MCP no emite tokens ni valida credenciales por cuenta propia. Quien autentica al usuario es el BTG Id, exactamente como en el acceso directo a las APIs. El servidor MCP únicamente recibe el token que llega en cada solicitud, identifica la empresa a partir de él y reenvía la llamada al servidor interno.
Cada solicitud es independiente
El servidor no guarda sesión ni estado entre las llamadas. Cada solicitud lleva su propio token y es autosuficiente. Eso es lo que hace simple el uso: todo lo que el servidor necesita es un token válido emitido por BTG Id.
Operaciones de lectura y de escritura
Las operaciones expuestas por el servidor se dividen en dos tipos:
- Lectura — consultas y listados. No mueven dinero ni alteran el estado de las entidades.
- Escritura — operaciones que mueven dinero o cambian estado, como un Pix, un pago, la emisión o cancelación de un boleto.
Toda operación de escritura requiere confirmación humana explícita antes de ejecutarse. El asistente presenta un resumen de la operación: empresa, valor, beneficiario y fecha, con el documento enmascarado, y solo ejecuta tras su aprobación deliberada. Esto se trata con mayor profundidad en Seguridad y buenas prácticas.
Lo que ocurre en una llamada
En resumen, cuando le solicita algo al asistente:
- El asistente elige la operación adecuada y la envía al servidor MCP junto con su token.
- El servidor identifica la empresa a partir del token.
- El servidor llama a la API de BTG Empresas en nombre de esa empresa.
- Si se trata de una operación de escritura, la confirmación ocurre antes de la ejecución.
- El resultado vuelve a la conversación.