---
title: Servidores MCP
description: Configura conexiones MCP portátiles con stdio, Streamable HTTP y el antiguo HTTP+SSE.
---

# Servidores MCP



Agent Plugins define un formato `mcp.json` cerrado que los clientes asignan a su configuración MCP nativa. La [especificación de Model Context Protocol](https://modelcontextprotocol.io/specification) sigue siendo la referencia para el comportamiento de MCP en el protocolo y para su ciclo de vida.

## Documento de configuración [#documento-de-configuración]

`mcp.json` se encuentra en la raíz del plugin y solo contiene `$schema` y `mcpServers` como campos de nivel superior:

```json title="mcp.json"
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "validator": {
      "type": "stdio",
      "command": "./bin/validator",
      "args": ["--data", "${PLUGIN_DATA}/validator"],
      "env": {
        "CONFIG": "${PLUGIN_ROOT}/config.json"
      },
      "cwd": "${PLUGIN_ROOT}"
    },
    "deployment-api": {
      "type": "streamable-http",
      "url": "https://deploy.example.com/mcp",
      "headers": {
        "X-Tenant": "public-tenant"
      }
    }
  }
}
```

## Transportes [#transportes]

| Tipo              | Campos obligatorios | Notas                                                                        |
| ----------------- | ------------------- | ---------------------------------------------------------------------------- |
| `stdio`           | `type`, `command`   | `args`, `env` y `cwd` son opcionales.                                        |
| `streamable-http` | `type`, `url`       | Transporte MCP remoto actual; admite `headers` literales opcionales.         |
| `sse`             | `type`, `url`       | Transporte HTTP+SSE obsoleto; su compatibilidad es opcional para el cliente. |

Un cliente conforme que admita MCP es compatible al menos con uno de estos transportes: `stdio` o `streamable-http`. Se recomienda que admita ambos. La compatibilidad con `sse` es opcional. El cliente usa el transporte declarado para el primer intento de conexión. Agent Plugins no define un comportamiento alternativo si ese intento falla.

## Comandos y rutas de stdio [#comandos-y-rutas-de-stdio]

`command` es un único token de ejecutable, no un comando de shell. Puede ser un nombre de ejecutable simple que se resuelva mediante las reglas de búsqueda de la plataforma o una ruta relativa al plugin que empiece por `./`. La expansión de marcadores de posición no se aplica a `command`.

Si se omite, `cwd` usa la raíz del plugin. Un `cwd` explícito es relativo al plugin, parte de `${PLUGIN_ROOT}` o parte de `${PLUGIN_DATA}`, y debe permanecer dentro del directorio correspondiente.

## Variables del plugin [#variables-del-plugin]

Los clientes proporcionan dos variables de entorno a los subprocesos stdio:

* `PLUGIN_ROOT`: ruta absoluta de la raíz del plugin resuelta por el sistema de archivos.
* `PLUGIN_DATA`: directorio de datos dedicado y escribible que se conserva al actualizar el plugin.

Los clientes expanden ambos marcadores de posición en `args`, los valores de `env` y `cwd`. La expansión es textual, de una sola pasada y no recursiva. No se aplica a las claves de entorno, `command`, las URL remotas ni los encabezados HTTP. Un plugin no puede sustituir las variables de entorno reservadas.

## Conexiones remotas [#conexiones-remotas]

Las URL remotas son URL HTTP o HTTPS absolutas sin información de usuario ni fragmentos. Los extremos que no sean de bucle invertido usan HTTPS. Los encabezados configurados son datos literales y visibles en el paquete; no deben contener credenciales ni secretos.

Agent Plugins 1.0.0 no define campos portátiles de OAuth ni referencias de credenciales. La autenticación sigue bajo el control del cliente.

## Aislamiento de fallos [#aislamiento-de-fallos]

Un `mcp.json` de nivel superior no válido desactiva MCP para el plugin. Un servidor individual no válido o no disponible solo desactiva esa entrada. Los demás servidores, Agent Skills y extensiones de cliente continúan cargándose.

Descarga [`mcp.schema.json`](/schemas/1.0.0/mcp.schema.json).


---

Source: [content/docs/plugin-authors/mcp-servers.mdx](https://github.com/agentplugins/agent-plugins-site/blob/237bbf575f5843214923419f9d0933852662f4f3/content/docs/plugin-authors/mcp-servers.mdx)
Source commit: 237bbf575f5843214923419f9d0933852662f4f3

---

For a semantic overview of all documentation, see [/es/sitemap.md](/es/sitemap.md)

For an index of all available documentation, see [/es/llms.txt](/es/llms.txt)