Skip to main content

Configurar um registro MCP para sua organização ou empresa

Crie e hospede uma lista de servidores MCP para acesso dos seus desenvolvedores.

Quem pode usar esse recurso?

Enterprise owners and organization owners

Copilot Enterprise or Copilot Business

Pré-requisitos

Antes de criar o registro do PROTOCOLO MCP (Model Context Protocol), você deve entender a funcionalidade e os benefícios do gerenciamento do MCP para sua empresa. Confira Uso do servidor MCP em sua empresa.

Opção 1: hospedar automaticamente um registro MCP

Em sua essência, um registro MCP é um conjunto de pontos de extremidade HTTPS que fornecem detalhes sobre os servidores MCP incluídos. Você pode criar seu registro com qualquer uma das seguintes opções:

  • Faça um fork e hospede o Registro MCP de código aberto em seu próprio servidor. Para começar, consulte o Guia de Início Rápido do Registro MCP no repositório modelcontextprotocol/registry.
  • Execute o registro de software livre localmente usando o Docker.
  • Publique sua própria implementação personalizada.

Observação

Se você quiser que seus desenvolvedores tenham access para servidores MCP locais, inclua esses servidores em seu registro com a ID do servidor correta. Para saber mais, confira Implementação da lista de autorização do MCP.

Para criar um registro MCP válido que seja acessível por GitHub Copilot, o registro deve atender aos seguintes requisitos: * Requisitos de ponto de extremidade e especificação * Requisitos de compartilhamento de recursos entre origens

Requisitos de ponto de extremidade e especificação

Um registro válido deve dar suporte ao roteamento de URL e seguir a especificação do registro MCP v0.1, incluindo os seguintes pontos de extremidade: * GET /v0.1/servers: retorna uma lista de todos os servidores MCP incluídos * GET /v0.1/servers/{serverName}/versions/latest: retorna a versão mais recente de um servidor específico * GET /v0.1/servers/{serverName}/versions/{version}: retorna os detalhes de uma versão específica de um servidor

Para obter mais detalhes e exemplos de respostas JSON às solicitações, consulte a documentação oficial do Registro MCP.

Suporte para a especificação v0.1

Embora o registro MCP tenha sido iniciado usando a especificação v0, essa versão agora é considerada instável e não deve ser implementada. Em vez disso, crie seu registro de acordo com a especificação v0.1, que tem suporte nos seguintes IDEs:

IDESuporte para v0.1
VS Code Insiders
VS Code
Visual Studio.
Eclipse
IDEs JetBrains
Xcode

Requisitos de compartilhamento de recursos entre origens

Para garantir que Copilot possa fazer solicitações de origem cruzada com sucesso ao buscar seu registro, o registro ou proxy reverso deve incluir cabeçalhos de Compartilhamento de Recursos de Origem Cruzada (CORS). Adicione os seguintes cabeçalhos a todos os /v0.1/servers endpoints:

HTTP
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type

Opção 2: Usando Azure Centro de API como um registro MCP

Azure Centro de API fornece um registro MCP totalmente gerenciado com configuração automática de CORS, recursos de governança internos e nenhuma configuração adicional do servidor Web.

  1. Para concluir a configuração inicial do registro, consulte Register e descubra servidores MCP remotos em seu inventário de API na documentação do Azure.
  2. Se você quiser que seus desenvolvedores tenham access para servidores MCP locais, inclua esses servidores em seu registro com a ID do servidor correta. Para saber mais, confira Implementação da lista de autorização do MCP.
  3. PaPara garantir que GitHub Copilot possa buscar seu registro, nas configurações de visibilidade da sua Central de APIs, permita o acesso anônimo.
  4. Copie a URL do ponto de extremidade do seu Centro de APIs. No próximo artigo, você usará essa URL para disponibilizar seu registro em sua empresa.

Preços e limites

Azure Centro de API oferece uma camada gratuita para catalogação e descoberta básicas de API, incluindo o gerenciamento de registro MCP. Se você precisar de limites mais altos do que os incluídos na camada gratuita, poderá atualizar para o plano Standard. Para obter limites e preços detalhados, consulte limites do Centro de APIs do Azure na documentação do Azure.

Próximas etapas

Agora que você criou o registro mcp, você pode definir políticas MCP para sua empresa. Consulte Configurar o acesso ao servidor MCP para sua organização ou empresa.