Pular para o conteúdo

Servidor MCP

O Pipe2.ai expõe um servidor Model Context Protocol (MCP) que permite que assistentes de IA — como Claude Desktop, Cursor, ChatGPT e outros — interajam diretamente com seus pipelines por meio de linguagem natural.

O que você pode fazer?

Com o servidor MCP do Pipe2.ai, os assistentes de IA podem:

Executar pipelines

Gere vídeos e imagens com IA descrevendo o que você quer em linguagem natural. O assistente cuida do envio de arquivos, da seleção do pipeline e da configuração dos parâmetros.

Verificar o status

Monitore as execuções dos pipelines com atualizações de status em tempo real. Seja notificado quando sua geração for concluída ou se algo der errado.

Gerenciar assets

Navegue, filtre e recupere seus assets gerados — imagens, vídeos e arquivos de áudio — tudo por meio de conversa.

Acompanhar créditos

Verifique seu saldo de créditos e o histórico de transações sem sair do seu assistente de IA.

Arquitetura

O servidor MCP roda como um serviço dedicado e se comunica com o backend do Pipe2.ai:

AI Assistant (Claude, Cursor, etc.)
↓ MCP Protocol (HTTP or SSE)
Pipe2.ai MCP Server
Pipe2.ai Backend API

Modos de transporte:

  • Streamable HTTP (/mcp) — transporte principal, recomendado para a maioria dos clientes
  • SSE (/sse/) — transporte legado para clientes MCP mais antigos
  • Stdio (flag --stdio) — para integrações via CLI, como claude mcp add

Principais recursos

  • Ferramentas de pipeline dinâmicas — uma ferramenta por pipeline ativo, gerada automaticamente a partir do schema do banco de dados
  • Notificações em tempo real — assinaturas via WebSocket enviam atualizações de status dos pipelines ao seu assistente
  • Autenticação OAuth 2.1 — acesso seguro, com tokens de acesso pessoal como alternativa

Próximos passos