Pular para o conteúdo principal
Um plugin pode incluir servidores MCP (por exemplo, um rastreador de issues), para que todos que o instalarem recebam a mesma configuração de servidor sem precisar configurá-la do zero. Depois de instalar o plugin, você fornece as Credenciais de que o servidor precisa, como uma chave de API ou um login via OAuth. Uma conexão pode ser pessoal ou compartilhada, dependendo de onde o plugin está instalado e da configuração de Acesso da instalação.

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.

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

  1. 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 Authorization conté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.

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

  1. Ambos em um único plugin

Inclua as duas entradas, como na declaração acima, e disponibilize o plugin. Cada organização que o instalar recebe duas linhas: uma em que os membros fazem login e outra que o administrador da organização conecta. Com nomes de servidor distintos, as habilidades do plugin podem indicar qual servidor usar.