Servidores MCP externos

Faça o registro de um servidor MCP auto-hospedado ou de terceiros para que sua equipe possa usá-lo por meio do Unity Gateway. Crie sua conexão como parte do registro.

Para um servidor que o Databricks já fornece, escolha um MCP fornecido pelo Databricks. Para configuração automatizada, consulte a referência de API e SDK.

Antes de começar

Você precisa:

• Um workspace habilitado para o Unity Catalog e o direito Workspace access . Usuários com Consumer access não podem fazer um registro de MCP.
• Um servidor MCP que seja compatível com HTTP streamable, seu URL e seus detalhes de autenticação.
• USE CATALOG e USE SCHEMA no catálogo e no esquema pai, e CREATE SERVICE no esquema.
• CREATE CONNECTION no esquema para criar uma conexão, ou USE CONNECTION em uma conexão existente.
• Acesso de rede do workspace para o servidor. Consulte Autenticação e rede do MCP.

O workspace deve estar em uma região que suporte Model Serving.

O passo 1: realizar o registro do servidor

1. Em seu workspace, abra o Unity Gateway , selecione MCPs e clique em + MCP .

2. Choose Connect an existing MCP server .

3. Escolha um catálogo e um esquema, e digite um nome de MCP. O nome não pode ser alterado após a criação.

4. Selecione uma conexão HTTP existente ou clique em Create new connection :

   • Digite a URL do servidor MCP.
   • Escolha o método de autenticação e insira as credenciais do provedor. Para provedores compatíveis, use o OAuth gerenciado.
   • If you use OAuth with your own OAuth app, add https://<workspace-hostname>/login/oauth/http.html to the app's allowed redirect URLs. Some providers reject sign-in without it. For each authentication method's fields, see Create a connection to the external serviço.
   • Click Create & load tools to save the connection and discover its tools.

5. Em Tools , clique em Login , caso seja solicitado, e faça login no provedor. Em seguida, escolha as ferramentas a serem expuestas. Consulte Seleção de ferramentas para ver as opções de filtragem.

6. Clique em Create MCP Serviço .

Use uma conexão em nível de esquema para novos MCPs. Se você já tiver uma conexão em nível de metastore, clique em Usar uma conexão em nível de metastore para selecioná-la. Para um servidor do Marketplace, siga Instalar um servidor MCP.

o passo 2: Test a tool

Testar com AI Playground:

1. Abra o AI Playground e escolha um modelo com Tools enabled .
2. Abra Tools , clique em + Add tool e selecione MCP Servers .
3. Selecione Servidores MCP externos e, em seguida, o seu MCP.
4. Peça ao modelo para usar uma ferramenta somente de leitura. Confirme se ele faz uma chamada de ferramenta e retorna o resultado esperado.

Para testes de linha de comando, use os exemplos em Get started na página de detalhes do MCP. Se uma chamada falhar, consulte Autenticação e rede do MCP.

o passo 3: Conecte seu agente

Use o nome completo do MCP, <catalog>.<schema>.<service>, na configuração do seu agente:

• Claude Code, Codex, Cursor e outros agentes de codificação
• Agentes Python

Clients that require a server URL use:

Text

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>

Limitações

• Você pode fazer o registro de servidores MCP externos. Não é permitido registrar fontes de entidades do Genie, Databricks Apps ou Unity Catalog como seu próprio MCP. Use um MCP fornecido pelo Databricks ou conecte-se diretamente ao seu servidor no Databricks Apps.
• Comandos SQL como CREATE MCP SERVICE não são suportados.
• A pesquisa global do Unity Catalog não exibe MCPs. Encontre-os na página MCPs .

Próximos os passos

• Compartilhe o MCP com sua equipe.
• Governe ferramentas, políticas e uso.
• Atualizar ou excluir o MCP.
• Automatize com a API, a CLI, os SDKs, o Terraform ou os bundles.