Guia Dify + MCP 2026: Conectar Agentes de IA a Qualquer Ferramenta
O Model Context Protocol (MCP) é o novo padrão universal para conectar modelos de IA a ferramentas externas. Este guia mostra como integrar servidores MCP ao Dify — dando aos seus agentes acesso a sistemas de arquivos, GitHub, Slack, bancos de dados e qualquer API.
O que é o MCP (Model Context Protocol)?
O Model Context Protocol (MCP) é um padrão aberto que a Anthropic lançou no final de 2024. Ele define como modelos de linguagem de IA se conectam a ferramentas e fontes de dados externas. Anteriormente, cada plataforma de IA precisava de integrações próprias para cada ferramenta — um conector GitHub, um adaptador de banco de dados, um leitor de arquivos, todos desenvolvidos separadamente. O MCP muda isso fundamentalmente.
A melhor analogia: o MCP é como USB-C para IA. Assim como o USB-C permite conectar qualquer dispositivo a qualquer computador, o MCP permite que qualquer agente de IA se conecte a qualquer servidor de ferramentas compatível com MCP. Um padrão, extensibilidade ilimitada.
Contexto técnico: O MCP usa uma arquitetura cliente-servidor via HTTP ou stdio. O agente de IA (cliente) envia solicitações para servidores MCP que fornecem "ferramentas" — funções que o agente pode chamar. O protocolo é independente de linguagem: os servidores podem ser escritos em Node.js, Python, Go ou qualquer outra linguagem.
Padronizado
Um protocolo para todas as ferramentas. Construa uma vez, conecte em qualquer lugar.
Open Source
Licença Apache-2.0. Ecossistema de servidores impulsionado pela comunidade.
Seguro
Servidores rodam localmente ou em rede privada. Seus dados ficam com você.
Extensível
Construa seus próprios servidores MCP para qualquer API, banco de dados ou serviço.
Dify como cliente MCP
O Dify suporta MCP nativamente como cliente. Isso significa: seus agentes Dify podem se comunicar diretamente com qualquer servidor MCP. Quando você adiciona um servidor MCP ao Dify, ele reconhece automaticamente todas as ferramentas fornecidas e as disponibiliza nos seus apps de agente. Seu agente de IA decide de forma autônoma quando chamar quais ferramentas.
Isso é um avanço significativo sobre as integrações de API clássicas. Em vez de criar uma entrada de "Ferramenta Personalizada" separada no Dify para cada API, você simplesmente aponta o Dify para um servidor MCP — e o catálogo completo de ferramentas é lido automaticamente. Adicione um servidor MCP do GitHub e seu agente pode imediatamente listar repositórios, ler arquivos, criar issues e revisar pull requests.
O que você pode conectar via MCP
Conectar um servidor MCP ao Dify — Passo a passo
Adicionar um servidor MCP como ferramenta no Dify leva cerca de 2 minutos. Aqui está o fluxo completo:
Iniciar o servidor MCP
Inicie seu servidor MCP localmente ou no seu servidor. Exemplo para o servidor oficial Filesystem da Anthropic: npx @modelcontextprotocol/server-filesystem /caminho/para/seus/arquivos — inicia um servidor MCP HTTP na porta 3000.
Abrir Ferramentas no Dify
No Dify, clique em Ferramentas na navegação superior, depois em Ferramentas Personalizadas no painel esquerdo.
Criar nova ferramenta MCP
Clique em "+ Criar". Selecione MCP Server como tipo de ferramenta (não OpenAPI).
Inserir a URL do servidor MCP
Cole a URL do seu servidor MCP, ex.: http://localhost:3000/mcp ou http://ip-do-seu-servidor:3000/mcp. Se seu servidor exigir autenticação, insira o token de autenticação no campo Authorization header.
Descoberta automática
O Dify carrega automaticamente o manifesto de ferramentas do servidor. Você verá uma lista de todas as ferramentas fornecidas — ex.: "read_file", "list_directory", "write_file" para um servidor Filesystem.
Adicionar ao app de agente
Abra ou crie um app de agente no Dify. Na seção Ferramentas, clique em Adicionar Ferramenta e selecione seu servidor MCP. Seu agente já pode usar todas as ferramentas reconhecidas.
Nota para auto-hospedagem: Se o Dify e seu servidor MCP rodam no mesmo host, use o IP interno ou nome de host do servidor — não localhost, pois o Dify roda em Docker. Use por exemplo: http://172.17.0.1:3000/mcp ou http://host.docker.internal:3000/mcp no macOS/Windows.
Servidores MCP populares para Dify
A Anthropic e a comunidade mantêm um ecossistema crescente de servidores MCP. Os mais úteis para o Dify:
| Servidor MCP | Função | Principais ferramentas | Instalação |
|---|---|---|---|
| filesystem | Ler e escrever arquivos locais | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | Repositórios GitHub, PRs, Issues | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Mensagens e canais Slack | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Acesso somente leitura ao banco de dados SQL | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Pesquisa na web em tempo real | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Automação de browser e scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Pesquisa de arquivos Windows (Everything) | search, get_file_info | npx @modelcontextprotocol/server-everything |
Configurar servidor MCP: Exemplo passo a passo
Exemplo completo: configurar o servidor MCP Filesystem da Anthropic para que seu agente Dify possa ler e escrever arquivos no seu servidor.
Passo 1: Instalar Node.js 18+ (pule se já instalado)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Passo 2: Iniciar o servidor MCP Filesystem
npx @modelcontextprotocol/server-filesystem /home/user/documentos
# Servidor rodando em http://localhost:3000/mcp
Passo 3: Executar como serviço em segundo plano (opcional)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documentos" --name mcp-filesystem pm2 save && pm2 startup
Passo 4: Testar o servidor
curl http://localhost:3000/mcp
# Saída esperada: {"name":"filesystem","version":"...","tools":[...]} Passo 5: Servidor MCP do GitHub (com autenticação)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_seu_token_aqui \ npx @modelcontextprotocol/server-github
# Criar GitHub PAT em: github.com/settings/tokens
Casos de uso práticos
Três configurações Dify+MCP prontas para produção que você pode replicar hoje:
Caso de uso 1: Assistente de documentos com IA
Conecte o servidor MCP Filesystem a um agente Dify. O agente de IA agora pode pesquisar suas pastas de documentos, ler contratos, extrair dados importantes, comparar versões e escrever resumos de volta — tudo por linguagem natural. "Resuma todos os relatórios PDF em /relatorios/T1 e crie um resumo executivo" — e funciona.
Caso de uso 2: Revisor de PR do GitHub
Conecte o servidor MCP GitHub ao Dify. Construa um agente que revisa pull requests automaticamente: listar PRs abertos, ler diffs, verificar padrões de código, identificar bugs em potencial e postar um comentário de revisão — tudo dentro da interface do Dify. Execute via workflows Dify com agendamento para revisão automática de código.
Caso de uso 3: Analista de banco de dados
Conecte o servidor MCP PostgreSQL ao Dify com credenciais somente leitura. Construa um analista de dados em linguagem natural: os usuários fazem perguntas de negócio em português, o agente escreve consultas SQL, executa-as no banco de dados e retorna os insights em formato legível. Sem necessidade de conhecimento de SQL por parte do usuário.
Perguntas frequentes
O que é o MCP (Model Context Protocol)?
O MCP é um padrão aberto da Anthropic que define como modelos de IA se conectam a ferramentas e fontes de dados externas. Pense nele como 'USB-C para IA' — em vez de integrações individuais para cada ferramenta, um padrão funciona em todos os lugares. O Dify suporta MCP como cliente.
O que posso conectar ao Dify via MCP?
Via MCP, você pode conectar o Dify a: sistemas de arquivos locais, GitHub (repositórios, PRs, Issues), Slack (mensagens, canais), bancos de dados PostgreSQL, navegadores web (Puppeteer), pesquisa na web (Brave, DuckDuckGo) e qualquer serviço com servidor MCP.
Preciso saber programar para usar MCP com Dify?
Para servidores MCP oficiais (Filesystem, GitHub etc.), um único comando npx é suficiente para iniciar, depois insira a URL no Dify. Sem necessidade de código. Construir seu próprio servidor MCP requer conhecimentos básicos de Node.js ou Python.
O MCP é seguro para uso em produção?
A segurança do MCP depende da configuração do seu servidor. Sempre execute servidores MCP em localhost ou em uma rede privada — nunca diretamente na internet. Use tokens de autenticação e restrinja o acesso a arquivos a diretórios específicos.
Executar Dify + MCP em produção?
O MCP mostra seu poder total quando o Dify e os servidores MCP são auto-hospedados juntos — no mesmo servidor privado, sem que os dados saiam da sua infraestrutura. O Hetzner oferece VPS a partir de €3,79/mês com desempenho para o Dify e vários servidores MCP simultaneamente. Ou use o Elestio para um deploy Dify totalmente gerenciado com um clique.