MCP în Dify: servere MCP ca unelte și aplicații publicate ca server MCP în Dify: fluxuri agentice, Knowledge și self-hosting

Integrations → Tools → MCP → adaugi URL, nume și server identifier   (Dify = client MCP)
Aplicație → Access Point → cardul MCP Server → activezi             (Dify = server MCP)

Model Context Protocol (MCP) este un protocol deschis prin care aplicațiile AI se conectează la unelte și date externe. Dify 1.6.0 (10 iulie 2025) a adăugat suport MCP în ambele direcții: ca client, importă uneltele unui server MCP; ca server, expune o aplicație Dify către alte unelte AI.

Dify ca client. În Integrations › Tools › MCP adaugi un server prin URL, nume și un server identifier unic. Sunt acceptate doar serverele cu transport HTTP. Dify se conectează, cere autorizare dacă e nevoie și importă uneltele, pe care le folosești în nodul Tool, în nodul Agent clasic, în aplicațiile Agent și Legacy Agent. Autentificarea implicită este Dynamic Client Registration (OAuth fără înregistrare manuală); dacă serverul nu o suportă, introduci Client ID și Client Secret și înregistrezi URL-ul de redirect afișat de Dify. Pentru servere cu token static adaugi headere proprii, iar o valoare ca {{request.headers.X-Custom-Auth}} preia headerul cererii HTTP care a pornit rularea.

Dify ca server. În tab-ul Access Point al aplicației, cardul MCP Server este dezactivat implicit. La activare, Dify generează o adresă unică. Adresa conține credențiale, deci se tratează ca o cheie API; butonul de regenerare o invalidează imediat pe cea veche. Doar aplicațiile care pornesc din User Input se pot publica astfel. Descrierile aplicației și ale câmpurilor de intrare contează: clientul MCP le citește ca să decidă când și cum apelează unealta.

Concepte cheie și caracteristici

Concept / Parametru	Descriere practică
Transport HTTP	Singurul tip de server MCP acceptat de Dify ca client. Un server care rulează doar prin stdio nu se poate adăuga direct.
Server identifier	Aplicațiile și exporturile DSL referă serverul după identificator. Dacă îl schimbi, uneltele lui nu mai funcționează în aplicațiile vechi; în alt workspace trebuie recreat cu același identificator.
Dynamic Client Registration	Pornit implicit: Dify obține singur credențiale OAuth de la server.
Client ID / Client Secret	Pentru serverele fără înregistrare automată sau când folosești aplicația OAuth a echipei.
Custom Headers	Headere trimise la fiecare cerere, de exemplu Authorization: Bearer <token>; acceptă valori dinamice {{request.headers.Nume}}.
Timeouts	Timeout pentru cerere și pentru citirea SSE; le mărești doar dacă apar erori de timeout.
Update tools	Reîncarcă lista de unelte a serverului; poate strica o aplicație dacă o unealtă folosită a fost schimbată sau eliminată.
MCP Server (Access Point)	Activează serverul MCP al aplicației și generează URL-ul; se poate regenera.

Exemple practice și scenarii reale

Exemplul 1: Aplicația Dify în Cursor

Fișierul .cursor/mcp.json din rădăcina proiectului. Pentru mai multe aplicații adaugi mai multe intrări în mcpServers. În Claude Desktop, documentația Dify indică Settings › Integrations › Add integration, cu același URL.

{
  "mcpServers": {
    "dify-suport": {
      "url": "URL-ul din cardul MCP Server"
    }
  }
}

Exemplul 2: Trecerea credențialelor apelantului către un server MCP

În setările serverului MCP adaugi headerul X-Custom-Auth cu valoarea {{request.headers.X-Custom-Auth}}. Când aplicația e apelată prin Service API cu acest header, valoarea ajunge la serverul MCP. Fără cerere HTTP la origine (de exemplu la un Schedule Trigger), se trimite textul placeholder neschimbat.

curl -X POST "https://dify.example.com/v1/workflows/run" \
  -H "Authorization: Bearer $DIFY_APP_KEY" \
  -H "X-Custom-Auth: $TOKEN_UTILIZATOR" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"intrebare": "Ce comenzi are clientul 42?"}, "user": "client-42"}'

Greșeli frecvente și capcane

• Publici sau trimiți pe chat URL-ul serverului MCP. Conține credențiale; dacă a ajuns unde nu trebuia, regenerează-l.
• Încerci să adaugi un server MCP local care merge doar prin stdio. Dify acceptă numai transport HTTP.
• Schimbi server identifier după ce aplicațiile folosesc deja uneltele. Ele nu mai găsesc serverul până când readaugi uneltele.
• Expui prin MCP un workflow care durează mult. Latența aplicației se simte direct în client; împarte fluxul în operații mai scurte.

Noțiuni și module înrudite

• dify-api-publishing
• dify-plugins-marketplace
• dify-noduri-workflow
• dify-tipuri-aplicatii