Compatibilidade de aplicações MCP com AG-UI

O MAF não fornece configuração específica das aplicações MCP nem comportamento em tempo de execução. O suporte a aplicações MCP é implementado por middleware fora do endpoint AG-UI do MAF, que continua a receber pedidos AG-UI padrão.

Para conhecer os requisitos de configuração e compatibilidade, consulte a documentação do cliente ou middleware AG-UI selecionado.

Os endpoints do Agent Framework Python AG-UI são compatíveis com a funcionalidade MCP Apps do ecossistema AG-UI. O MCP Apps permite que aplicações frontend integrem ferramentas e recursos baseados em MCP juntamente com o seu agente AG-UI — sem necessidade de alterações do lado Python.

Architecture

O suporte para MCP Apps é fornecido pelo TypeScript MCPAppsMiddleware (), do CopilotKit (@ag-ui/mcp-apps-middleware), que se situa entre o frontend e o backend do seu Agent Framework:

┌─────────────────────────┐
│  Frontend               │
│  (CopilotKit / AG-UI)   │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  CopilotKit Runtime /   │
│  Node.js Proxy          │
│  + MCPAppsMiddleware    │
└────────┬────────────────┘
         │ AG-UI protocol
         ▼
┌─────────────────────────┐
│  Agent Framework        │
│  FastAPI AG-UI Endpoint │
└─────────────────────────┘

A camada middleware trata da descoberta de ferramentas MCP, pedidos de recursos com proxy iframe e ui/resourceUri resolução. O seu endpoint Python AG-UI recebe pedidos de AG-UI padrão e desconhece a camada MCP Apps.

Mantém o endpoint Python padrão

A integração com MCP Apps é gerida pelo middleware TypeScript. O endpoint Python não necessita de comportamento específico das aplicações MCP, mas o Agent Framework 1.23 ainda exige a declaração padrão de propriedade de autorização AG-UI:

from agent_framework import Agent
from agent_framework.ag_ui import add_agent_framework_fastapi_endpoint
from fastapi import FastAPI

app = FastAPI()
agent = Agent(name="my-agent", instructions="...", client=chat_client)

# Local/single-user example. Shared services must use authorization_scope_resolver.
add_agent_framework_fastapi_endpoint(app, agent, "/", single_user=True)

Esta abordagem é consistente com o funcionamento das MCP Apps com todas as outras integrações AG-UI Python — a camada MCP Apps está sempre no middleware TypeScript, não no backend Python.

Configuração do Middleware

Para usar as Apps MCP com o backend do seu Agent Framework, configure um Runtime do CopilotKit ou um proxy Node.js que inclua MCPAppsMiddleware e aponte para o seu endpoint em Python:

// Example Node.js proxy configuration (TypeScript)
import { MCPAppsMiddleware } from "@ag-ui/mcp-apps-middleware";

const middleware = new MCPAppsMiddleware({
  agents: [
    {
      name: "my-agent",
      url: "http://localhost:8888/",  // Your MAF AG-UI endpoint
    },
  ],
  mcpApps: [
    // MCP app configurations
  ],
});

Para obter instruções completas de configuração, consulte a documentação do CopilotKit MCP Apps e a documentação sobre os protocolos agênticos AG-UI.

O que não está no âmbito

Os seguintes são explicitamente não fazem parte da integração Python AG-UI:

  • No Python MCPAppsMiddleware: O middleware MCP Apps corre apenas na camada TypeScript.
  • O FastAPI não trata pedidos MCP com proxy em iframes: O proxy de recursos é gerido pelo middleware Node.js.
  • Do lado do Python não há ui/resourceUri descoberta: A resolução de URIs de recursos é uma preocupação de middleware.

Se a tua aplicação não precisar da camada middleware MCP Apps, o endpoint do teu Agent Framework AG-UI funciona diretamente com qualquer cliente compatível com AG-UI.

Passos seguintes

Gestão de Estados

Recursos adicionais

O MAF Go não fornece configurações ou comportamentos de execução específicos das aplicações MCP. O suporte para aplicações MCP é implementado por middleware fora do terminal AG-UI MAF.

  • Última atualização a