Saltar al contenido principal
Un plugin puede incluir servidores MCP (por ejemplo, un gestor de incidencias) para que todos los que lo instalen obtengan la misma configuración del servidor sin tener que configurarlo desde cero. Después de instalarlo, proporcionas las credenciales que necesite el servidor, como una clave de API o un inicio de sesión con OAuth. Una conexión puede ser personal o compartida, según dónde esté instalado el plugin y el ajuste Acceso de la instalación.

La declaración

Declara los servidores en un archivo .mcp.json ubicado en la raíz, como un mapa mcpServers. El campo inline mcpServers del manifest admite el mismo mapa, pero sin el contenedor.
Marcadores de posición. El instalador rellena ${NAME} en url o headers desde la hoja Conectar del servidor. ${NAME:-default} proporciona un valor de fallback cuando no hay nada guardado. Un servidor de plugin solo lee los valores guardados en su instalación, no los secretos de sesión con el mismo nombre. Nunca escribas un token real en una declaración: se almacena tal cual. Un servidor también puede ejecutar un comando local (command, args, env); en ese caso no admite ninguno de los campos de credenciales HTTP anteriores.
La página de servidores MCP documenta el formulario de Personalizar para un servidor independiente. El servidor de un plugin usa los nombres de campo anteriores, y su URL, transporte y cabeceras se muestran como de solo lectura en la fila instalada.

Quién tiene la credencial

Configuraciones

Cada configuración combina una entrada de la declaración anterior con el lugar donde se instala el plugin y la forma en que se distribuye: Obligatorio lo instala para todos los usuarios del ámbito, mientras que Ofrecido permite que cada organización o miembro decida si instalarlo. Ambas opciones se configuran en el plugin desde Personalizar.

  1. OAuth por usuario para todos

Si el servidor admite OAuth, usa la entrada example-mcp e instala el plugin como Obligatorio a nivel de empresa u organización. tokenScope: "user" establece Personal como valor predeterminado de Acceso, de modo que cada miembro inicia sesión una sola vez, ya sea desde Personalizar → MCPs o desde la primera sesión que lo requiera.

  1. Una cuenta de servicio de organización

Usa la entrada example-mcp-service-account e instala el plugin a nivel de organización.
  • El encabezado Authorization contiene un marcador de posición, así que la fila muestra Conectar. Un admin de org introduce el token; los miembros nunca lo ven.
  • Si el servidor rechaza el token (401), la fila muestra Comprueba la credencial. Si el servidor también admite OAuth, la fila añade Iniciar sesión con OAuth en su lugar.
  • Si la cuenta de servicio inicia sesión con OAuth, elimina el encabezado, establece tokenScope: "org" y conecta el inicio de sesión de esa cuenta.

  1. Una clave por organización

Incluye la entrada example-mcp-service-account en un plugin de empresa y configúralo como Ofrecido a las organizaciones.
  • Cada organización que lo instala es propietaria de su instalación, por lo que su administrador rellena ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN} con la clave de esa organización.
  • No se conecta nada a nivel de empresa y ninguna organización puede ver la clave de otra.
  • En cambio, un plugin de empresa Obligatorio crea una única instalación propiedad de la empresa: una sola clave para todas las organizaciones.

  1. Ambas en un plugin

Incluye ambas entradas, como en la declaración anterior, y ofrece el plugin. Cada organización que lo instale obtendrá dos filas: una con la que los miembros inician sesión y otra que conecta el Admin de org. Al usar nombres de servidor distintos, las skills del plugin pueden indicar qué servidor usar.