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:
| IDE | Suporte 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:
Access-Control-Allow-Origin: * Access-Control-Allow-Methods: GET, OPTIONS Access-Control-Allow-Headers: Authorization, Content-Type
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.
- 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.
- 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.
- PaPara garantir que GitHub Copilot possa buscar seu registro, nas configurações de visibilidade da sua Central de APIs, permita o acesso anônimo.
- 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.