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

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

> \[!IMPORTANT] Esse recurso está dentro prévia pública e não é o método recomendado para restringir o acesso a servidores MCP. O método mais seguro e geralmente disponível é definir as configurações no arquivo da `managed-settings.json` sua empresa. Consulte [Configurando uma lista de permissões do servidor MCP para sua empresa](/pt/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-enterprise-allowlist).

## 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](/pt/copilot/concepts/mcp-management).

## 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](https://github.com/modelcontextprotocol/registry/tree/main?tab=readme-ov-file#quick-start) no repositório `modelcontextprotocol/registry`.
* Execute o registro de software livre localmente usando o Docker.
* Publique sua própria implementação personalizada.

> \[!NOTE]
> 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 [Imposição de registro privado do MCP](/pt/copilot/reference/enterprise-administrators/mcp-private-registry-enforcement).

Para criar um registro MCP válido que seja acessível pelo GitHub Copilot, o registro deve atender aos seguintes requisitos:

* [Requisitos de ponto de extremidade e especificação](#endpoint-and-specification-requirements)
* [Requisitos de compartilhamento de recursos entre origens](#cross-origin-resource-sharing-requirements)

### 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](https://registry.modelcontextprotocol.io/docs).

#### 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 nas seguintes superfícies:

| Superfície       | Suporte para v0.1                                                                                                                                                                                                                                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| VS Code Insiders | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| VS Code          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Visual Studio    | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Eclipse          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| IDEs JetBrains   | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Xcode            | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |
| Copilot CLI      | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-check" aria-label="Supported" role="img"><path d="M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z"></path></svg> |

### Requisitos de compartilhamento de recursos entre origens

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

```http copy
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](https://learn.microsoft.com/azure/api-center/register-discover-mcp-server) 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 [Imposição de registro privado do MCP](/pt/copilot/reference/enterprise-administrators/mcp-private-registry-enforcement).
3. Para garantir que GitHub Copilot possa buscar seu registro, permita o acesso anônimo nas configurações de visibilidade do Centro de API.
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](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-subscription-service-limits#azure-api-center-limits) na documentação do Azure.

## Próximas etapas

Agora que você criou o registro mcp, você pode definir políticas MCP para sua empresa. Confira [Restringir o acesso do servidor MCP a um registro personalizado](/pt/copilot/how-tos/administer-copilot/manage-mcp-usage/restrict-based-on-registry).