{"meta":{"title":"Adición de servidores MCP para GitHub Copilot CLI","intro":"Extienda las capacidades de Copilot conectando servidores del Protocolo de Contexto de Modelo (MCP) para proporcionar herramientas y contexto adicionales.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalización de la CLI de Copilot"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers","title":"Agregar servidores MCP"}],"documentType":"article"},"body":"# Adición de servidores MCP para GitHub Copilot CLI\n\nExtienda las capacidades de Copilot conectando servidores del Protocolo de Contexto de Modelo (MCP) para proporcionar herramientas y contexto adicionales.\n\nEl Protocolo de contexto de modelo (MCP) es un estándar abierto que define cómo las aplicaciones comparten contexto con modelos de lenguaje grandes (LLM). Puede conectar servidores MCP a GitHub Copilot CLI para otorgar Copilot acceso a herramientas externas, orígenes de datos y servicios. Para obtener información general sobre MCP, consulta [Acerca del Protocolo de contexto de modelo (MCP)](/es/copilot/concepts/context/mcp).\n\n## Adición de un servidor MCP\n\n> \\[!NOTE]\n> El GitHub servidor MCP está integrado Copilot CLI y ya está disponible sin ninguna configuración adicional. Los pasos siguientes son para agregar otros servidores MCP.\n\nSi su organización o empresa ha configurado una dirección URL del Registro y una directiva de lista de permitidos, esas opciones se aplican a Copilot CLI. La dirección URL del Registro configurada aparecerá como origen de detección y solo se pueden ejecutar los servidores permitidos por la directiva de lista de permitidos.\n\nPuede agregar servidores MCP de las maneras siguientes:\n\n* [Uso del `/mcp add` comando](#using-the-mcp-add-command)\n* [Uso del `copilot mcp add` subcomando](#using-the-copilot-mcp-add-subcommand)\n* [Edición del archivo de configuración](#editing-the-configuration-file)\n* [Adición de servidores MCP por repositorio](#adding-per-repository-mcp-servers)\n* [Búsqueda e instalación desde el registro (experimental)](#searching-and-installing-from-the-registry)\n\nPara obtener instrucciones de instalación, herramientas disponibles y direcciones URL para servidores MCP específicos, consulte el [GitHub Registro de MCP](https://github.com/mcp).\n\n### Usar el comando `/mcp add`\n\n1. En modo interactivo, escriba `/mcp add`. Se muestra un formulario de configuración. Use <kbd>tab</kbd> para navegar entre campos.\n\n2. Junto a **Nombre** del servidor, escriba un nombre único para el servidor MCP. Este es el nombre que usará para hacer referencia al servidor.\n\n3. Junto a **Tipo de servidor**, seleccione un tipo presionando el número correspondiente. Están disponibles los siguientes tipos:\n\n   * **Local** o **STDIO**: inicia un proceso local y se comunica a través de la entrada y salida estándar (`stdin`/`stdout`). Ambas opciones funcionan de la misma manera.\n     **STDIO** es el nombre de tipo de protocolo MCP estándar, por lo que elija esto si desea que la configuración sea compatible con VS Code, y Copilot cloud agentotros clientes MCP.\n   * **HTTP** o **SSE**: se conecta a un servidor MCP remoto.\n     **HTTP** usa el transporte HTTP que se puede transmitir.\n     **SSE** usa el HTTP heredado con el transporte de eventos enviados por el servidor, que está en desuso en la especificación de MCP, pero todavía se admite para la compatibilidad con versiones anteriores. <!-- markdownlint-disable-line GHD046 -->\n\n4. Los campos restantes dependen del tipo de servidor seleccionado:\n\n   * Si eligió **Local** o **STDIO**:\n\n     * Junto a **Comando**, escriba el comando para iniciar el servidor, incluidos los argumentos. Por ejemplo: `npx @playwright/mcp@latest`. Esto corresponde a las propiedades `command` y `args` del archivo de configuración JSON.\n     * Junto a **Variables de entorno**, especifique opcionalmente las variables de entorno que necesita el servidor, como claves de API o tokens, como pares clave-valor JSON. Por ejemplo: `{\"API_KEY\": \"YOUR-API-KEY\"}`. La `PATH` variable se hereda automáticamente del entorno. Todas las demás variables de entorno deben configurarse aquí.\n\n   * Si eligió **HTTP** o **SSE**:\n\n     * Junto a **DIRECCIÓN URL**, pegue la dirección URL del servidor remoto. Por ejemplo: `https://mcp.context7.com/mcp`.\n     * Junto a **Encabezados HTTP**, opcionalmente especifique encabezados HTTP como JSON. Por ejemplo: `{\"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"}`.\n\n5. Junto a **Herramientas**, especifique qué herramientas del servidor deben estar disponibles. Escriba `*` para incluir todas las herramientas o proporcione una lista separada por comas de nombres de herramientas (sin comillas necesarias). El valor predeterminado es `*`.\n\n6. Presione <kbd>Ctrl</kbd>+<kbd>S</kbd> para guardar la configuración. El servidor MCP se agrega y está disponible inmediatamente sin reiniciar la CLI.\n\n### Uso del `copilot mcp add` subcomando\n\nPuede agregar servidores MCP desde el terminal mediante el `copilot mcp add` subcomando, sin entrar en modo interactivo. El servidor se agrega a la configuración de usuario en `~/.copilot/mcp-config.json`.\n\nPara los servidores locales (stdio), proporcione el comando después de `--`:\n\n```shell copy\ncopilot mcp add SERVER-NAME -- COMMAND [ARGS...]\n```\n\nPara los servidores remotos (HTTP/SSE), especifique el transporte y proporcione la dirección URL:\n\n```shell copy\ncopilot mcp add --transport http SERVER-NAME URL\n```\n\nTambién puede pasar opciones adicionales:\n\n* `--env KEY=VALUE`: establezca variables de entorno para el servidor. Repita la repetición para varias variables.\n* `--header \"HEADER: VALUE\"`: establezca encabezados HTTP para servidores remotos. Repita esto para varios encabezados.\n* `--transport TRANSPORT`: establezca el tipo de transporte (`stdio`, `http`o `sse`). El valor predeterminado es `stdio`.\n* `--tools TOOLS`: especifique las herramientas que se van a habilitar. Use `*` para todas las herramientas (valor predeterminado), una lista separada por comas o `\"\"` para ninguna.\n* `--timeout MS`: establece un tiempo de espera en milisegundos.\n\n#### Ejemplos\n\nAgregue un servidor stdio local:\n\n```shell copy\ncopilot mcp add context7 -- npx -y @upstash/context7-mcp\n```\n\nAgregue un servidor local con variables de entorno:\n\n```shell copy\ncopilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server\n```\n\nAgregue un servidor HTTP remoto:\n\n```shell copy\ncopilot mcp add --transport http notion \\\n  https://mcp.notion.com/mcp\n```\n\nAgregue un servidor remoto con un encabezado de autorización:\n\n```shell copy\ncopilot mcp add --transport http \\\n  --header \"Authorization: Bearer YOUR-TOKEN\" \\\n  stripe https://mcp.stripe.com\n```\n\n### Edición del archivo de configuración\n\nTambién puede agregar servidores MCP editando el archivo de configuración en `~/.copilot/mcp-config.json`. Esto resulta útil si desea compartir configuraciones o agregar varios servidores a la vez.\n\nEn el ejemplo siguiente se muestra un archivo de configuración con un servidor local y un servidor HTTP remoto:\n\n```json copy\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp@latest\"],\n      \"env\": {},\n      \"tools\": [\"*\"]\n    },\n    \"context7\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.context7.com/mcp\",\n      \"headers\": {\n        \"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"\n      },\n      \"tools\": [\"*\"]\n    }\n  }\n}\n```\n\nPara obtener más información sobre la configuración del servidor MCP, consulte [Configuración de servidores MCP para el repositorio](/es/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\n### Adición de servidores MCP por repositorio\n\nPuede configurar servidores MCP para un proyecto específico agregando un archivo JSON al repositorio. Esto es útil cuando quieres que los servidores solo estén disponibles mientras trabajas en ese proyecto, o cuando quieres compartir una configuración de MCP con colaboradores haciendo commit de ella en el repositorio.\n\nCopilot CLI busca la configuración de nivel de proyecto en las siguientes ubicaciones:\n\n| Camino                                                                                        | Uso recomendado                                                                      |\n| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |\n| `.mcp.json` (en cualquier directorio del directorio de trabajo hasta la raíz del repositorio) | Configuración local o por extracción; habitualmente ubicada en la raíz del proyecto. |\n| `.github/mcp.json`                                                                            | Configuración compartida que se registra en el repositorio                           |\n\nCuando empiece Copilot CLI dentro de un repositorio de Git, la CLI le guiará desde el directorio de trabajo actual hasta la raíz del repositorio y carga los archivos de configuración de MCP a lo largo del proceso. Si ambos `.mcp.json` y `.github/mcp.json` existen en el mismo directorio, `.mcp.json` tiene prioridad. Cuando los nombres de servidor entran en conflicto, las definiciones de archivos más cerca del directorio de trabajo tienen prioridad. Las definiciones de nivel de proyecto también tienen prioridad sobre las de `~/.copilot/mcp-config.json`. Para obtener más información sobre la confianza relativa, consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#mcp-server-trust-levels).\n\nLos archivos a nivel de proyecto pueden usar el objeto de nivel superior `mcpServers` que se muestra en `~/.copilot/mcp-config.json`, o el formato simple de nivel superior, donde cada clave es el nombre de un servidor MCP. Por ejemplo, esta configuración usa el `mcpServers` objeto :\n\n```json copy\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp@latest\"]\n    }\n  }\n}\n```\n\nEl mismo servidor también se puede configurar con el formato simple de nivel superior:\n\n```json copy\n{\n  \"playwright\": {\n    \"type\": \"local\",\n    \"command\": \"npx\",\n    \"args\": [\"@playwright/mcp@latest\"]\n  }\n}\n```\n\n> \\[!NOTE]\n> Los servidores MCP a nivel de proyecto solo se cargan después de que confirmes que la carpeta es de confianza al iniciar por primera vez. Se omiten silenciosamente en directorios que no son de confianza. Para obtener más información sobre la confianza de carpetas, consulte [Acerca de GitHub Copilot CLI](/es/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories).\n\nEn el modo de aviso (`copilot -p`), los servidores MCP de nivel de proyecto se cargan automáticamente si el directorio actual ya es de confianza. Si el directorio no es de confianza, los servidores MCP de nivel de proyecto se omiten de forma predeterminada. Para cargarlos de todos modos, establezca la variable de entorno `GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP` en `true`, ya que el modo de prompt no puede mostrar un aviso de confianza interactivo. Para obtener más información, vea [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#environment-variables).\n\nEl `.vscode/mcp.json` archivo de VS Code no es leído por Copilot CLI. Usa la clave `servers`de nivel superior no admitida. Para migrar un existente `.vscode/mcp.json` a un formato que acepta la CLI, consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#migrating-from-vscodemcpjson).\n\n### Búsqueda e instalación desde el registro\n\n> \\[!NOTE]\n> El `/mcp search` comando es actualmente una característica experimental. Para usarlo, comience Copilot CLI con la opción de `‑‑experimental` línea de comandos o escriba `/experimental on` durante una sesión.\n\nPuede detectar e instalar servidores MCP directamente desde el [GitHub Registro de MCP](https://github.com/mcp) mediante el `/mcp search` comando en modo interactivo. Esto le permite examinar los servidores disponibles, ver sus detalles e instalarlos sin rellenar manualmente el formulario de configuración.\n\nSi su organización ha configurado una dirección URL del registro de MCP personalizada, `/mcp search` se conecta a ese registro en lugar del registro predeterminado GitHub .\n\n1. En modo interactivo, escriba `/mcp search` para examinar los servidores superiores por estrellas o `/mcp search QUERY` para buscar un servidor específico. Por ejemplo:\n\n   ```text\n   /mcp search context7\n   ```\n\n2. Se muestra una lista navegable con teclado de servidores coincidentes. Use las teclas de dirección para examinar los resultados.\n\n3. Seleccione un servidor para abrir su formulario de configuración. El formulario se rellena previamente con la configuración del servidor del Registro. Rellene los campos obligatorios, como claves de API o tokens.\n\n4. Presione <kbd>Ctrl</kbd>+<kbd>S</kbd> para guardar. El servidor se agrega a su `mcp-config.json` y se inicia inmediatamente.\n\n## Administración de servidores MCP\n\nPuede administrar los servidores MCP configurados mediante los `/mcp` comandos en modo interactivo o los `copilot mcp` subcomandos desde el terminal.\n\n### Uso de comandos `/mcp` en modo interactivo\n\n* **Enumerar servidores MCP configurados:** Use el comando `/mcp show`. Esto muestra todos los servidores MCP configurados y su estado actual.\n\n* **Ver detalles sobre un servidor específico:** Use el comando `/mcp show SERVER-NAME`. Esto muestra el estado del servidor especificado y la lista de herramientas que proporciona.\n\n* **Edite la configuración de un servidor:** Use el comando `/mcp edit SERVER-NAME`.\n\n* **Eliminar un servidor:** Use el comando `/mcp delete SERVER-NAME`.\n\n* **Deshabilitar un servidor:** Use el comando `/mcp disable SERVER-NAME`. Un servidor deshabilitado permanece configurado, pero no lo usa Copilot para la sesión actual.\n\n* **Habilite un servidor deshabilitado anteriormente:** Use el comando `/mcp enable SERVER-NAME`.\n\n### Uso `copilot mcp` de subcomandos desde el terminal\n\nTambién puede administrar servidores MCP desde el terminal sin entrar en modo interactivo.\n\n* **Enumerar todos los servidores configurados:**\n\n  ```shell copy\n  copilot mcp list\n  ```\n\n  Enumera los servidores de todos los orígenes de configuración (usuario, área de trabajo y complemento). Agregue `--json` para la salida JSON.\n\n* **Ver los detalles del servidor:**\n\n  ```shell copy\n  copilot mcp get SERVER-NAME\n  ```\n\n  Muestra el tipo, el estado y las herramientas disponibles de un servidor. Agregue `--json` para la salida JSON.\n\n* **Quitar un servidor:**\n\n  ```shell copy\n  copilot mcp remove SERVER-NAME\n  ```\n\n  Quita el servidor de la configuración del usuario.\n\n## Uso de servidores MCP\n\nUna vez que haya agregado un servidor MCP, Copilot puede usar automáticamente las herramientas que proporciona cuando sea pertinente para el mensaje. También puede hacer referencia directamente a un servidor MCP y herramientas específicas en un mensaje para asegurarse de que se usan.\n\n## Lectura adicional\n\n* [Acerca del Protocolo de contexto de modelo (MCP)](/es/copilot/concepts/context/mcp)\n* [Extensión de GitHub Copilot Chat con servidores de Protocolo de contexto de modelo (MCP)](/es/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp)\n* [Configuración de servidores MCP para el repositorio](/es/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)"}