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

