O Model Context Protocol (MCP) permite que você conecte ferramentas e serviços externos usando um protocolo padronizado, possibilitando integrar APIs e serviços diretamente em seus workflows. Com o MCP, você pode estender as capacidades do ZippyVendas adicionando integrações personalizadas que funcionam perfeitamente com seus agentes e workflows.
O que é MCP?
MCP é um padrão aberto que permite que assistentes de IA se conectem de forma segura a fontes de dados e ferramentas externas. Ele fornece uma maneira padronizada para:
- Conectar a bancos de dados, APIs e sistemas de arquivos
- Acessar dados em tempo real de serviços externos
- Executar ferramentas e scripts personalizados
- Manter acesso seguro e controlado a recursos externos
Configurando Servidores MCP
Servidores MCP fornecem coleções de ferramentas que seus agentes podem usar. Configure-os nas configurações do workspace:
- Navegue até as configurações do seu workspace
- Vá para a seção MCP Servers
- Clique em Add MCP Server
- Insira os detalhes de configuração do servidor
- Salve a configuração
Você também pode configurar servidores MCP diretamente da barra de ferramentas em um bloco Agent para configuração rápida.
Usando Ferramentas MCP em Agentes
Uma vez que os servidores MCP são configurados, suas ferramentas ficam disponíveis dentro dos seus blocos de agente:
- Abra um bloco Agent
- Na seção Tools, você verá as ferramentas MCP disponíveis
- Selecione as ferramentas que você quer que o agente use
- O agente agora pode acessar essas ferramentas durante a execução
Bloco MCP Tool Standalone
Para controle mais granular, você pode usar o bloco MCP Tool dedicado para executar ferramentas MCP específicas:
O bloco MCP Tool permite que você:
- Execute qualquer ferramenta MCP configurada diretamente
- Passe parâmetros específicos para a ferramenta
- Use a saída da ferramenta em etapas subsequentes do workflow
- Encadeie múltiplas ferramentas MCP juntas
Quando Usar MCP Tool vs Agent
Use Agent com ferramentas MCP quando:
- Você quer que a IA decida quais ferramentas usar
- Você precisa de raciocínio complexo sobre quando e como usar ferramentas
- Você quer interação em linguagem natural com as ferramentas
Use o bloco MCP Tool quando:
- Você precisa de execução determinística de ferramenta
- Você quer executar uma ferramenta específica com parâmetros conhecidos
- Você está construindo workflows estruturados com etapas previsíveis
Requisitos de Permissão
A funcionalidade MCP requer permissões específicas de workspace:
| Ação | Permissão Necessária |
|---|---|
| Configurar servidores MCP nas configurações | Admin |
| Usar ferramentas MCP em agentes | Write ou Admin |
| Visualizar ferramentas MCP disponíveis | Read, Write ou Admin |
| Executar blocos MCP Tool | Write ou Admin |
Casos de Uso Comuns
Integração com Banco de Dados
Conecte a bancos de dados para consultar, inserir ou atualizar dados dentro dos seus workflows.
Integrações de API
Acesse APIs externas e serviços web que não têm integrações nativas do ZippyVendas.
Acesso ao Sistema de Arquivos
Leia, escreva e manipule arquivos em sistemas de arquivos locais ou remotos.
Lógica de Negócio Personalizada
Execute scripts ou ferramentas personalizadas específicas para as necessidades da sua organização.
Acesso a Dados em Tempo Real
Busque dados ao vivo de sistemas externos durante a execução do workflow.
Considerações de Segurança
- Servidores MCP executam com as permissões do usuário que os configurou
- Sempre verifique as fontes dos servidores MCP antes da instalação
- Use variáveis de ambiente para dados de configuração sensíveis
- Revise as capacidades do servidor MCP antes de conceder acesso aos agentes
Solução de Problemas
Servidor MCP Não Aparece
- Verifique se a configuração do servidor está correta
- Confirme que você tem as permissões necessárias
- Garanta que o servidor MCP está em execução e acessível
Falhas na Execução de Ferramentas
- Verifique se os parâmetros da ferramenta estão formatados corretamente
- Confira os logs do servidor MCP para mensagens de erro
- Garanta que a autenticação necessária está configurada
Erros de Permissão
- Confirme seu nível de permissão no workspace
- Verifique se o servidor MCP requer autenticação adicional
- Confirme que o servidor está configurado corretamente para seu workspace