A declaração
Declare os servidores em um.mcp.json na raiz, como um mapa mcpServers. O campo inline mcpServers do manifesto aceita o mesmo mapa, sem o objeto envolvente.
Placeholders.
${NAME} em url ou headers é preenchido por quem instala, na folha Connect do servidor. ${NAME:-default} fornece um fallback quando nenhum valor foi salvo. Um servidor de plugin lê apenas os valores salvos na própria instalação, e não segredos de sessão com o mesmo nome. Nunca escreva um token real em uma declaração: ele é armazenado exatamente como foi escrito.
Como alternativa, um servidor pode executar um comando local (command, args, env); nesse caso, ele não aceita nenhum dos campos de Credencial HTTP acima.
A página servidores MCP documenta o formulário do Customize para um servidor independente. O servidor de um plugin usa os nomes de campo acima, e a URL, o transporte e os cabeçalhos dele aparecem como somente leitura na linha da instalação.
Quem detém a Credencial
Configurações
Cada configuração combina uma entrada da declaração acima com o local de instalação do plugin e a forma como ele é distribuído: Obrigatório instala o plugin para todos no escopo, e Oferecido permite que cada organização ou membro o instale. Ambas as opções são definidas no próprio plugin, em Customize.
- OAuth por usuário para todos
Para um servidor que oferece suporte a OAuth, use a entrada example-mcp e instale o plugin como Obrigatório na empresa ou na organização.
Com tokenScope: "user", o Acesso fica definido como Personal por padrão, então cada membro faz login apenas uma vez, em Customize → MCPs ou na primeira sessão que precisar dele.
- Uma conta de serviço da organização
Use a entrada example-mcp-service-account e instale o plugin na organização.
- O cabeçalho
Authorizationcontém um placeholder, por isso a linha exibe Connect. Um administrador da organização insere o token; os membros nunca têm acesso a ele. - Se o servidor rejeitar o token (401), a linha exibe Check the Credencial. Se o servidor também oferecer suporte a OAuth, a linha exibe ainda Sign in with OAuth instead.
- Para uma conta de serviço que faz login com OAuth, remova o cabeçalho, defina
tokenScope: "org"e conecte o login dessa conta.
- Uma chave por organização
Coloque a entrada example-mcp-service-account em um plugin da empresa e defina-o como Oferecido às organizações.
- Cada organização que instalar o plugin é dona da própria instalação, então o administrador dela preenche
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}com a chave dessa organização. - Nada é conectado no nível da empresa, e nenhuma organização vê a chave de outra.
- Já um plugin da empresa definido como Obrigatório cria uma única instalação pertencente à empresa: uma chave para todas as organizações.

