Pular para o conteúdo principal

Visão Geral

A integração DSL (Domain Specific Language) MCP do CrewAI oferece a forma mais simples de conectar seus agentes aos servidores MCP (Model Context Protocol). Basta adicionar um campo mcps ao seu agente e o CrewAI cuida de toda a complexidade automaticamente.
Esta é a abordagem recomendada para a maioria dos casos de uso de MCP. Para cenários avançados que requerem gerenciamento manual de conexão, veja MCPServerAdapter.

Uso Básico

Adicione servidores MCP ao seu agente usando o campo mcps:

Formatos de Referência Suportados

Servidores MCP Remotos Externos

Seleção de Ferramentas Específicas

Use a sintaxe # para selecionar ferramentas específicas de um servidor:

Integrações MCP Conectadas

Conecte servidores MCP do catálogo CrewAI ou traga os seus próprios. Uma vez conectados em sua conta, referencie-os pelo slug:

Exemplo Completo

Aqui está um exemplo completo usando múltiplos servidores MCP:

Recursos Principais

  • 🔄 Descoberta Automática de Ferramentas: Ferramentas são descobertas e integradas automaticamente
  • 🏷️ Prevenção de Colisão de Nomes: Nomes de servidor são prefixados aos nomes das ferramentas
  • Otimizado para Performance: Conexões sob demanda com cache de esquemas
  • 🛡️ Resiliência a Erros: Tratamento gracioso de servidores indisponíveis
  • ⏱️ Proteção por Timeout: Timeouts integrados previnem conexões travadas
  • 📊 Integração Transparente: Funciona perfeitamente com recursos existentes do CrewAI

Tratamento de Erros

A integração DSL MCP é projetada para ser resiliente:

Recursos de Performance

Cache Automático

Esquemas de ferramentas são cacheados por 5 minutos para melhorar a performance:

Conexões Sob Demanda

Conexões de ferramentas são estabelecidas apenas quando as ferramentas são realmente usadas:

Melhores Práticas

1. Use Ferramentas Específicas Quando Possível

2. Lidar com Autenticação de Forma Segura

3. Planejar para Falhas de Servidor