Parte 3: Conectando LDX hub diretamente via MCP
Esta é a Parte 3 de uma série documentando as tentativas de um CEO não engenheiro de conectar o Copilot Studio à API StructFlow do hub LDX.
Parte 1 — Ainda não funcionou. Parte 2 — REST API, 8 erros, 3 horas, finalmente funcionando.
Na Parte 2, consegui fazer a rota da REST API funcionar através do Power Automate. Levou 3 horas e 8 erros. No momento em que funcionou, imediatamente me perguntei: existe um caminho mais simples?
Existe. Chama-se MCP.
Em vez de construir um fluxo do Power Automate, configurar loops de polling e depurar conectores HTTP — conectei o servidor MCP do hub LDX diretamente ao agente do Copilot Studio. Todo o processo levou cerca de 2 horas, e a maior parte disso foi descobrir duas configurações não óbvias.
Aqui está o relato completo.
Ambiente
- Microsoft Copilot Studio (inquilino Kawamura International)
- Servidor MCP do hub LDX (
https://gw.ldxhub.io/mcp) - Agente existente: Minutes Assistant (議事録アシスタント)
- Tempo necessário: ~2 horas
Por que MCP em vez de Power Automate?
A rota da REST API na Parte 2 funciona. Mas exigiu:
- Construir um loop de polling Do Until
- Depurar confusão de conectores HTTP (branco vs verde)
- Lidar com erros de referência triggerBody()
- Gerenciar tipos de variáveis para resultados assíncronos
O MCP elimina tudo isso. O agente chama a ferramenta diretamente — sem middleware, sem fluxo para manter. Se a compensação for aceitável para o seu caso de uso, é um caminho significativamente mais rápido para começar a funcionar.
A compensação: o MCP é mais adequado para casos de uso interativos e de registro único. Para processamento em lote de 20 arquivos, o Power Automate ainda é a resposta certa. Mais sobre isso na Parte 4.
Contexto
Na Kawamura International, estamos construindo processos de negócios impulsionados por IA generativa em toda a empresa. Esta verificação se concentrou na integração da StructFlow do hub LDX (extração de dados estruturados) em nosso agente do Copilot Studio "Minutes Assistant" — extraindo automaticamente o seguinte de transcrições de reuniões:
- Tarefas e itens de ação (com responsável e data de vencimento)
- Decisões tomadas
- Resumos por orador
- Candidatos à agenda da próxima reunião
Arquitetura
Usuário (cola a transcrição da reunião)
↓
Copilot Studio "Minutes Assistant"
↓ MCP ferramentas/chamada (HTTP transmitível)
Servidor MCP do hub LDX (https://gw.ldxhub.io/mcp)
↓ createStructFlowJob
Engine StructFlow (trabalho assíncrono)
↓ getStructFlowJob (polling)
Resultado JSON estruturado
↓
Copilot Studio formata e responde
Passo 1: Verifique o Endpoint Antes de Conectar
Antes de tocar no Copilot Studio, verifique se o endpoint MCP do hub LDX atende aos requisitos.
⚠️ Importante: O transporte SSE está obsoleto após agosto de 2025
O Copilot Studio descontinuou o suporte ao SSE e agora requer apenas HTTP transmitível. Sempre verifique o protocolo antes de tentar uma conexão.
Execute isso no PowerShell para verificar:
$headers = @{
"Content-Type" = "application/json"
"Accept" = "application/json, text/event-stream"
"Authorization" = "Bearer YOUR_API_KEY"
}
$body = '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
$r = Invoke-WebRequest -UseBasicParsing `
-Uri "https://gw.ldxhub.io/mcp" `
-Method POST -Headers $headers -Body $body
Write-Host "Status:" $r.StatusCode # → 200
Write-Host "Content-Type:" $r.Headers["Content-Type"] # → application/json
Write-Host "Body:" $r.Content # → protocolVersion: 2025-03-26, 26 ferramentas
O que procurar:
| Verificação | Esperado | Significado |
|---|---|---|
| Status HTTP | 200 | Endpoint acessível |
| Content-Type | application/json |
✅ HTTP transmitível |
| protocolVersion | 2025-03-26 |
✅ Último protocolo |
| contagem de ferramentas | 26 | createStructFlowJob, getStructFlowJob, etc. |
Se você receber HTTP 405 ou 404, o servidor pode suportar apenas o antigo transporte SSE — que o Copilot Studio não aceita mais.
Passo 2: Adicione o Servidor MCP no Copilot Studio
① Habilite a Orquestração Generativa primeiro
Configurações do agente → IA Generativa → Selecione "Sim, use ferramentas e conhecimentos disponíveis dinamicamente".
Sem isso, as ferramentas MCP nunca serão chamadas — não importa o que você configure.
② Adicione a Ferramenta MCP
Agente → guia Ferramentas → Adicionar uma ferramenta → Nova ferramenta MCP → Preencha o assistente:
