Skip to main content

Uso del servidor MCP de

Nota:

El servidor MCP de está actualmente en versión preliminar pública y está sujeto a cambios.

El servidor MCP de es un servidor del Protocolo de contexto de modelo (MCP) proporcionado y mantenido por . MCP te permite integrar funcionalidades de inteligencia artificial con otras herramientas y servicios, lo que mejora la experiencia de desarrollo al proporcionar asistencia de inteligencia artificial con reconocimiento del contexto.

Para más información sobre MCP, consulta la documentación oficial de MCP.

Puedes acceder al servidor MCP de de forma remota a través de Visual Studio Code, u otros editores que admitan MCP remoto; o bien, puedes ejecutarlo localmente en cualquier editor compatible con MCP, lo que te permite elegir entre la comodidad de una solución hospedada o la personalización de una configuración autohospedada.

Si deseas usar el servidor MCP remoto de , puedes hacerlo en unos pocos pasos, sin ninguna configuración local. Esto es especialmente útil para los usuarios que desean aprovechar rápidamente las funcionalidades de inteligencia artificial de sin la sobrecarga de administrar un servidor MCP local.

La ejecución local del servidor MCP de requiere un poco más de configuración, pero permite una mayor personalización y control sobre las interacciones de IA.

El servidor MCP de se puede usar para:

  • Automatizar y optimizar las tareas relacionadas con el código.
  • Conectar herramientas de terceros (como cursor, windsurf o futuras integraciones) para aprovechar las funcionalidades de contexto e inteligencia artificial de .
  • Habilitar los flujos de trabajo basados en la nube que funcionan desde cualquier dispositivo, sin configuración local.

Actualmente hay una amplia compatibilidad con servidores MCP locales en clientes como Visual Studio Code, IDE de JetBrains, XCode y otros.

La compatibilidad con servidores MCP remotos está creciendo, con editores como Visual Studio Code (con OAuth o PAT), Visual Studio (solo PAT), Windsurf (solo PAT) y Cursor (solo PAT) que proporcionan esta funcionalidad.

Para averiguar si tu editor preferido admite servidores MCP remotos, consulta la documentación del editor específico.

  • Una cuenta de .
  • Visual Studio Code, u otro editor compatible con MCP.

Las instrucciones siguientes te guían a través de la configuración del servidor MCP de en Visual Studio Code. Otros editores compatibles con MCP pueden tener pasos similares, pero el proceso exacto puede variar.

Puedes optar por configurar el servidor MCP de de forma remota o local, en función de tus necesidades y preferencias. También puedes configurar el servidor MCP de para:

  • Un repositorio específico. Esto te permitirá compartir los servidores MCP con cualquiera que abra el proyecto en Visual Studio Code. Para ello, crea un archivo .vscode/mcp.json en la raíz del repositorio.
  • Tu instancia personal de Visual Studio Code. Serás la única persona que tenga acceso a los servidores MCP configurados. Para ello, agrega la configuración al archivo settings.json en Visual Studio Code. Los servidores MCP configurados de esta manera estarán disponibles en todas las áreas de trabajo.

El servidor MCP remoto de usa la autenticación de OAuth de un solo clic de forma predeterminada, pero también puedes configurarla manualmente para usar un personal access token (PAT) para la autenticación. Si usas OAuth, el servidor MCP tendrá el mismo acceso que tu cuenta personal. Si usas un PAT, el servidor MCP tendrá acceso a los ámbitos concedidos por el PAT.

Nota:

Si eres un Enterprise Managed User con restricciones de PAT, no podrás usar la autenticación PAT. Si tienes restricciones de directiva de acceso de OAuth, necesitarás que las aplicaciones de OAuth para cada cliente estén habilitadas (excepto Visual Studio Code y Visual Studio).

Nota:

El servidor MCP de no está disponible para los usuarios de Enterprise Server. Si usas Enterprise Server, puedes instalar localmente el servidor MCP de . Consulta Configuración del servidor MCP local.

No es necesario crear un PAT ni instalar ningún software adicional para usar el servidor MCP remoto de con OAuth. Puedes configurarlo directamente en Visual Studio Code. También puedes instalar conjuntos de herramientas individuales, ya sea en modo de solo lectura o con acceso de lectura y escritura completo, lo que te permite adaptar las funcionalidades del servidor a tus necesidades específicas. Para obtener más información, consulta Configuración de la herramienta.

  1. En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).

  2. Escribe: mcp: add server y presiona Entrar.

  3. En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).

  4. En el campo Dirección URL del servidor, escribe https://api.copilot.com/mcp/ y presiona Entrar.

  5. En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.

  6. En Elegir dónde guardar la configuración, selecciona dónde deseas guardar la configuración del servidor MCP.

    • Visual Studio Code se abrirá y agregará la configuración al archivo seleccionado en el editor o creará un nuevo archivo si no existe.
  7. En la ventana emergente Visual Studio Code para autorizar el servidor MCP con OAuth, haz clic en Permitir y selecciona tu cuenta personal en la lista.

Para configurar el servidor MCP remoto de con un PAT, asegúrate de que has creado un PAT con los ámbitos necesarios para el acceso que deseas conceder al servidor MCP. Para más información, consulta Administración de tokens de acceso personal.

Deberás configurar manualmente el servidor MCP en Visual Studio Code para usar el PAT para la autorización.

  1. En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).

  2. Escribe: mcp: add server y presiona Entrar.

  3. En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).

  4. En el campo Dirección URL del servidor, escribe https://api.copilot.com/mcp/ y presiona Entrar.

  5. En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.

  6. En Elegir dónde guardar la configuración, selecciona dónde deseas guardar la configuración del servidor MCP.

    • Visual Studio Code se abrirá y agregará la configuración al archivo seleccionado en el editor o creará un nuevo archivo si no existe.
  7. En la ventana emergente Visual Studio Code para rechazar la autorización de OAuth, haz clic en Cancelar.

  8. Tendrás que editar manualmente el archivo de configuración para usar un PAT. En el archivo de configuración, al final de la línea url, agrega lo siguiente:

    JSON
        ,
          "headers": {
            "Authorization": "Bearer ${input:_token}"
          }
        },
      },
      "inputs": [
        {
          "id": "_token",
          "type": "promptString",
          "description": " Personal Access Token",
          "password": true
        }
      ]
    }
    
  9. Aparecerá un botón de "Reiniciar" en el archivo. Haz clic en "Reiniciar" para reiniciar el servidor MCP con la nueva configuración.

    Captura de pantalla del botón de reinicio del servidor MCP en el archivo de configuración. El botón "Reiniciar" está resaltado en color naranja oscuro.

  10. En la paleta de comandos, verás una solicitud para escribir el token de . Escribe el PAT que creaste anteriormente y presiona Entrar.

    • El servidor MCP ahora se configurará para usar el PAT para la autorización.

Nota:

Si eres un usuario de Enterprise Server y tu empresa tiene habilitadas restricciones de PAT, solo puedes usar puntos de conexión de API para ámbitos permitidos por la directiva PAT de tu empresa. Si todos los puntos de conexión de API están restringidos, no podrás usar el servidor MCP. Si no estás seguro acerca de la directiva PAT de tu empresa, ponte en contacto con el administrador de la empresa para obtener más información.

El uso de un servidor MCP de localmente requiere tener Docker instalado y ejecutándose en la máquina. Además, solo puedes autenticarte con un PAT, ya que OAuth no es compatible con los servidores MCP locales.

  1. Asegúrate de que tienes Docker instalado y ejecutándose en la máquina. Consulta Instrucciones de instalación de Docker.

  2. Crea un PAT con (al menos) los ámbitos read:packages y repo. Para más información, consulta Administración de tokens de acceso personal.

  3. Decide si deseas configurar el servidor MCP para un repositorio específico o para la instancia personal de Visual Studio Code.

    • Si usas un repositorio específico, abre el archivo .vscode/mcp.json en Visual Studio Code y agrega la siguiente configuración:
    JSON
       {
        "inputs": [
          {
            "type": "promptString",
            "id": "_token",
            "description": " Personal Access Token",
            "password": true
          }
        ],
        "servers": {
          "": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "_PERSONAL_ACCESS_TOKEN",
              "ghcr.io//-mcp-server"
            ],
            "env": {
              "_PERSONAL_ACCESS_TOKEN": "${input:_token}"
            }
          }
        }
      }
    
    • Si usas tu instancia personal de Visual Studio Code, abre el archivo settings.json en Visual Studio Code:
      • Presiona Ctrl+Mayús+P (Windows/Linux) o Cmd+Mayús+P (macOS).
      • Escribe Preferencias: abrir Configuración (JSON) y selecciónala.
      • Agregue la siguiente configuración:
    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "_token",
            "description": " Personal Access Token",
            "password": true
          }
        ],
        "servers": {
          "": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "_PERSONAL_ACCESS_TOKEN",
              "ghcr.io//-mcp-server"
            ],
            "env": {
              "_PERSONAL_ACCESS_TOKEN": "${input:_token}"
            }
          }
        }
      }
    }
    
  4. Guarde el archivo.

  5. En la paleta de comandos, verás una solicitud para escribir el token de . Escribe el PAT que creaste anteriormente y presiona Entrar.

    • El servidor MCP ahora se configurará para que se ejecute localmente con el PAT para la autorización.

El servidor MCP de admite la instalación de conjuntos de herramientas individuales, ya sea en modo de solo lectura o con acceso de lectura y escritura completo, lo que te permite adaptar las funcionalidades del servidor a tus necesidades específicas. Para ver las opciones de instalación con un solo clic de cada conjunto de herramientas, consulta el repositorio del servidor MCP de .

El servidor MCP de te permite realizar una amplia gama de acciones en , mediante Copilot Chat en Visual Studio Code.

  1. Para abrir Copilot Chat haz clic en el icono de la barra de título de Visual Studio Code.
  2. En el cuadro Copilot Chat, selecciona Agent en el menú emergente.
  3. Para ver las acciones disponibles, en el cuadro Copilot Chat, haz clic en el icono Seleccionar herramientas.
    • En la lista desplegable Herramientas, en Servidor MCP:, verás una lista de acciones disponibles.
  4. En el cuadro Copilot Chat, escribe un comando o una pregunta relacionados con la acción que deseas realizar y presiona Entrar.
    • Por ejemplo, puedes pedir al servidor MCP de que cree una nueva propuesta, enumere solicitudes de incorporación de cambios o recupere información del repositorio.
  5. El servidor MCP de procesará la solicitud y proporcionará una respuesta en la interfaz de chat.
    • En el cuadro Copilot Chat, es posible que se te pida que proporciones permisos adicionales o proporciones más información para completar la acción.
  6. Sigue las instrucciones que aparecen para completar la acción.

Si tienes problemas al usar el servidor MCP de , hay algunos pasos comunes de solución de problemas que puedes seguir.

Si tienes problemas para autorizar el servidor MCP, asegúrate de que:

  • Has iniciado sesión en en el IDE de tu elección.

Si te estás autenticando con un personal access token (PAT), asegúrate de que:

  • El PAT de es válido y tiene los ámbitos necesarios para las acciones que deseas realizar.
  • Has escrito el PAT correcto cuando se te solicita en Visual Studio Code.

Si tienes problemas con el modo de agente de Copilot Chat, asegúrate de que:

  • Has seleccionado el agente correcto en el cuadro Copilot Chat.
  • Has configurado correctamente el servidor MCP en Visual Studio Code.
  • Tienes los permisos necesarios para realizar las acciones que intentas ejecutar.

Si tienes otros problemas con el servidor MCP de , estas son algunas sugerencias generales que te ayudarán a solucionar los problemas:

  • Comprueba los registros de salida del servidor MCP para ver los mensajes de error.
  • Si ejecutas el servidor MCP localmente, asegúrate de que el entorno local esté configurado correctamente para ejecutar contenedores de Docker.
  • Intenta reiniciar el servidor MCP o el IDE.