Detalhes das funcionalidades do DBAPI MCP: transforme sua API de dados em uma ferramenta para agentes de IA

O que é o MCP?

O MCP (Model Context Protocol, Protocolo de Contexto de Modelo) é um protocolo padrão aberto proposto e disponibilizado como código aberto pela Anthropic. Ele define a forma como os modelos de IA interagem com ferramentas externas e fontes de dados, funcionando como uma espécie de "interface USB‑C do mundo da IA" — por meio de especificações padronizadas, qualquer serviço que implemente o MCP pode ser integrado de forma contínua a diversos clientes e frameworks de IA.

A versão empresarial 4.5.0 do DBAPI incorpora oficialmente a capacidade do MCP Server, permitindo mapear, com um único clique, as APIs já publicadas no DBAPI como ferramentas MCP, tornando‑as descobertas e utilizáveis pelos clientes de IA.

Que problemas o MCP resolve?

Em aplicações corporativas de dados, a IA frequentemente precisa acessar bancos de dados, consultar informações comerciais e chamar serviços internos. Tradicionalmente, isso exigia o desenvolvimento de interfaces e códigos de integração específicos para cada cenário, resultando em baixa eficiência e altos custos de manutenção.

Com a funcionalidade MCP do DBAPI, é possível:

• Integração sem código: Nenhum código de integração de IA precisa ser escrito; as APIs existentes no DBAPI tornam‑se automaticamente ferramentas acessíveis à IA.
• Gerenciamento unificado: Todas as ferramentas de dados são gerenciadas centralmente no backend do DBAPI, com políticas de permissões, limitação de tráfego e monitoramento prontos para uso.
• Ecossistema aberto: Suporte a clientes e frameworks de IA populares, como Claude Desktop, Cursor, LangChain e Spring AI.
• Segurança corporativa: APIs privadas utilizam autenticação por token, com controle granular de permissões de acesso.

Como funciona

Cliente de IA / Framework de IA (Claude Desktop / Cursor / LangChain / Spring AI)
        │ Protocolo MCP (HTTP Streamable)
        ▼
  Servidor MCP do DBApi (porta 8526)
        │ Chamada HTTP
        ▼
  Backend do DBApi (porta 8520 / Gateway)
        │
        ▼
      Banco de Dados / Elasticsearch / Interfaces de terceiros

O MCP Server atua como ponte, registrando as APIs publicadas no backend do DBAPI como ferramentas MCP. Os clientes de IA descobrem a lista de ferramentas e iniciam chamadas via protocolo MCP padrão; o MCP Server encaminha essas requisições ao backend do DBAPI para execução, retornando o resultado final à IA.

Comece rapidamente

Pré‑requisitos

• Versão 4.5.0 ou superior do DBAPI Enterprise;
• Backend do DBAPI já iniciado (endereço padrão: http://127.0.0.1:8520);
• Pelo menos uma API criada e publicada.

Inicie o MCP Server

# 1. Edite o arquivo de configuração
vim mcp/mcp-config.yaml

# 2. Inicie o serviço MCP
bash bin/dbapi-mcp.sh start

Publique a API no MCP

Somente as APIs publicadas e com o interruptor MCP ativado serão expostas como ferramentas MCP.

1. Acesse o painel de administração do DBAPI.
2. Vá para a página de gerenciamento de APIs.
3. Encontre a API desejada e clique no botão Ativar MCP na barra de ações.
4. Após a ativação, o MCP Server sincronizará automaticamente na próxima atualização.

Chame as ferramentas MCP

Endereço do endpoint MCP: http://<MCP_SERVER_HOST>:8526/mcp

Obtenha a lista de ferramentas:

curl http://localhost:8526/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Chame uma ferramenta:

curl http://localhost:8526/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_BUSINESS_TOKEN" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"dbapi_xxxx","arguments":{"key":"value"}}}'

Integração com clientes de IA

O MCP Server do DBAPI utiliza o protocolo Streamable HTTP. A maioria dos clientes (Claude Desktop, Codex CLI, Cursor, LangChain, Spring AI) utiliza automaticamente o Streamable HTTP com base no URL; já o OpenClaw requer a especificação explícita de transport: "streamable-http".

Claude Desktop

Edite o arquivo de configuração (~/Library/Application Support/Claude/claude_desktop_config.json ou %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "dbapi": {
      "url": "http://localhost:8526/mcp"
    }
  }
}

Codex CLI

O Codex CLI da OpenAI suporta o transporte Streamable HTTP do protocolo MCP. Adicione via comando:

codex mcp add dbapi --url http://localhost:8526/mcp

Ou edite diretamente o arquivo ~/.codex/config.toml:

[mcp_servers.dbapi]
transport = { type = "streamable_http", url = "http://localhost:8526/mcp" }
enabled = true

Para APIs privadas que exigem token, utilize env_http_headers para ler o token das variáveis de ambiente:

export DBAPI_TOKEN=your_token_here
codex mcp add dbapi --url http://localhost:8526/mcp

[mcp_servers.dbapi]
transport = { type = "streamable_http", url = "http://localhost:8526/mcp" }
env_http_headers = { "Authorization" = "DBAPI_TOKEN" }
enabled = true

OpenClaw

Como plataforma de agentes de IA, o OpenClaw permite conectar‑se ao servidor MCP. Configure via comando openclaw mcp set:

openclaw mcp set dbapi '{"url":"http://localhost:8526/mcp","transport":"streamable-http"}'

Ou adicione ao arquivo de configuração:

{
  "mcp": {
    "servers": {
      "dbapi": {
        "url": "http://localhost:8526/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

Para APIs privadas que exigem token, inclua o campo headers:

openclaw mcp set dbapi '{"url":"http://localhost:8526/mcp","transport":"streamable-http","headers":{"Authorization":"YOUR_TOKEN"}}'

Cursor

Edite o arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "dbapi": {
      "url": "http://localhost:8526/mcp",
      "headers": {
        "Authorization": "YOUR_BUSINESS_TOKEN"
      }
    }
  }
}

LangChain

O LangChain oferece suporte nativo ao cliente MCP; basta usar o adaptador MCPAdapt para conectar‑se:

from langchain_mcp_adapters.client import MCPClient

async with MCPClient("http://localhost:8526/mcp") as client:
    tools = await client.list_tools()
    result = await client.call_tool("dbapi_xxxx", {"key": "value"})

Spring AI

O Spring AI suporta o MCP por meio do módulo mcp-client-webmvc:

McpClient client = McpClient.sync(new HttpMcpTransport("http://localhost:8526/mcp"));
List<Tool> tools = client.listTools();
client.callTool("dbapi_xxxx", Map.of("key", "value"));

Mecanismo de autenticação

Tipo de API	Descrição	Requer token?
API aberta	Acessível a todos	Não
API privada	Acessível apenas a clientes autorizados	Sim, via cabeçalho Authorization

Obtenha o token

# Obtenha clientId e secret (criados no gerenciamento de clientes no backend)
curl "http://localhost:8520/token/generate?clientId=YOUR_CLIENT_ID&secret=YOUR_CLIENT_SECRET"

O token retornado deve ser inserido no cabeçalho Authorization do cliente MCP.

Os tokens possuem validade; após expirar, será necessário obter um novo. No gerenciamento de clientes, é possível definir períodos de validade mais longos para evitar atualizações frequentes.

Aplicações corporativas

Cenário 1: Assistente de consulta por linguagem natural

Após publicar a API de consulta ao banco de dados como ferramenta MCP, os usuários podem fazer perguntas em linguagem natural diretamente no Claude Desktop:

"Quais foram os 10 produtos com maior faturamento no último mês na região leste?"

A IA automaticamente chama a API correspondente no DBAPI, retorna o resultado e apresenta‑o em linguagem natural. Sem necessidade de aprender SQL nem de acessar sistemas empresariais.

Cenário 2: Geração inteligente de relatórios

Combinando várias consultas de dados em uma única interface de geração de relatórios e publicando‑na como ferramenta MCP, os clientes de IA podem criar automaticamente relatórios estruturados de análise de dados.

Cenário 3: Agente de inspeção de anomalias de dados

Registre APIs de monitoramento de dados como ferramentas do agente LangChain. O agente realiza inspeções periódicas dos dados empresariais e, ao detectar anomalias, envia alertas via robôs do DingTalk ou Feishu.

Cenário 4: Reforço da base de conhecimento corporativa

Publique as interfaces de consulta aos sistemas internos da empresa (consultas de pedidos, informações de clientes, status de estoque etc.) como ferramentas MCP e integre‑as a assistentes de IA próprios da empresa, conferindo à IA a capacidade de consultar dados corporativos em tempo real.

Considerações importantes

• O MCP Server escuta a porta 8526 por padrão; essa configuração pode ser alterada no arquivo mcp-config.yaml.
• Somente APIs publicadas e com o interruptor MCP ativado serão expostas.
• Após modificar uma API, o MCP Server sincroniza automaticamente metadados como URLs e definições de parâmetros; não é necessário reiniciar o servidor.
• O DBAPI já possui um sistema completo de autenticação de APIs (autenticação por token e autorização de clientes) e regras de firewall IP; os clientes MCP herdam essas medidas de segurança sem necessidade de configuração adicional.
• Ao utilizar APIs privadas, certifique‑se de que o cliente tenha sido devidamente autorizado para acessar essas APIs.

Requisito de versão: A funcionalidade MCP é suportada a partir da versão 4.5.0 do DBAPI Enterprise.