Conectează DataDriven la Microsoft Copilot Studio

Pune serverul MCP DataDriven la dispoziția agenților tăi din Copilot Studio, printr-un custom connector Power Platform. Ghidul e scris pentru administratori IT / Power Platform și îți ia cam 15 minute.

MCP — streamable HTTP Cheie de API (fără OAuth) Custom connector Power Platform
https://api.datadriven.ro/mcp

La ce te conectezi

Serverul MCP DataDriven expune datele din licitațiile publice românești — anunțuri, atribuiri, informații despre firme și documentația tenderelor — ca unelte Model Context Protocol, pe care agentul tău le poate chema singur.

Endpointhttps://api.datadriven.ro/mcp
ProtocolModel Context Protocol — streamable HTTP (mcp-streamable-1.0)
AutentificareCheie de API, în headerul HTTP Ocp-Apim-Subscription-Key
Abonament necesarDataDriven PREMIUM, cu acces API activat
Tip de connectorCustom connector Power Platform (API Key)

1. Înainte să începi

Câteva lucruri de pus la punct:

  • Orchestrarea generativă trebuie să fie pornită pe agent — fără ea, uneltele MCP pur și simplu nu se cheamă (Copilot Studio → agentul tău → Settings → Generative AI).
  • Un abonament DataDriven PREMIUM cu acces API activat și cheia de API aferentă (vezi pasul 2).
  • Drept de a adăuga unelte pe agent. Wizardul (pasul 3) îți construiește singur conectorul. Calea manuală, cu import de fișier (pasul 4), cere în plus rolul Environment Maker în mediul Power Platform vizat.
  • Dacă tenantul are politici DLP, s-ar putea ca un admin să trebuiască să permită conectorul — vezi pasul 5.
Copilot Studio merge pe transportul Streamable HTTP. SSE a fost scos și nu mai e suportat pentru MCP — serverul DataDriven e Streamable HTTP, deci ești pe varianta bună.

2. Ia-ți cheia de API

Aici mergi pe cheie de API, nu pe OAuth. Wizardul MCP din Copilot Studio le suportă pe ambele, dar OAuth-ul nostru cere o autentificare interactivă a titularului de cont — nu se potrivește cu o conexiune administrată de IT. Cheia de API e un singur secret static, pe care îl pui o dată: fără aplicație OAuth, fără redirect URI, fără consimțământ în Entra.
A

Cheia ține de contul DataDriven al firmei. Titularul o ia o dată și o trimite mai departe către IT, pe canalul vostru obișnuit de secrete:

  1. Autentifică-te la datadriven.ro/app → API & MCP
  2. Copiază cheia (sau apasă Regenerate — atenție, regenerarea omoară pe loc cheia veche).

Tratează cheia ca pe o parolă — îi dă purtătorului acces PREMIUM complet la datele contului vostru.

3. Adaugă serverul — wizardul MCP (recomandat)

Calea cea mai scurtă. Nu-ți trebuie niciun fișier OpenAPI — Copilot Studio îți construiește singur conectorul din datele de mai jos.

A
  1. În Copilot Studio, deschide agentul → pagina Tools.
  2. Alege Add a tool → New tool → Model Context Protocol. Se deschide wizardul.
  3. Completează:
    • Server name: DataDriven
    • Server description: de exemplu Licitații publice românești, atribuiri, date despre firme și documentația tenderelor. Scrie-o limpede — orchestratorul se ia după ea când decide dacă să cheme serverul.
    • Server URL: https://api.datadriven.ro/mcp
  4. Pune Authentication = API key, apoi:
    • Type: Header
    • Header/parameter name: Ocp-Apim-Subscription-Key
  5. Apasă Create. La Add tool, alege Create a new connection, lipește cheia de la pasul 2 și apasă Add to agent.

4. Alternativă — importă un custom connector (OpenAPI)

Vrei o definiție de connector versionată, ținută de exemplu într-o Solution? Folosește fișierul OpenAPI gata făcut, în locul wizardului. Cere rolul Environment Maker.

OpenAPI (YAML)

Varianta recomandată pentru importatorul de custom connectors din Power Platform.

ddro-mcp-connector.yaml
OpenAPI (JSON)

Aceeași definiție în JSON, dacă uneltele tale o preferă așa.

ddro-mcp-connector.json
A
  1. În Copilot Studio: Tools → Add a tool → New tool → Custom connector (te duce în Power Apps). Sau direct pe make.powerapps.com → Custom connectors, alegând întâi mediul în care vrei să-l creezi.
  2. + New custom connector → Import an OpenAPI file.
  3. Numește-l DataDriven MCP și alege ddro-mcp-connector.yaml → Continue → Create connector. Hostul, acțiunea POST /mcp (cu x-ms-agentic-protocol: mcp-streamable-1.0) și securitatea pe cheie Ocp-Apim-Subscription-Key vin deja completate.
  4. Fă o conexiune: pe tabul Test al conectorului → + New connection → lipește cheia → salvează.
  5. Înapoi în Copilot Studio: Tools → Add a tool → Model Context Protocol, alege DataDriven MCP și conexiunea → Add to agent.

5. Permite conectorul în DLP (admin)

Accesul la serverele MCP din Copilot Studio trece prin conectorii Power Platform, așa că orice politică Data Loss Prevention care guvernează conectorii guvernează și serverul ăsta. Un connector nou care iese către un host extern e, de regulă, blocat din start. Un admin de Power Platform trebuie să pună DataDriven MCP în grupul Business (sau într-un grup pe care îl folosești și cu ceilalți conectori ai agentului): Power Platform admin center → Policies → Data policies → editezi politica mediului → muți conectorul → Save. Dacă sari peste pasul ăsta, simptomul e clar: unealta apare, dar apelurile pică cu eroare de politică.

6. Folosește uneltele în agent

A

Odată adăugat, Copilot Studio descoperă singur uneltele serverului (căutare de anunțuri, atribuiri, date despre firme, documentația tenderelor…) și le ține la zi dacă serverul se schimbă. Toate sunt pornite din start — dacă unele nu-ți trebuie, le stingi din comutatoarele individuale. Dai Save / Publish pe agent și de aici încolo poate chema DataDriven ca să răspundă la întrebări despre licitații.

Uneltele de Atelier de ofertă (workspace_*) apar și pe calea asta, dacă abonamentul e PREMIUM și are opțiunea AtelierAI activă. Diferența față de o conexiune OAuth e la atribuire: pe cheie de API, acțiunile se contabilizează pe titularul proiectului, nu pe un utilizator anume.

Depanare

Ce veziDe ceCe faci
Uneltele MCP nu se cheamă niciodată / nu apare opțiunea Model Context ProtocolOrchestrarea generativă e oprităPornește-o din agent → Settings → Generative AI.
401 unauthenticatedCheie greșită sau goală, ori header greșitVerifică din nou conexiunea; headerul trebuie să fie exact Ocp-Apim-Subscription-Key. Recopiază cheia.
401 … must transit api.datadriven.roHostul nu e api.datadriven.roCorectează Host-ul conectorului.
Conectorul sau unealta e blocată la rularePolitică DLPFă pasul 5.
Nu poți crea conectorulÎți lipsește rolul Environment MakerCere rolul, sau roagă un admin să-l creeze el.
403 access_deniedAbonamentul nu e activVerifică dacă abonamentul DataDriven PREMIUM mai e activ.
402 / „limită atinsă”S-au consumat cele 100 de tendere extrase complet din cicluCumpără un pachet de credite. Vezi Tarife.

Ai nevoie de ajutor?

Vezi prezentarea completă API & MCP, ghidurile pentru ceilalți asistenți, sau scrie-ne dacă te-ai blocat la chei, abonament sau la punerea în funcțiune.

Prezentare API & MCP Documentație tehnică Ghid Claude Ghid ChatGPT Scrie-ne