Cum să conectezi Dify cu MCP: Ghid complet de integrare

Ultima actualizare: 25/08/2026

  • Permite expunerii aplicațiilor Dify ca servere MCP, astfel încât asistenți precum Claude sau Cursor să le poată utiliza ca extensii native.
  • Dify poate acționa și ca un client MCP, integrând instrumente externe și fluxuri avansate de automatizare în propriile noduri.
  • Configurarea necesită gestionarea adreselor URL securizate și proiectarea unor scheme JSON detaliate pentru a optimiza interpretarea de către inteligența artificială.
Cum se conectează Dify cu MCP

Dacă folosești Dify pentru a crea agenți, chatbot-uri sau fluxuri de lucru bazate pe inteligență artificială, Protocolul de context al modelului (MCP) îți permite să duci aceste aplicații dincolo de interfața lor standard. Datorită MCP, poți... publicați o aplicație Dify ca instrument Disponibil pe clienți compatibili precum Claude Desktop sau Cursor.

Integrarea funcționează și invers. Dify se poate conecta la servere MCP externe și își poate importa instrumentele pentru a fi utilizate în cadrul fluxurilor de lucru, fluxurilor de chat și agenților. Acest lucru permite unei aplicații să interogheze servicii externe, să interacționeze cu baze de date sau să execute acțiuni fără a dezvolta o integrare separată pentru fiecare platformă.

În acest ghid vom vedea Cum se conectează Dify cu MCP în ambele direcții, cum să protejez URL-ul de acces, cum să adaug aplicația la Claude Desktop și Cursor și ce să verific dacă serverul nu apare sau instrumentele sale nu funcționează corect.

Dify este disponibil ca serviciu cloud gestionat și ca platformă autogestionată. Cu Dify Cloud, furnizorul gestionează o mare parte din infrastructură; cu o platformă autoinstalată, actualizările, securitatea, disponibilitatea și configurarea rețelei sunt responsabilitatea dumneavoastră.

Ce vă permite integrarea Dify cu MCP?

Conectați Dify cu MCP

El Protocolul de context model Este un standard deschis care vă permite să conectați aplicații de inteligență artificială cu instrumente externe, surse de date și alte sisteme. Scopul său este de a împiedica fiecare serviciu să necesite o integrare complet diferită.

Există două modalități principale de a utiliza Dify:

  • Dify ca server MCP: publică o aplicație astfel încât Claude Desktop, Cursor și alți clienți să o poată folosi ca instrument extern.
  • Dify ca și client MCP: Conectează servere la distanță și importă instrumentele acestora pentru a le încorpora în aplicații create în Dify.

Această distincție este importantă. Atunci când funcționează ca server, Dify oferă capabilitățile unei aplicații preexistente. Atunci când acționează ca client, Dify consumă instrumentele furnizate de alte servere.

Cum se transformă o aplicație Dify într-un server MCP

Cum să creezi un asistent AI fără a scrie o singură linie de cod folosind Dify
Articol conex:
Cum să creezi un asistent AI fără a scrie o singură linie de cod folosind Dify

Pentru început, deschideți aplicația pe care doriți să o partajați în Dify. Aceasta ar putea fi, de exemplu, un asistent conectat la o bază de cunoștințe sau un flux de lucru care procesează documente și returnează un rezultat structurat.

Accesați opțiunile de publicare sau de setări ale aplicației și căutați modulul numit Server MCPFuncția este inițial dezactivată. Activarea ei generează o adresă unică ce va acționa ca punct de conexiune pentru clienții externi.

Înainte de a o copia, verificați dacă versiunea publicată a aplicației funcționează corect și dacă intrările sale sunt bine definite. Clienții MCP trebuie să știe ce face instrumentul și ce parametri să trimită, astfel încât descrierile ambigue pot duce la invocări incorecte.

Cum se definesc intrările aplicației

Câmpurile de introducere ar trebui să aibă nume clare, tipuri adecvate și descrieri suficient de precise. Utilizarea parametrilor generici, cum ar fi data o input fără a explica ce informații conțin.

De exemplu, în loc să descrieți un câmp drept „date utilizator”, puteți specifica că acesta așteaptă un obiect care conține numele, adresa de e-mail și preferințele clientului. În acest fel, modelul utilizat de instrument va avea o șansă mai mare de a construi corect apelul.

De asemenea, este recomandabil să evitați parametrii inutili. Fiecare câmp suplimentar crește probabilitatea ca clientul să trimită informații incomplete sau formatate incorect.

Cum să protejezi adresa URL a serverului Dify MCP

Adresa generată de Dify conține acreditările necesare pentru accesarea aplicației. Prin urmare, ar trebui să o tratați ca și cum ar fi o cheie API secretă.

Conținut exclusiv - Faceți clic aici  De ce reduc volumul căștile mele AirPods când vorbesc și cum pot preveni acest lucru?

Nu îl publicați în capturi de ecran, repozitorii, documente partajate sau jurnale accesibile publicului. Dacă intenționați să îl adăugați într-un fișier de configurare, asigurați-vă că fișierul nu ajunge accidental în Git.

Dacă suspectați că adresa a fost divulgată, utilizați butonul de regenerare disponibil pe Dify. Platforma va crea o nouă adresă URL și Adresa anterioară va înceta să funcționeze imediat.Apoi va trebui să îl înlocuiți pe toți clienții conectați.

De asemenea, ar trebui să limitați acțiunile pe care aplicația le poate efectua. Un server MCP care permite modificarea bazelor de date, trimiterea de mesaje sau accesarea informațiilor private necesită mai multe controale decât un instrument dedicat exclusiv rezumării textului.

Cum se conectează aplicația Dify cu Claude Desktop

După ce serverul este activat, copiați adresa URL a acestuia și deschideți Claude Desktop. Procedura indicată de Dify implică conectarea la profilul dvs. și deschiderea Setări, acces la Integrări și selectați opțiunea de a adăuga o nouă integrare.

Lipiți adresa generată de Dify în câmpul URL al serverului și finalizați conexiunea. După ce Claude recunoaște serverul, aplicația va apărea printre instrumentele disponibile.

Înainte de a-l utiliza pentru o sarcină importantă, rulați un test simplu. Rugați-l pe Claude să identifice instrumentele conectate și să execute un apel cu date nesensibile. Acest lucru vă permite să verificați dacă intrările sunt interpretate corect și că Dify returnează rezultatul așteptat.

Locația și numele meniurilor lui Claude se pot schimba între versiuni. Dacă secțiunea de integrări nu apare, verificați dacă utilizați o versiune actuală a clientului și dacă funcția este disponibilă în contul dvs.

Cum se conectează Dify cu MCP în Cursor

Cursorul vă permite să configurați serverele MCP în cadrul unui proiect folosind fișierul .cursor/mcp.jsonDacă folderul sau fișierul nu există, îl puteți crea în directorul rădăcină al proiectului.

Configurația de bază este următoarea:

{
  "mcpServers": {
    "dify-app": {
      "url": "URL_DEL_SERVIDOR_MCP_DE_DIFY"
    }
  }
}

Înlocuiește URL_DEL_SERVIDOR_MCP_DE_DIFY prin intermediul adresei furnizate de Dify. Numele dify-app Este un identificator local și îl puteți schimba cu unul care descrie mai bine funcția aplicației.

Cursorul ar trebui să detecteze serverul și să afișeze instrumentele acestuia. Dacă nu apare, verificați dacă fișierul conține un JSON valid, este salvat în locația corectă și dacă adresa URL nu include spații sau caractere suplimentare atunci când este copiată.

Dacă lucrați cu un depozit partajat, evitați încărcarea unei căi care conține credențiale. Includeți fișierul în excluderile Git sau utilizați mecanismul de gestionare a secretelor acceptat de mediul dvs.

Cum se utilizează Dify ca client MCP

Folosește Dify ca client MCP

Dify se poate conecta și la servere MCP externe și poate importa instrumentele pe care le publică. Configurația curentă se află în Integrări > Instrumente, în cadrul secțiunii corespunzătoare MCP.

Pentru a adăuga un server, trebuie să furnizați:

  • Adresa URL a serverului MCP.
  • Un nume care permite identificarea sa în spațiul de lucru.
  • Un identificator unic utilizat intern de aplicații.

Dify se conectează la server, preia lista de instrumente și vă permite să le utilizați ca pe orice alt instrument de pe platformă. Acestea pot fi adăugate ca noduri independente în cadrul unui flux de lucru sau al unui flux de chat sau puse la dispoziția unui nod de agent, astfel încât modelul să poată decide când să le utilizeze.

În prezent, Dify acceptă această integrare. Servere MCP la distanță cu transport HTTPUn server local configurat exclusiv prin stdio Nu îl puteți adăuga lipind comanda sa de execuție în această secțiune. În acest caz, veți avea nevoie de o versiune la distanță compatibilă cu HTTP sau de un gateway care publică serviciul utilizând un transport acceptat.

Configurați autentificarea serverului

Unele servere se pot conecta fără autentificare, în timp ce altele utilizează OAuth, token-uri sau chei API. Dify acceptă înregistrarea dinamică a clienților pentru serverele compatibile cu OAuth.

Dacă serverul nu permite înregistrarea automată, o puteți dezactiva și introduce ID-ul clientului și secretul furnizate de serviciu. Dify va afișa apoi adresa URL de redirecționare de care veți avea nevoie pentru a vă înregistra la server.

Conținut exclusiv - Faceți clic aici  Ghid complet pentru comprimarea PDF-urilor cu Stirling PDF

Pentru serviciile care așteaptă un token static, se pot configura anteturi personalizate. Un exemplu comun este:

Authorization: Bearer TU_TOKEN

Nu partajați capturi de ecran care arată valoarea completă și nu introduceți secrete direct în câmpurile destinate instrucțiunilor modelului.

Actualizați instrumentele importate

Când serverul adaugă, elimină sau modifică instrumente, puteți actualiza catalogul său din Dify. Totuși, trebuie să faceți acest lucru cu atenție: dacă o aplicație folosește un instrument care a dispărut sau ai cărui parametri s-au modificat, fluxul de lucru s-ar putea opri.

Identificatorul serverului trebuie să rămână stabil. Aplicațiile îl fac referire și, dacă îl modificați, va trebui să adăugați din nou instrumentele corespunzătoare în fiecare flux afectat.

Când exportați o aplicație pentru a o utiliza într-un alt spațiu de lucru, trebuie să recreați serverul MCP acolo cu același identificator. Acreditările și conexiunile externe nu sunt transferate automat odată cu aplicația.

Cum se utilizează instrumentele MCP într-un agent Dify

După ce serverul este conectat, creați sau deschideți un flux de lucru, un flux de chat sau un agent și adăugați instrumentele importate. Le puteți utiliza prin intermediul unui nod de instrumente atunci când doriți să controlați exact când rulează.

Cealaltă posibilitate este de a le încorpora într-un Nod de agentÎn acest caz, modelul primește descrierea instrumentelor și decide pe care să le invoce pe baza solicitării utilizatorului.

Dify vă permite să lucrați cu strategii precum Apelarea funcțiilor y ReacţionaPrimul valorifică capacitatea nativă a modelului de a apela instrumente. ReAct folosește un ciclu de raționament, acțiune și observare pentru a decide asupra următorilor pași.

Agentul ar trebui să aibă o limită rezonabilă a numărului de iterații pentru a preveni buclele și costurile neașteptate. În plus, ar trebui să aibă acces doar la instrumentele esențiale pentru sarcina sa. Acordarea accesului nerestricționat la numeroase servere îngreunează selecția și crește impactul oricărei instrucțiuni potențial malițioase.

Mai este necesar să instalez un plugin MCP pe Dify?

Înainte ca Dify să încorporeze aceste funcții nativ, era obișnuit să se utilizeze plugin-uri comunitare. Unul dintre cele mai cunoscute este mcp-servercare permite publicarea aplicațiilor folosind HTTP Streamable sau transportul SSE mai vechi.

Pentru o instalare modernă, opțiunea nativă a Dify este de obicei cea mai simplă alternativă. Pluginul comunitar poate fi încă util în implementări mai vechi sau în scenarii foarte specifice, dar adaugă o dependență suplimentară și nu trebuie confundat cu funcția oficială.

Însuși autorul pluginului recomandă utilizarea acestuia exclusiv în cadrul unui rețea privatăPrin urmare, nu este recomandabil să expuneți endpoint-ul direct la internet fără a înțelege mecanismele și riscurile sale de autentificare.

Sfaturi pentru proiectarea unei integrări MCP fiabile

Descrieți uneltele cu exactitate.

Numele, descrierea și parametrii influențează direct selecția modelului. Explicați ce face instrumentul, când ar trebui utilizat, de ce date are nevoie și ce returnează.

Dacă două instrumente au funcții similare, specificați clar diferențele dintre ele. În caz contrar, agentul poate alege opțiunea greșită sau poate efectua apeluri inutile.

Permisiuni de control

Nu toate aplicațiile necesită instrumente capabile să modifice informațiile. Ori de câte ori este posibil, separați operațiunile de citire de acțiunile distructive și solicitați confirmare înainte de a trimite mesaje, a șterge înregistrări sau a face achiziții.

Ar trebui să luați în considerare și atacurile din partea injecție promptăUn server care preia conținut extern poate introduce instrucțiuni rău intenționate în contextul agentului. Limitați instrumentele disponibile și validați datele înainte de a executa acțiuni sensibile.

Ajustați timpii de așteptare

MCP normalizează comunicarea, dar nu accelerează automat aplicația. Dacă fluxul de lucru al lui Dify durează 30 de secunde, acea întârziere va fi observată și în Claude sau Cursor.

Dify vă permite să ajustați timpul de așteptare pentru cereri și citirea răspunsurilor transmise. Nu este recomandabil să creșteți acest timp fără motiv: verificați mai întâi ce nod, model sau serviciu extern cauzează întârzierea.

Când o operațiune este prea mare, poate fi utilă împărțirea ei în instrumente mai mici și mai specifice. Pe lângă reducerea latenței percepute, acest lucru ajută modelul să aleagă mai precis ce acțiune să întreprindă.

Conținut exclusiv - Faceți clic aici  Învățați programarea pentru începători?

Erori frecvente la conectarea Dify cu MCP

Erori frecvente la conectarea Dify cu MCP

Clientul nu recunoaște adresa URL Dify

Asigurați-vă că serverul MCP este activat, că ați copiat adresa completă și că nu utilizați o adresă URL regenerată anterior. Dacă ați modificat adresa în Dify, trebuie să o actualizați la toți clienții.

Cursorul nu afișează unealta

Validați conținutul .cursor/mcp.jsonVerificați dacă vă aflați în directorul rădăcină al proiectului și reporniți Cursor dacă configurația nu se actualizează automat.

Dify nu se conectează la un server extern

Verificați dacă serverul utilizează un transport HTTP compatibil și că este accesibil din rețeaua în care rulează Dify. Într-o instalare Docker, localhost în interiorul containerului, de obicei nu indică computerul gazdă.

Verificați și metoda de autentificare, anteturile personalizate și timeout-urile. Jurnalele Dify și serverul pot dezvălui erori de autorizare, certificat, DNS sau conexiune.

Instrumentele nu mai funcționează după actualizare

Este posibil ca serverul să fi modificat numele, parametrii sau schema unui instrument. Actualizați catalogul și reconfigurați nodurile afectate. Nu modificați identificatorul serverului fără a examina mai întâi toate aplicațiile care depind de acesta.

Agentul alege instrumentul greșit

Îmbunătățiți descrierile, reduceți numărul de instrumente disponibile și folosiți nume distincte. De asemenea, puteți utiliza un nod de instrumente convențional atunci când trebuie să controlați exact ce operațiune ar trebui efectuată.

Conectarea Dify cu MCP vă permite să transformați o aplicație într-un instrument reutilizabil accesibil din Claude Desktop, Cursor și alți clienți compatibili. Simultan, Dify poate importa instrumente de pe servere la distanță și le poate utiliza în cadrul fluxurilor de lucru, fluxurilor de chat și agenților.

Cea mai importantă parte nu este doar să faci conexiunea să funcționeze. De asemenea, trebuie să protejezi adresele URL și datele de acreditare, să definești intrări lizibile, să limitezi permisiunile și să testezi cum se comportă instrumentele înainte de a le utiliza cu date reale. Cu aceste precauții, MCP poate transforma aplicațiile izolate într-un... ecosistem modular de agenți și servicii interconectate.

Alberto Navarro

Alberto Navarro

Sunt un pasionat de tehnologie care și-a transformat interesele de tocilar într-o profesie. Am petrecut peste 10 ani folosind tehnologie de ultimă generație și experimentând cu tot felul de programe din pură curiozitate. Acum mă specializez în tehnologia computerelor și jocuri video. De mai bine de 5 ani, scriu pentru diverse site-uri web despre tehnologie și jocuri video, creând articole care își propun să vă ofere informațiile de care aveți nevoie într-un limbaj pe care toată lumea îl poate înțelege.

Dacă aveți întrebări, cunoștințele mele variază de la tot ce ține de sistemul de operare Windows, precum și Android pentru telefoane mobile. Și angajamentul meu este față de tine, sunt mereu dispus să petrec câteva minute și să te ajut să rezolvi orice întrebări pe care le poți avea în această lume a internetului.