# Búsqueda Source: https://docs.tukanmx.com/api-reference/búsqueda /es/api-reference/openapi-zipcodes.json get /zipcodes/search Búsqueda puntual de códigos postales. # Catálogo Source: https://docs.tukanmx.com/api-reference/catálogo /es/api-reference/openapi-zipcodes.json get /zipcodes Consulta el catálogo de códigos postales de México con información geográfica y sociodemográfica básica. Permite filtrar por estado y municipio. # Catálogo de indicadores Source: https://docs.tukanmx.com/api-reference/catálogo-de-indicadores /es/api-reference/openapi-zipcodes.json get /zipcodes/indicator_catalog Regresa la lista de todos los indicadores disponibles, con su descripción y metadatos. # Datos Source: https://docs.tukanmx.com/api-reference/datos /es/api-reference/openapi-zipcodes.json post /zipcodes/latest Regresa los datos más recientes para los códigos postales y categorías solicitadas. # Tukan Atlas Source: https://docs.tukanmx.com/es/api-reference/index La API de Tukan para acceder a datos geoespaciales y socioeconómicos de México. **Tukan Atlas** es nuestra API REST para integrar datos geoespaciales y socioeconómicos de México directamente en tus aplicaciones, modelos y flujos de trabajo. Con Atlas puedes consultar de forma programática indicadores demográficos, financieros y socioeconómicos asociados a unidades geográficas como **códigos postales**, sin necesidad de descargar archivos ni procesar fuentes externas manualmente. ## ¿Qué puedes hacer con Atlas? * **Consultas por código postal**: Obtén indicadores demográficos y socioeconómicos asociados a cualquier código postal de México. * **Integración directa**: Conecta los datos de Tukan a tus aplicaciones internas, modelos de riesgo, herramientas de geolocalización y más. * **Datos confiables**: Accede a información curada y estandarizada a partir de fuentes oficiales como INEGI. **Tukan Atlas se encuentra en Beta cerrada.** El acceso es por invitación y está disponible para un grupo limitado de usuarios. Si te interesa probar la API, ponte en contacto con nosotros en [contacto@tukanmx.com](mailto:contacto@tukanmx.com) y con gusto evaluaremos darte acceso. ## ¿Cómo obtengo acceso? Mientras Atlas esté en Beta cerrada, el acceso se otorga manualmente. Escríbenos a [contacto@tukanmx.com](mailto:contacto@tukanmx.com) contándonos brevemente tu caso de uso y te ayudaremos a comenzar. # Indicadores disponibles Source: https://docs.tukanmx.com/es/api-reference/indicadores Cobertura de indicadores por código postal en México. La API de códigos postales ofrece una variedad de indicadores demográficos y socioeconómicos asociados a los códigos postales en México. En la siguiente tabla se muestra la cobertura de indicadores disponibles por categoría: | **Nemónico** | **Descriptor** | **Categoría** | **Unidad** | | ------------------------------------------------ | ----------------------------------------------------------- | ------------- | ------------------------ | | **population** | Población total | demographic | personas | | **population\_male** | Población masculina | demographic | personas | | **population\_female** | Población femenina | demographic | personas | | **population\_density** | Densidad poblacional | demographic | personas por cada mil m2 | | **population\_per\_household** | Habitantes por hogar | demographic | personas | | **population\_btw\_0\_2** | Población menor de 2 años | demographic | personas | | **population\_btw\_0\_2\_male** | Población menor de 2 años, masculina | demographic | personas | | **population\_btw\_0\_2\_female** | Población menor de 2 años, femenina | demographic | personas | | **population\_over3** | Población de 3 años ó más | demographic | personas | | **population\_over3\_male** | Población de 3 años ó más, masculina | demographic | personas | | **population\_over3\_female** | Población de 3 años ó más, femenina | demographic | personas | | **population\_over5** | Población de 5 años ó más | demographic | personas | | **population\_over5\_male** | Población de 5 años ó más, masculina | demographic | personas | | **population\_over5\_female** | Población de 5 años ó más, femenina | demographic | personas | | **population\_over12** | Población de 12 años ó más | demographic | personas | | **population\_over12\_male** | Población de 12 años ó más, masculina | demographic | personas | | **population\_over12\_female** | Población de 12 años ó más, femenina | demographic | personas | | **population\_over15** | Población de 15 años y más | demographic | personas | | **population\_over15\_male** | Población de 15 años y más, masculina | demographic | personas | | **population\_over15\_female** | Población de 15 años y más, femenina | demographic | personas | | **population\_over18** | Población de 18 años ó más | demographic | personas | | **population\_over18\_male** | Población de 18 años ó más, masculina | demographic | personas | | **population\_over18\_female** | Población de 18 años ó más, femenina | demographic | personas | | **population\_over60** | Población de 60 años ó más | demographic | personas | | **population\_over60\_male** | Población de 60 años ó más, masculina | demographic | personas | | **population\_over60\_female** | Población de 60 años ó más, femenina | demographic | personas | | **population\_over15\_wo\_schooling** | Población de 15 años o más, sin escolaridad | education | personas | | **population\_over15\_wo\_schooling\_male** | Población de 15 años o más, sin escolaridad, masculina | education | personas | | **population\_over15\_wo\_schooling\_female** | Población de 15 años o más, sin escolaridad, femenina | education | personas | | **population\_over15\_w\_elementary** | Población de 15 años o más, con primaria | education | personas | | **population\_over15\_w\_elementary\_male** | Población de 15 años o más, con primaria, masculina | education | personas | | **population\_over15\_w\_elementary\_female** | Población de 15 años o más, con primaria, femenina | education | personas | | **population\_over15\_w\_middleschool** | Población de 15 años o más, con secundaria | education | personas | | **population\_over15\_w\_middleschool\_male** | Población de 15 años o más, con secundaria, masculina | education | personas | | **population\_over15\_w\_middleschool\_female** | Población de 15 años o más, con secundaria, femenina | education | personas | | **population\_over15\_w\_highschool** | Población de 15 años o más, con bachillerato | education | personas | | **population\_over15\_w\_highschool\_male** | Población de 15 años o más, con bachillerato, masculina | education | personas | | **population\_over15\_w\_highschool\_female** | Población de 15 años o más, con bachillerato, femenina | education | personas | | **schooling\_rate** | Tasa de escolaridad | education | porcentaje | | **schooling\_rate\_male** | Tasa de escolaridad, masculina | education | porcentaje | | **schooling\_rate\_female** | Tasa de escolaridad, femenina | education | porcentaje | | **elementary\_schooling\_rate** | Tasa de escolaridad primaria | education | porcentaje | | **elementary\_schooling\_rate\_male** | Tasa de escolaridad primaria, masculina | education | porcentaje | | **elementary\_schooling\_rate\_female** | Tasa de escolaridad primaria, femenina | education | porcentaje | | **middleschool\_schooling\_rate** | Tasa de escolaridad secundaria | education | porcentaje | | **middleschool\_schooling\_rate\_male** | Tasa de escolaridad secundaria, masculina | education | porcentaje | | **middleschool\_schooling\_rate\_female** | Tasa de escolaridad secundaria, femenina | education | porcentaje | | **highschool\_schooling\_rate** | Tasa de escolaridad bachillerato | education | porcentaje | | **highschool\_schooling\_rate\_male** | Tasa de escolaridad bachillerato, masculina | education | porcentaje | | **highschool\_schooling\_rate\_female** | Tasa de escolaridad bachillerato, femenina | education | porcentaje | | **avg\_school\_years** | Grado promedio de estudios | education | años | | **avg\_school\_years\_male** | Grado promedio de estudios, población masculina | education | años | | **avg\_school\_years\_female** | Grado promedio de estudios, población femenina | education | años | | **population\_over12\_economic\_active** | Población de 12 años ó más económicamente activa | employment | personas | | **population\_over12\_economic\_active\_male** | Población de 12 años ó más económicamente activa, masculina | employment | personas | | **population\_over12\_economic\_active\_female** | Población de 12 años ó más económicamente activa, femenina | employment | personas | | **population\_over12\_occupied** | Población de 12 años ó más ocupada | employment | personas | | **population\_over12\_occupied\_male** | Población de 12 años ó más ocupada, masculina | employment | personas | | **population\_over12\_occupied\_female** | Población de 12 años ó más ocupada, femenina | employment | personas | | **population\_over12\_unoccupied** | Población de 12 años ó más desocupada | employment | personas | | **population\_over12\_unoccupied\_male** | Población de 12 años ó más desocupada, masculina | employment | personas | | **population\_over12\_unoccupied\_female** | Población de 12 años ó más desocupada, femenina | employment | personas | | **economic\_active\_rate** | Porcentaje de población económicamente activa | employment | porcentaje | | **economic\_active\_rate\_male** | Porcentaje de población económicamente activa, masculina | employment | porcentaje | | **economic\_active\_rate\_female** | Porcentaje de población económicamente activa, femenina | employment | porcentaje | | **occupation\_rate** | Tasa de ocupación | employment | porcentaje | | **occupation\_rate\_male** | Tasa de ocupación, masculina | employment | porcentaje | | **occupation\_rate\_female** | Tasa de ocupación, femenina | employment | porcentaje | | **unemployed\_rate** | Tasa de desempleo | employment | porcentaje | | **unemployed\_rate\_male** | Tasa de desempleo, masculina | employment | porcentaje | | **unemployed\_rate\_female** | Tasa de desempleo, femenina | employment | porcentaje | | **population\_w\_health\_service** | Población con acceso a servicios de salud | health | personas | | **population\_w\_private\_health\_service** | Población con acceso a servicios de salud privados | health | personas | | **health\_service\_rate** | Tasa de acceso a servicios de salud | health | porcentaje | | **private\_health\_service\_rate** | Tasa de acceso a servicios de salud privados | health | porcentaje | | **inhabited\_households** | Viviendas particulares habitadas | housing | unidad | | **households\_w\_fridge** | Viviendas con refrigerador | housing | unidad | | **households\_w\_washer** | Viviendas con lavadora | housing | unidad | | **households\_w\_microwave** | Viviendas con microondas | housing | unidad | | **households\_w\_vehicle** | Viviendas con automóvil o camioneta | housing | unidad | | **households\_w\_motorcycle** | Viviendas con motocicleta | housing | unidad | | **households\_w\_bicycle** | Viviendas con bicicleta | housing | unidad | | **households\_w\_radio** | Viviendas con radio | housing | unidad | | **households\_w\_tv** | Viviendas con televisión | housing | unidad | | **households\_w\_pc\_or\_tablet** | Viviendas con computadora o tableta | housing | unidad | | **households\_w\_fixed\_phone** | Viviendas con teléfono de línea fija | housing | unidad | | **households\_w\_mobile\_phone** | Viviendas con teléfono móvil | housing | unidad | | **households\_w\_internet** | Viviendas con acceso a internet | housing | unidad | | **households\_w\_paid\_tv** | Viviendas con televisión de paga | housing | unidad | | **households\_w\_streaming\_service** | Viviendas con servicio de streaming | housing | unidad | | **households\_w\_video\_game\_console** | Viviendas con consola de video juegos | housing | unidad | | **households\_no\_pc\_or\_internet** | Viviendas sin computadora o acceso a internet | housing | unidad | | **socioeconomic\_ab** | Porcentaje de viviendas de tipo A/B | socioeconomic | porcentaje | | **socioeconomic\_cplus** | Porcentaje de viviendas de tipo C+ | socioeconomic | porcentaje | | **socioeconomic\_c** | Porcentaje de viviendas de tipo C | socioeconomic | porcentaje | | **socioeconomic\_cminus** | Porcentaje de viviendas de tipo C- | socioeconomic | porcentaje | | **socioeconomic\_dplus** | Porcentaje de viviendas de tipo D+ | socioeconomic | porcentaje | | **socioeconomic\_d** | Porcentaje de viviendas de tipo D | socioeconomic | porcentaje | | **socioeconomic\_e** | Porcentaje de viviendas de tipo E | socioeconomic | porcentaje | # SQL editor Source: https://docs.tukanmx.com/es/tip/consultas/sql_editor Explora y ejecuta consultas SQL directamente a las bases de Tukan El editor SQL de Tukan te permite construir y ejecutar consultas SQL directamente a nuestras bases de datos, así como explorar y modificar las consultas generadas por nuestro agente Teo. La intención de esta funcionalidad es permitirte guardar consultas a nuestras bases de datos y que conectes los resultados de forma directa a tus herramientas de análisis preferidas: **Excel**, **Python**, **Google Sheets**, **Power BI** o **aplicaciones internas**. Cada consulta que ejecutes en el editor SQL consume créditos de tu cuenta (independientemente de si la consulta fue éxitosa o no). ## ¿Cómo puedo generar consultas? La forma más fácil de hacer consultas es pidiéndole a [Teo](https://app.tukanmx.com/teo) ó a tu agente de IA (conectado al MCP de Tukan) que genere la consulta por ti en lenguaje natural. Teo se encargará de traducir tu solicitud en una consulta SQL que puedas ejecutar en el editor. Botón para explorar consultas generadas por Teo Una vez que tengas la consulta, podrás explorarla, modificarla y ejecutarla directamente en el editor SQL. ## Flujo recomendado Dirigete a la pantalla de [Teo](https://app.tukanmx.com/teo) y describe lo que necesitas. Si tu intención es **guardar la consulta para conectarla a tus herramientas de análisis**, asegúrate de indicarle a Teo que quieres una consulta que **siempre te regrese los datos más recientes**. Esto te llevará a la pantalla del editor SQL donde podrás explorar la consulta, modificarla y ejecutarla. Editor de consultas SQL En la parte superior derecha encontrarás los botones para descargar los resultados de la consulta en formato CSV o Excel. Haz click en el botón de guardar para que la consulta quede disponible en tu usuario y puedas generar una conexión directa con tus herramientas de análisis. # Créditos de consumo Source: https://docs.tukanmx.com/es/tip/creditos/index Qué son los créditos de consumo de Tukan, qué operaciones los descuentan y dónde puedes consultar tu uso. Los **créditos de consumo** son la unidad de medida que utilizamos para contabilizar el uso de la plataforma y del MCP de Tukan. Cada mes, tu equipo dispone de una **bolsa de créditos compartida entre todos sus usuarios**, que se va descontando conforme interactúan con la plataforma y el MCP. ## ¿Qué operaciones consumen créditos? | Operación | Descripción | Costo | | ---------------- | --------------------------------------------------------------------------------------------------------------------- | ---------- | | **Tool run TEO** | Cada ejecución de una herramienta por parte de Teo, nuestro agente de IA, al resolver peticiones en lenguaje natural. | 5 créditos | | **Tool run MCP** | Cada ejecución de una herramienta desde un agente externo conectado vía el servidor MCP de Tukan. | 2 créditos | | **SQL query** | Cada consulta SQL a las bases de datos de la plataforma. | 1 crédito | ## ¿Dónde consulto mi uso? Puedes revisar el consumo de créditos de tu equipo desde tu cuenta en la [Web App de Tukan](https://app.tukanmx.com/account/). ## Preguntas frecuentes Los créditos no son acumulables. Se resetean en cada mes del ciclo de facturación, por lo que tu equipo recibe una nueva bolsa de créditos según tu plan y los créditos no utilizados del periodo anterior no se transfieren. Sí. Puedes contratar créditos adicionales sin necesidad de cambiar de plan. Solo escríbenos a [contacto@tukanmx.com](mailto:contacto@tukanmx.com) y nuestro equipo te ayudará a ampliar tu bolsa de créditos. El consumo es por equipo. Todos los usuarios comparten la misma bolsa mensual de créditos, por lo que el uso de cualquier integrante se descuenta del mismo saldo. # Tukan Source: https://docs.tukanmx.com/es/tip/index La plataforma de datos estratégicos para el mercado mexicano. La plataforma de **Tukan** es una colección de bases de datos curadas y estandarizadas que facilitan el uso e integración de fuentes externas en la generación de reportes, análisis y modelos estadíticos. Nuestra aplicación web y agentes permiten crear consultas flexibles a cientos de bases de datos en lenguaje natural y conectar los resultados a tus herramientas de análisis preferidas: **Excel**, **Python**, **Google Sheets**, **Power BI** o **aplicaciones internas**. ## ¿Qué datos están disponibles? La mayoría de nuestras bases de datos provienen de fuentes públicas mexicanas como **CNBV**, **INEGI**, **Banxico**, entre otras. Sin embargo, estamos constantemente agregando información con base en el *feedback* y las necesidades de nuestros clientes. Puedes explorar nuestro catálogo completo [al crear tu cuenta](https://app.tukanmx.com/user/login). ## ¿Para quién es Tukan? Desarollamos Tukan pensando en **equipos de estrategia**, **FP\&A**, **economistas** e **inversores** que buscan una forma fácil para integrar datos de INEGI, Banxico, CNBV, etc. en sus estudios, presentaciones y reportes. Sin embargo, cualquier persona que necesite acceder a datos confiables de México puede beneficiarse de Tukan. ## ¿Qué necesito para acceder? Puedes [crear una cuenta gratuita](https://app.tukanmx.com) para obtener **500 créditos de consumo** como bono de bienvenida. Esto te permitirá explorar el catálogo, hacer consultas a Teo y probar si Tukan es la solución adecuada para ti y tu equipo. Si necesitas más créditos, puedes adquirir alguno de nuestros planes de suscripción directamente en la plataforma. ## Pasos recomendados para nuevos usuarios Inicia sesión en la plataforma y haz una pregunta a nuestro agente: [**Teo**](https://app.tukanmx.com/teo). No necesitas especificarle nada técnico, solo escribe lo que quieres saber en lenguaje natural. Ve nuestra sección de [Teo](/es/tip/teo) para conocer todo lo que puedes hacer con nuestro agente. Guarda la consulta que te generó Teo para que puedas conectarla a tus herramientas de análisis preferidas. Conecta la consulta que guardaste a Excel u otras herramientas de análisis y empieza a trabajar con los datos en tu entorno favorito. Descubre lo que Tukan puede hacer por ti con nuestras guías, tutoriales y casos de uso. # Excel Source: https://docs.tukanmx.com/es/tip/integraciones/excel Conecta tus consultas guardadas de Tukan a Excel con Power Query para mantener tus reportes siempre actualizados. Con **Power Query** puedes conectar tus consultas de Tukan directamente a Excel. Genera un *stream* de datos directo con nuestras bases, para que tus modelos y archivos se actualicen automáticamente. ## Requisitos * **Excel 365** con **Power Query** (disponible en Windows y Mac). * Una [consulta guardada](/es/tip/consultas/sql_editor) en tu usuario de Tukan. * Créditos de consumo en tu cuenta para ejecutar la consulta. Si planeas conectar Tukan a Excel, asegúrate de que tu consulta esté hecha con **fechas dinámicas**, para que cada actualización te entregue los datos más recientes. ## Obtener el código de tu consulta Cuando guardas una consulta, Tukan te lleva a tu **panel de consultas**, donde cada consulta ofrece su código de conexión para distintas herramientas. Inicia sesión en la plataforma y entra a tu panel de [consultas](https://app.tukanmx.com/visualizations/queries). En la consulta que quieras conectar, elige la opción de descarga. El panel te mostrará todas las integraciones disponibles y las formas de conectarte: * Un **URL** lista para usar con *Desde la Web* en Excel para Windows. * Un **código de Power Query (M)** listo para pegar en Excel para Mac. La URL y el código de Power Query incluyen una **llave de acceso a tu consulta**. Trátalos como información confidencial, ya que cada vez que se ejecute la consulta en ese stream se consumirán créditos de tu cuenta. ## Conectar la consulta a Excel Elige tu sistema operativo y el método que prefieras. Ambos dejan la consulta conectada y actualizable. En Excel, ve a la pestaña **Datos** → **Obtener datos** → **Desde otras fuentes** → **Desde la Web**. Pega la URL que copiaste del panel de consultas: ```text theme={null} ``` Como la llave de acceso ya viene dentro de la URL, cuando Excel te pregunte el método de autenticación selecciona **Anónimo** y haz clic en **Conectar**. Power Query mostrará una vista previa de los datos. Haz clic en **Cargar** para traerlos a tu hoja de Excel. En macOS, Power Query requiere **Excel 365 en una versión reciente**. Si no ves la opción **Obtener datos (Power Query)**, actualiza Excel a la última versión disponible. En Excel, ve a **Datos** → **Obtener datos (Power Query)** → **Consulta en blanco**. En el Editor de Power Query, haz clic en **Editor avanzado**. Borra el contenido y pega el código de Power Query que copiaste del panel de consultas. Tendrá una forma similar a esta: ```powerquery-m theme={null} let Origen = Csv.Document( Web.Contents(""), [Delimiter = ",", Encoding = 65001] ), Encabezados = Table.PromoteHeaders(Origen, [PromoteAllScalars = true]) in Encabezados ``` Copia el código tal cual lo muestra el panel: ya incluye la URL y la llave de acceso correctas para tu consulta. Haz clic en **Listo** y luego en **Cerrar y cargar** para traer los datos a tu hoja. ## Mantener los datos actualizados Una vez cargada la consulta, puedes refrescarla cuando quieras o configurar que se actualice sola: 1. Selecciona la tabla cargada en tu hoja. 2. Ve a **Consulta** → **Propiedades** (o haz clic derecho en la consulta → **Propiedades**). 3. Activa **Actualizar al abrir el archivo** y/o **Actualizar cada N minutos**. Para una actualización manual, haz clic en **Datos** → **Actualizar todo** (`Ctrl + Alt + F5`). Cada vez que Excel actualiza la consulta, se ejecuta sobre las bases de Tukan y **consume créditos** de tu cuenta. Evita intervalos de actualización muy cortos si tu consulta es pesada. ## Solución de problemas La llave de acceso ya está embebida en la URL/código, así que el método de autenticación debe ser **Anónimo**. Si elegiste otro método por error, ve a **Datos** → **Obtener datos** → **Configuración de origen de datos**, selecciona la URL de tu consulta, haz clic en **Editar permisos** y cámbialo a **Anónimo**. Verifica que tengas activada la actualización automática en **Consulta** → **Propiedades**, o fuerza un refresco con **Datos** → **Actualizar todo**. Recuerda que la consulta debe tener **fechas dinámicas** para que traiga datos más recientes en cada ejecución. Power Query viene integrado en Excel 365 y en las versiones recientes de Excel para Mac. Si no ves la opción **Obtener datos**, actualiza Excel a la última versión disponible. Suele deberse a que la consulta guardada no devuelve filas para el rango de fechas actual. Vuelve al [editor SQL](/es/tip/consultas/sql_editor), ejecútala y confirma que regresa datos antes de conectarla a Excel. # Claude Code Source: https://docs.tukanmx.com/es/tip/mcp/claude-code Conecta el MCP de Tukan a Claude Code para consultar los datos de Tukan directamente desde tu terminal. ## Requisitos previos * [Claude Code](https://docs.anthropic.com/en/docs/claude-code) instalado en tu terminal. * Una cuenta de Tukan con créditos de consumo. ## Configuración Elige una de las dos opciones según dónde quieras tener disponible el MCP: Recomendado si quieres acceder al MCP de Tukan desde cualquier directorio en tu computadora. ```bash theme={null} claude mcp add -s user --transport http tukan https://ai.tukanmx.com/mcp ``` Úsalo si prefieres limitar la conexión al directorio desde el que ejecutes el comando. ```bash theme={null} claude mcp add --transport http tukan https://ai.tukanmx.com/mcp ``` El comando es idéntico en macOS, Linux y Windows: el CLI de Claude Code es multiplataforma. La primera vez que Claude Code utilice la conexión, se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. ### Verificar la conexión Para confirmar que el servidor MCP se agregó correctamente: ```bash theme={null} claude mcp list ``` Deberías ver `tukan` en la lista de servidores configurados. ## Ejemplo de uso Una vez conectado, puedes hacer consultas desde Claude Code: ```text Ejemplo 1 theme={null} ¿Cuáles son los 10 estados con mayor cartera de crédito al consumo? ``` ```text Ejemplo 2 theme={null} Genera una tabla con la captación bancaria por tipo de instrumento en el último trimestre. ``` ```text Ejemplo 3 theme={null} ¿Cuántas cuentas de ahorro hay por estado en México? ``` ## Consideraciones En ocasiones, Claude Code te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # Claude Desktop Source: https://docs.tukanmx.com/es/tip/mcp/claude-desktop Conecta el MCP de Tukan a la app de Claude para consultar los datos de Tukan directamente desde la aplicación de Anthropic. ## Requisitos previos * [Claude Desktop](https://claude.ai/download) instalado en tu computadora. * Una cuenta de Tukan con créditos de consumo. ## Configuración El proceso de configuración varía dependiendo del tipo de plan de Claude que tengas. Abre Claude Desktop y ve a **Configuración** (Settings) → **Integraciones** (Integrations). Haz clic en **"Agregar conector personalizado"** (Add custom integration). Ingresa la siguiente URL: ``` https://ai.tukanmx.com/mcp ``` Claude Desktop abrirá una ventana de autenticación. Inicia sesión con tu cuenta de Tukan. Una vez autenticado, verás la integración de Tukan activa en tu lista de conectores. Ya puedes comenzar a hacer preguntas sobre datos de Tukan directamente en Claude. En los planes corporativos (Team / Enterprise) de Claude, los usuarios regulares **no pueden agregar conectores personalizados** por su cuenta. Un administrador de la organización debe habilitar la integración. Contacta al administrador de tu cuenta de Claude y solicita que agregue la integración de Tukan con la siguiente URL: ``` https://ai.tukanmx.com/mcp ``` Una vez que el administrador haya habilitado la integración, aparecerá disponible en tu lista de integraciones. Al utilizar la integración por primera vez, se abrirá una ventana de autenticación. Inicia sesión con tu cuenta de Tukan. ## Ejemplo de uso Una vez conectado, puedes hacer preguntas directamente en Claude Desktop: ```text Ejemplo 1 wrap="true" theme={null} ¿Cuál es la cartera de crédito al consumo por estado en México? ``` ```text Ejemplo 2 wrap="true" theme={null} Dame un comparativo de la participación de mercado de los 5 principales bancos en crédito hipotecario. ``` ```text Ejemplo 3 wrap="true" theme={null} ¿Cuál fue la inflación mensual en los últimos 12 meses? ``` Claude utilizará automáticamente la conexión MCP de Tukan para buscar las tablas relevantes, consultar los datos y presentarte los resultados. ## Consideraciones En ocasiones, Claude Desktop te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # Codex (OpenAI) Source: https://docs.tukanmx.com/es/tip/mcp/codex Conecta el MCP de Tukan a Codex para consultar los datos de Tukan directamente desde tu terminal con el agente de OpenAI. ## Requisitos previos * [Codex CLI](https://github.com/openai/codex) instalado en tu terminal. * Una cuenta de Tukan con créditos de consumo. ## Configuración Puedes configurar el servidor MCP de Tukan usando el CLI o editando el archivo de configuración directamente. Ejecuta el siguiente comando en tu terminal: ```bash theme={null} codex mcp add tukan --url https://ai.tukanmx.com/mcp ``` Luego, autentícate con tu cuenta de Tukan: ```bash theme={null} codex mcp login tukan ``` Se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. Agrega el servidor de Tukan al archivo `~/.codex/config.toml`: ```toml config.toml theme={null} [mcp_servers.tukan] url = "https://ai.tukanmx.com/mcp" ``` Luego, autentícate ejecutando: ```bash theme={null} codex mcp login tukan ``` Se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. ## Ejemplo de uso Una vez configurado, ejecuta Codex y haz consultas: ```text Ejemplo 1 theme={null} ¿Cuál es la distribución de créditos hipotecarios por estado? ``` ```text Ejemplo 2 theme={null} Dame un resumen de los indicadores de inclusión financiera más recientes. ``` ## Consideraciones En ocasiones, Codex te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # GitHub Copilot (VS Code) Source: https://docs.tukanmx.com/es/tip/mcp/copilot Conecta el MCP de Tukan a GitHub Copilot en VS Code para consultar los datos de Tukan directamente desde tu editor de código. ## Requisitos previos * [VS Code](https://code.visualstudio.com/) con la extensión de [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot). * Una cuenta de Tukan con créditos de consumo. ## Configuración Puedes configurar el servidor MCP de Tukan de dos formas: a nivel de **workspace** (recomendado para compartir con tu equipo) o a nivel de **usuario** (global para todos tus proyectos). Crea el archivo `.vscode/mcp.json` en la raíz de tu proyecto con el siguiente contenido: ```json .vscode/mcp.json theme={null} { "servers": { "tukan": { "type": "http", "url": "https://ai.tukanmx.com/mcp" } } } ``` Este archivo se puede incluir en tu repositorio para que todo tu equipo tenga acceso al MCP de Tukan automáticamente. Al utilizar Copilot con el MCP de Tukan por primera vez, se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. Abre el chat de Copilot en modo **Agent** y verifica que las herramientas de Tukan aparezcan disponibles. Abre la paleta de comandos (`Cmd + Shift + P` en Mac / `Ctrl + Shift + P` en Windows) y ejecuta **"MCP: Open User Configuration"**. Agrega la siguiente configuración: ```json mcp.json theme={null} { "servers": { "tukan": { "type": "http", "url": "https://ai.tukanmx.com/mcp" } } } ``` Al utilizar Copilot con el MCP de Tukan por primera vez, se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. Abre el chat de Copilot en modo **Agent** y verifica que las herramientas de Tukan aparezcan disponibles. ## Ejemplo de uso Abre el chat de Copilot en modo Agent y haz preguntas: ```text Ejemplo 1 theme={null} ¿Cuáles son las principales métricas del sector asegurador en México? ``` ```text Ejemplo 2 theme={null} Muéstrame la evolución del tipo de cambio USD/MXN en el último año. ``` ## Consideraciones En ocasiones, Copilot te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # Cursor Source: https://docs.tukanmx.com/es/tip/mcp/cursor Conecta el MCP de Tukan a Cursor para consultar los datos de Tukan directamente desde tu editor de código. ## Requisitos previos * [Cursor](https://cursor.com/) instalado en tu computadora. * Una cuenta de Tukan con créditos de consumo. ## Configuración Abre Cursor y ve a **Settings** → **MCP**. Haz clic en **"+ Add new MCP server"** y selecciona el tipo **"Streamable HTTP"**. Ingresa los siguientes datos: * **Name**: `Tukan` * **URL**: `https://ai.tukanmx.com/mcp` Cursor abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan. Una vez autenticado, verás el servidor de Tukan con un indicador verde en la lista de servidores MCP. ## Ejemplo de uso Abre el chat de Cursor (Agent mode) y haz preguntas sobre datos de México: ```text Ejemplo 1 theme={null} ¿Cuál es la tasa de morosidad por tipo de crédito en el sistema bancario mexicano? ``` ```text Ejemplo 2 theme={null} Dame los datos de producción industrial por rama de actividad económica. ``` ## Consideraciones En ocasiones, Cursor te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # MCP de Tukan Source: https://docs.tukanmx.com/es/tip/mcp/index Conecta tu asistente de IA favorito a las bases de datos de Tukan con nuestro servidor MCP El **[MCP (Model Context Protocol)](https://modelcontextprotocol.io/docs/getting-started/intro)** es un estándar abierto que permite a los asistentes de IA conectarse a fuentes externas de manera segura y estandarizada. [Tukan](https://app.tukanmx.com/user/login?redirect=%2Fwelcome) ofrece un **servidor MCP remoto** que permite a herramientas como Claude, Cursor, Copilot y Codex acceder directamente a nuestras bases de datos — sin necesidad de instalar nada localmente. ## ¿Qué puedes hacer con el MCP de Tukan? El MCP de Tukan le da a tu asistente de IA acceso directo a más de **300 bases de datos** de información financiera, macroeconómica y sociodemográfica de México. Estas son algunas de las cosas que puedes hacer: * **Reportes con datos confiables**: Integra todo el poder de la IA con la calidad y profundidad de los datos de Tukan para reportes, análisis y visualizaciones respaldados en **datos confiables**. * **Consultas SQL avanzadas**: Tu agente puede ejecutar queries directamente sobre las bases de datos de Tukan con total flexiblidad para análisis avanzados, segmentaciones y cruces de información. * **Guardar consultas recurrentes**: Guarda tus queries y conéctalas a Excel, Power BI, Python, R y más para automatizar tus flujos de datos. ## Requisitos Para usar el MCP de Tukan necesitas: 1. **Una cuenta de Tukan con acceso al MCP** — Si aún no tienes una cuenta de Tukan, puedes registrarte [aquí](https://app.tukanmx.com/). 2. **Un cliente compatible con MCP** — Cualquiera de los siguientes: La app de Anthropic. El CLI de Anthropic para desarrollo. Editor de código con IA integrada. Copilot en VS Code con soporte MCP. El agente de terminal de OpenAI. Cualquier cliente que soporte MCP. # Otros clientes Source: https://docs.tukanmx.com/es/tip/mcp/otros Conecta cualquier cliente compatible con MCP al servidor de Tukan, incluso si no aparece en nuestra lista. El MCP de Tukan es un **servidor MCP remoto estándar**, por lo que funciona con cualquier cliente o agente que soporte el protocolo: Manus, Hermes, OpenCode, Windsurf, Cline, y muchos más. Si tu cliente no aparece en nuestra lista, lo más sencillo es **pedirle a tu propio agente que haga la conexión por ti**. Solo necesitas estos dos datos: * **URL del servidor**: `https://ai.tukanmx.com/mcp` * **Tipo de transporte**: HTTP (Streamable HTTP) ## Conecta con la ayuda de tu agente Copia el siguiente prompt y pásaselo a tu agente (Manus, Hermes, OpenCode, etc.). Él se encargará de averiguar cómo se configura un servidor MCP en tu cliente y dejará la conexión lista: ```text Prompt para tu agente wrap="true" theme={null} Quiero conectar el servidor MCP remoto de Tukan a este cliente para poder consultar sus bases de datos. Datos del servidor: - Nombre: tukan - URL: https://ai.tukanmx.com/mcp - Transporte: HTTP (Streamable HTTP) - Autenticación: OAuth en el navegador (se abrirá una ventana para iniciar sesión con mi cuenta de Tukan) Por favor: 1. Averigua cómo se agrega un servidor MCP remoto en este cliente (archivo de configuración o comando del CLI). 2. Agrégalo con los datos anteriores. 3. Indícame los pasos que debo seguir para completar la autenticación. 4. Verifica que la conexión quedó activa y que las herramientas de Tukan están disponibles. ``` ## Configuración manual Si prefieres configurarlo tú mismo, la mayoría de los clientes piden los mismos datos. Por ejemplo, en formato JSON: ```json theme={null} { "servers": { "tukan": { "type": "http", "url": "https://ai.tukanmx.com/mcp" } } } ``` La primera vez que tu cliente utilice la conexión, se abrirá una ventana de autenticación en tu navegador para que inicies sesión con tu cuenta de Tukan. ## Consideraciones En ocasiones, tu cliente te pedirá que te reautentiques. Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión. # Tips y mejores prácticas Source: https://docs.tukanmx.com/es/tip/mcp/tips Consejos para sacarle el mayor provecho al MCP de Tukan y obtener respuestas confiables. ## Cuestiona los datos si algo no cuadra Esto es lo más importante. Si un dato no te cuadra o te parece incorrecto, **pregúntale al modelo**. Los LLMs son muy buenos corrigiéndose cuando algo salió mal en la consulta. Nuestras pruebas nos indican que cuando hay un error, generalmente **no es marginal**, es un error grande. Esto se debe a que por la estructura de nuestro modelo de datos, el error más común es un doble conteo por no filtrar correctamente en alguna referencia (o dimensión de la tabla). No dudes en decirle cosas como: "Ese número parece muy alto, ¿puedes verificar que no estés sumando duplicados?" o "¿Estás excluyendo el total nacional del ranking?" ## Usa buenos modelos Hemos notado que para modelos más básicos los resultados no son confiables y a menudo contienen errores. Para obtener el máximo provecho del MCP de Tukan, recomendamos usar los modelos más avanzados de cada proveedor. ## Sé específico en tu pregunta Entre más contexto le des a tu pregunta, mejor será la respuesta. Incluye: * **Periodo de tiempo**: "en los últimos 12 meses", "de 2020 a 2024", "al cierre del trimestre más reciente" * **Geografía**: "por estado", "en Jalisco", "a nivel municipal" * **Instituciones**: "los 5 principales bancos", "BBVA y Banorte", "las sofomes reguladas" * **Tipo de análisis**: "dame un ranking", "muéstrame la evolución", "compara la participación de mercado" ```text Pregunta vaga theme={null} ¿Cómo está el crédito en México? ``` ```text Pregunta específica theme={null} ¿Cuál es la cartera de crédito al consumo por tipo (automotriz, nómina, personal, tarjeta) de los 5 principales bancos al cierre del último trimestre disponible? ``` ## La paciencia es una virtud Mientras más compleja sean las consultas, puede ser que al modelo le tome más tiempo procesarlas. Si la consulta involucra varias tablas, muchos filtros o transformaciones complejas, dale un momento para que el modelo ejecute cada paso correctamente. El tiempo que te tomes para darle al modelo claridad con lo que necesitas se verá reflejado en la calidad de la respuesta que recibas. ## El MCP es muy bueno sugiriendo tablas e indicadores Si no sabes que datos hay disponibles, o quieres sugerencias para tu caso de uso preguntale al modelo antes de hacer tu consulta. Por ejemplo: "¿Qué tablas y columnas tienes disponibles para analizar el sector asegurador?" o "¿Qué indicadores relacionados con inflación puedo consultar?". ## Si quieres hacer un reporte recurrente, dícelo El MCP de Tukan te permite guardar las consultas a tu usuario para que puedas reutilizarlas y conectarlas a Excel, Power BI, Python y R. Si es un análisis que vas a necesitar de forma recurrente, pídele al modelo que lo guarde con fechas dinámicas para que siempre te entregue los datos más recientes. Para un reporte de inflación, puedes decirle: "Generame una consulta que calcule la inflación mensual y anual, por componente y guárdala como 'Monitor de inflación' con fechas dinámicas para que siempre me entregue los datos más recientes." ## Itera y refina No esperes obtener el análisis perfecto en una sola pregunta. El MCP de Tukan funciona mejor como una **conversación**. ## La re-autenticación es normal En ocasiones, tu cliente te pedirá que te reautentiques con el MCP de Tukan. Esto es parte normal del servicio. Simplemente vuelve a ingresar tus credenciales y continúa donde te quedaste. # Quickstart Source: https://docs.tukanmx.com/es/tip/quickstart Conecta tu primera consulta de Tukan a Excel en 5 minutos ## Requisitos * Créditos de consumo en tu cuenta de Tukan * Excel 365 con Power Query ## Generando la consulta en Tukan Para este ejemplo, haremos un análisis del crédito pyme para la banca en México. Dirigete a la pantalla de [Teo](https://app.tukanmx.com/teo) y escribe la siguiente pregunta: ```text Ejemplo de prompt wrap="true" theme={null} ¿Quiénes son los bancos más relevantes en crédito pyme en México y cuál es su CAGR de los últimos 3 años? ``` Podrás validar que Teo está trabajando en obtener la información al hacer click en el texto que aparece a un lado de su avatar. Ejemplo de prompt a Teo Si Teo no está obteniendo la información, es posible que estemos sufriendo problemas de conectividad. En ese caso haz *refresh* a la plataforma y espera un par de minutos antes de intentar nuevamente. Como referencia, Teo normalmente **tarda un minuto y fracción en generar las respuestas** dependiendo de la complejidad de la pregunta y la cantidad de datos que necesite consultar. Al fondo de cada interacción encontrarás un botón que te permite explorar todas las consultas realizadas. Haz click aquí para ir al editor de SQL y guardarla a tu usuario. Botón para explorar consultas Dentro del editor podrás ejecutar, descargar y modificar la consulta. En la parte superior derecha encontrarás los botones para exportar o guardar tu consulta. Editor de consultas SQL Haz click en el botón de guardar para que la consulta quede disponible en tu usuario y puedas conectarla a tus herramientas de análisis preferidas. Una vez guardada, serás redirigido a tu panel de consultas donde obtendrás el código requerido para integrarlo a Excel, Google Sheets, Power BI, etc. ![Botón para guardar consulta](https://s3.us-east-1.amazonaws.com/public.tukanmx.com/images_for_documentation/tip/save_query_3.gif) # Teo Source: https://docs.tukanmx.com/es/tip/teo Consulta información de Tukan en lenguaje natural con Teo, nuestro agente de inteligencia artificial [**Teo**](https://app.tukanmx.com/teo) es un agente que consume el [MCP de Tukan](/es/tip/mcp/index) directamente desde nuestra [plataforma](https://app.tukanmx.com), permitiéndote interactuar con las bases de datos de Tukan en lenguaje natural. ## ¿Qué puedes hacer con Teo? * **Consultar datos en lenguaje natural**: Pregunta lo que necesites y Teo traduce tu solicitud en consultas a las bases de datos de Tukan. * **Generar análisis y tablas**: Pide tablas comparativas, rankings, tendencias, etc. y Teo se encargará de generar la consulta. * **Explorar y exportar consultas**: Al final de cada interacción, puedes explorar la consulta SQL generada por Teo, guardarla en tu usuario o conectarla directamente a tus herramientas. * **Sin configuración técnica**: No necesitas instalar nada, ni contratar un servicio de IA aparte. Solo abre la plataforma y empieza a conversar. ### Pregunta lo que necesites Interactúa con Teo y obtén insights en menos de 5 minutos Por ejemplo: "¿Cuáles son las Sofomes no reguladas que más crecieron en el último mes y que tienen cuando menos \$200M de pesos en cartera?".