Pular para o conteúdo principal
Última atualização em

Servidores MCP personalizados

Crie um servidor MCP no Databricks Apps para que seu agente possa chamar suas próprias ferramentas. O Databricks Apps fornece o compute para executar o servidor e um URL HTTPS para que os agentes se conectem a ele.

Escolha seu caminho​

Escolha uma destas três maneiras de hospedar um servidor MCP em Databricks Apps:

Criar um servidor a partir do padrão Starter​

O padrão do servidor MCP (Iniciador) inclui uma ferramenta de integridade funcional que você pode chamar antes de adicionar seu próprio código Python.

o passo 1: Encontre e implante o padrão​

Use um workspace que atenda aos requisitos do Databricks Apps.

  1. In your workspace, open Unity Gateway and select MCPs .
  2. Clique em + MCP e escolha Build a new MCP server . A página de criação de Databricks Apps é aberta.
  3. Encontre Install from a padrão . Nesta galeria de padrões, selecione a tab Agents e, em seguida, MCP Server (Starter) .
  4. Revise as configurações de recurso, compute e autorização. Clique em Avançar para continuar na configuração.
  5. Dê ao aplicativo o nome mcp-my-server e clique em Create app . Use outro nome começando com mcp- se esse nome estiver em uso. Este prefixo permite que o AI Playground reconheça o servidor MCP.

A criação do aplicativo também é implantado o código de padrão. Aguarde a conclusão da implantação na página Visão geral do aplicativo; é nela que você encontrará a URL e o status da implantação.

o passo 2: Chamar a primeira ferramenta​

Copie a URL do aplicativo na página Overview e acrescente /mcp:

Text
https://<app-hostname>/mcp

Conecte seu agente com esta URL.

Peça ao seu agente: "Call the health tool." Confirme que a ferramenta retorna "status": "healthy".

o passo 3: Adicionar sua própria ferramenta​

Adicione uma ferramenta que converta texto para maiúsculas:

  1. Na página Overview do aplicativo, siga Edit in your IDE para copiar o código-fonte para o seu computador e sincronizar as edições de volta com o workspace.

  2. Abra server/tools.py. Adicione esta função dentro de load_tools(mcp_server), junto com as ferramentas existentes:

    Python
        @mcp_server.tool
        def uppercase(text: str) -> str:
            """Convert a string to uppercase."""
            return text.upper()

  3. Sincronize suas alterações e reimplante o app.

  4. Reconecte seu agente para carregar as ferramentas atualizadas. Peça para ele chamar uppercase com hello e confirme se o resultado é HELLO.

Consulte o código-fonte do modelo padrão para obter o servidor completo.

Exponha uma API REST como ferramentas MCP​

Use esta opção quando você já tiver uma API HTTP, como uma API de consulta de clientes, e quiser que seu agente a chame. O padrão MCP Server (OpenAPI) fornece ferramentas para descobrir e chamar os endpoints da sua API.

o passo 1: Preparar a API​

O padrão precisa de duas coisas:

  • Uma descrição da API: salve a especificação OpenAPI 3.x da sua API como spec.json e faça o upload para um volume. Coloque-o na raiz do volume, fora de qualquer subpasta. Veja a especificação de exemplo.
  • Uma conexão HTTP: crie uma conexão que armazene as credenciais de autenticação da sua API ou use uma existente. Copie o nome da conexão. A criação de um requer CREATE CONNECTION.

O passo 2: Criar o aplicativo​

  1. Em Unity Gateway , selecione MCPs , clique em + MCP e escolha Build a new MCP server .
  2. On the Apps creation page, under Install from a padrão , select Agents , then MCP Server (OpenAPI) .
  3. Para o recurso uc-volume , selecione o volume contendo spec.json. Isso dá ao aplicativo acesso à descrição da sua API.
  4. Continue pelas configurações de compute e autorização. Nomeie o aplicativo mcp-my-api e clique em Create app .

o passo 3: Definir a conexão da API​

O aplicativo precisa do nome da conexão HTTP para autenticar solicitações à sua API.

  1. Na página Overview do aplicativo, siga Edit in your IDE para copiar o código-fonte para o seu computador e configurar a sincronização com o workspace.

  2. Abra app.yaml. Na seção env, localize UC_CONNECTION_NAME e defina seu valor como o nome da sua conexão:

    YAML
    - name: UC_CONNECTION_NAME
      value: my_api_connection

    Substitua my_api_connection pelo nome da sua conexão. Deixe as outras configurações de padrão inalteradas.

  3. Sincronize o arquivo atualizado e, em seguida, reimplante o aplicativo. Aguarde a conclusão da implantação em Visão geral .

O passo 4: Fazer a primeira chamada​

Cada chamador precisa de USE CONNECTION na conexão HTTP. Se ele usar OAuth por usuário, faça login no provedor quando solicitado.

  1. Copie o URL do aplicativo em Visão geral , adicione /mcp e conecte seu agente.
  2. Peça ao seu agente para chamar list_api_endpoints. Verifique se o resultado inclui os Endpoint na sua especificação.
  3. Peça ao agente para chamar um endpoint somente leitura e confirme se ele retorna dados da sua API.

See the OpenAPI padrão source for configuration details.

Especificação OpenAPI de exemplo​

Esta especificação descreve GET /widgets. Substitua a URL e as operações pelos valores da sua API:

JSON
{
  "openapi": "3.1.0",
  "info": { "title": "Example API", "version": "1.0.0" },
  "servers": [{ "url": "https://api.example.com" }],
  "paths": {
    "/widgets": {
      "get": {
        "summary": "List widgets",
        "responses": { "200": { "description": "A list of widgets" } }
      }
    }
  }
}

Implantar um servidor MCP existente​

Hospede seu servidor MCP existente no Databricks Apps.

O passo 1: Prepare seu servidor​

Sua pasta de origem precisa de:

  • Um servidor HTTP: Configure o HTTP 스트리mável. Escute em 0.0.0.0 e na porta em DATABRICKS_APP_PORT (default 8000). Observe o seu caminho MCP, como /mcp.

  • Dependências: Inclua o arquivo de dependência apropriado, como requirements.txt para o Python ou package.json para o Node.js.

  • Um comando de começar: Adicione app.yaml com o comando que inicia o seu servidor. Para um ponto de entrada Python denominado server.py, use:

    YAML
    command: ['python', 'server.py']

O passo 2: Implantar e conectar​

  1. Em Unity Gateway , selecione MCPs , clique em + MCP e escolha Build a new MCP server .
  2. On the Apps creation page, choose Create a custom app . Name it with the mcp- prefix and complete the app setup.
  3. Na página Overview do aplicativo, siga Edit in your IDE para sincronizar sua pasta de código-fonte com o workspace.
  4. Clique em Implantar , selecione a pasta do workspace e clique em Selecionar e Implantar . Aguarde a conclusão da implantação. Consulte as instruções de implantação.
  5. Copie a URL do aplicativo e adicione seu caminho do MCP. Conecte seu agente com essa URL e chame uma das ferramentas do seu servidor para verificar a conexão.

Conecte seu agente​

Use a URL do MCP para o caminho escolhido. Para os padrões Starter e OpenAPI, adicione /mcp à URL do aplicativo. Para um servidor existente, use o caminho do MCP configurado no seu servidor.

Escolha o guia de configuração do seu agente:

Os chamadores precisam de CAN USE no aplicativo. Consulte Permissões de aplicativos.

Preços e monitoramento​

Os aplicativos usam preços do Databricks Apps. Para obter os logs de implantação e de solicitação, consulte Registro em log e monitoramento para Databricks Apps.

Nesta página