> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tukanmx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot (VS Code)

> 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).

<Tabs>
  <Tab title="Workspace (recomendado)">
    <Steps>
      <Step title="Crear el archivo de configuración">
        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"
            }
          }
        }
        ```

        <Info>
          Este archivo se puede incluir en tu repositorio para que todo tu equipo tenga acceso al MCP de Tukan automáticamente.
        </Info>
      </Step>

      <Step title="Iniciar sesión">
        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.
      </Step>

      <Step title="Confirmar la conexión">
        Abre el chat de Copilot en modo **Agent** y verifica que las herramientas de Tukan aparezcan disponibles.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Usuario (global)">
    <Steps>
      <Step title="Abrir configuración de MCP">
        Abre la paleta de comandos (`Cmd + Shift + P` en Mac / `Ctrl + Shift + P` en Windows) y ejecuta **"MCP: Open User Configuration"**.
      </Step>

      <Step title="Agregar el servidor de Tukan">
        Agrega la siguiente configuración:

        ```json mcp.json theme={null}
        {
          "servers": {
            "tukan": {
              "type": "http",
              "url": "https://ai.tukanmx.com/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Iniciar sesión">
        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.
      </Step>

      <Step title="Confirmar la conexión">
        Abre el chat de Copilot en modo **Agent** y verifica que las herramientas de Tukan aparezcan disponibles.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Ejemplo de uso

Abre el chat de Copilot en modo Agent y haz preguntas:

<CodeGroup>
  ```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.
  ```
</CodeGroup>

## Consideraciones

<Note>
  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.
</Note>