MCP (Model Context Protocol) es un estandar abierto que permite a los asistentes de inteligencia artificial como ChatGPT y Claude usar herramientas externas de forma directa. En lugar de copiar y pegar datos manualmente, el asistente puede consultar servicios en tiempo real durante la conversacion.
Tlaloc ofrece un servidor MCP que conecta estos asistentes con fuentes de datos oficiales mexicanas: CURP del Registro Nacional de Poblacion (RENAPO), RFC del Servicio de Administracion Tributaria (SAT), codigos postales de SEPOMEX, numeros telefonicos del Instituto Federal de Telecomunicaciones (IFT), y comprobantes electronicos de pago SPEI de Banco de Mexico.
En esta guia te mostramos como configurar todo desde cero, paso a paso.
Que puedes hacer con el servidor MCP
Una vez configurado, tu asistente de IA podra realizar las siguientes consultas directamente en la conversacion:
- Consultar codigos postales de todo Mexico con colonias, municipio y estado, usando el catalogo oficial de SEPOMEX.
- Validar CURP ante el registro oficial de RENAPO para confirmar que una clave es autentica y vigente.
- Verificar RFC ante el SAT para comprobar que un contribuyente esta registrado y activo.
- Consultar a que operador pertenece un numero telefonico usando los registros del IFT.
- Verificar transferencias SPEI consultando el Comprobante Electronico de Pago (CEP) directamente en Banco de Mexico.
- Solicitar facturas CFDI a empresas registradas en el catalogo de facturacion de Tlaloc.
Todo esto sucede dentro de la conversacion con el asistente. Tu simplemente describes lo que necesitas en lenguaje natural y la IA se encarga de hacer la consulta.
Paso 1: Crear tu cuenta
Lo primero es crear una cuenta en la plataforma de Tlaloc. Visita console.tlaloc.sh y registrate con tu correo electronico y una contrasena. La cuenta se activa de forma inmediata.
Paso 2: Agregar saldo
Cada consulta tiene un costo que se descuenta de tu saldo. Para agregar fondos:
- Inicia sesion en la consola y ve a la seccion "Facturacion".
- Ahi encontraras los datos bancarios de Tlaloc para realizar un deposito por transferencia SPEI.
- Realiza la transferencia desde tu banca en linea.
- Regresa a la seccion de Facturacion y haz clic en "Registrar deposito".
- Llena los datos del comprobante: clave de rastreo, banco emisor, fecha y monto.
Tu saldo se acreditara una vez que el equipo de Tlaloc verifique el deposito.
Paso 3: Generar un API Key
El API Key es la credencial que identifica tu cuenta cuando el asistente de IA hace consultas. Para generarla:
- En la consola, ve a la seccion "Mexico API".
- Haz clic en "Crear Key".
- Escribe un nombre descriptivo (por ejemplo, "ChatGPT MCP" o "Claude trabajo").
- Copia la API key que se muestra en pantalla.
Importante: La API key solo se muestra una vez. Copiala y guardala en un lugar seguro antes de cerrar la ventana. Si la pierdes, tendras que crear una nueva.
Tu API key tendra el formato tlmx_... seguido de una cadena de caracteres.
Paso 4: Configurar en ChatGPT
Para usar el servidor MCP de Tlaloc dentro de ChatGPT:
- Abre ChatGPT y ve a Settings (Configuracion).
- Busca la seccion "Connectors" o "Tools" (el nombre puede variar segun la version).
- Haz clic en "Add connector" (Agregar conector).
- En la URL del servidor, escribe:
https://api.tlaloc.sh/mx/mcp - En la seccion de autenticacion, agrega el header:
Authorization: Bearer tlmx_TU_API_KEY - Guarda la configuracion.
Listo. A partir de ahora, ChatGPT podra usar las herramientas de Tlaloc en cualquier conversacion. Simplemente pidele algo como "valida esta CURP" o "busca el codigo postal 06600" y el asistente hara la consulta automaticamente.
Paso 5: Configurar en Claude Code
Si usas Claude Code como tu asistente de desarrollo, agrega la siguiente configuracion a tu archivo .claude/settings.toml (o al archivo de configuracion de tu proyecto):
[mcp.mexico-api]
transport = "http"
url = "https://api.tlaloc.sh/mx/mcp"
headers = { Authorization = "Bearer tlmx_TU_API_KEY" }Reemplaza tlmx_TU_API_KEY con tu API key real. Claude Code detectara automaticamente el servidor MCP la proxima vez que inicies una sesion.
Paso 6: Configurar via OpenAI Responses API
Si eres desarrollador y quieres integrar las herramientas de Tlaloc en tu propia aplicacion usando la API de OpenAI, puedes incluir el servidor MCP como una herramienta en tu request:
{
"type": "mcp",
"server_label": "mexico_api",
"server_url": "https://api.tlaloc.sh/mx/mcp",
"require_approval": "never",
"headers": {
"Authorization": "Bearer tlmx_TU_API_KEY"
}
}Este bloque se agrega dentro del arreglo de tools de tu llamada a la Responses API. El modelo podra invocar cualquiera de las herramientas disponibles en el servidor MCP de forma automatica.
Herramientas disponibles
El servidor MCP de Tlaloc incluye las siguientes herramientas. Cada una tiene un costo por consulta que se descuenta de tu saldo:
| Herramienta | Descripcion | Costo |
|---|---|---|
| consultar_codigo_postal | Consulta codigos postales del catalogo SEPOMEX | $0.01 MXN |
| consultar_telefono | Consulta numeros telefonicos en el registro del IFT | $0.01 MXN |
| consultar_curp | Valida o consulta CURP ante RENAPO | $0.25 MXN |
| validar_rfc | Valida RFC ante el SAT | $0.10 MXN |
| descargar_cep | Descarga el Comprobante Electronico de Pago completo de Banxico | $0.10 MXN |
| consultar_cep | Consulta rapida del estado de un CEP | $0.10 MXN |
| listar_instituciones_cep | Lista de bancos disponibles para consulta CEP | Gratis |
| buscar_catalogo_facturaxme | Buscar empresas en el catalogo de facturacion | Gratis |
| crear_solicitud_factura | Solicitar una factura CFDI | $1.00 MXN |
| listar_solicitudes_factura | Ver tus solicitudes de factura | Gratis |
| consultar_solicitud_factura | Ver el estado de una solicitud | Gratis |
| actualizar_solicitud_factura | Actualizar una solicitud existente | Gratis |
Siguiente paso
Ahora que tienes el servidor MCP configurado, te recomendamos explorar estos otros articulos:
- Aprende a validar transferencias SPEI con el Comprobante Electronico de Pago — una guia practica para verificar pagos contra los registros oficiales de Banco de Mexico.
- Automatiza la validacion de comprobantes con inteligencia artificial — combina el servidor MCP con un asistente de IA para verificar pagos a partir de imagenes de comprobantes.