Conectează DataDriven la Gemini

Înregistrează DataDriven ca unealtă MCP remote pentru un agent Gemini API și trimite cheia firmei în header, fără adaptor și fără proxy.

Agent Gemini APIStreamable HTTPCheie în header

Detalii de conexiune

Ghidul ăsta e pentru dezvoltatori. Se aplică agenților din Gemini API / AI Studio, unde poți controla headerele fiecărei cereri. Aplicația de chat Gemini nu are unde să configurezi un server MCP remote — dacă vrei licitații într-o interfață de chat, ia-o pe Claude sau ChatGPT.

URL server MCPhttps://api.datadriven.ro/mcp

Nume serverdatadriven (cu litere mici)

Header de autentificareOcp-Apim-Subscription-Key: CHEIA_TA

NecesarAbonament DataDriven PREMIUM activ

Cum îl folosești din Gemini API

Ia-ți cheia din DataDriven → API & MCP, ține-o într-un secret manager sau într-o variabilă de mediu și înregistrează serverul MCP în lista de tools a agentului:

import os
from google import genai

client = genai.Client()
interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Găsește licitații publice recente pentru echipamente de laborator.",
    environment="remote",
    tools=[{
        "type": "mcp_server",
        "name": "datadriven",
        "url": "https://api.datadriven.ro/mcp",
        "headers": {
            "Ocp-Apim-Subscription-Key": os.environ["DD_API_KEY"]
        }
    }]
)
print(interaction.output_text)

Gemini vorbește Streamable HTTP și acceptă headere custom, așa că pentru DataDriven nu-ți trebuie niciun adaptor sau proxy. Verifică numele agentului din documentația Google — se schimbă de la o versiune la alta.

Înainte să-l pui pe producție

Ține DD_API_KEY departe de codul din git. Folosește variabilele de mediu ale mediului de deploy sau un secret manager.
Dacă fluxul tău e îngust, limitează agentul la uneltele de care chiar are nevoie, prin allowed_tools. Mai puține unelte înseamnă și mai puțină bâjbâială din partea modelului.
Testează pe un proiect care nu e de producție, sau cu o interogare mică, înainte să-i dai drumul pe volume mari și fără supraveghere.
Ține minte plafonul: 100 de tendere extrase complet pe ciclu, apoi pachete de credite. Un agent lăsat liber le mănâncă repede — vezi Tarife.

Depanare

Ce vezi	De ce	Ce faci
`401`	Cheia n-a ajuns în headerul care trebuie. Noi o citim doar din `Ocp-Apim-Subscription-Key` — un `Authorization: Bearer` nu ține loc.	Verifică numele headerului, literă cu literă, și că `DD_API_KEY` chiar e setat în mediu.
`402` / „limită atinsă”	Ai consumat cele 100 de tendere extrase complet din ciclul curent.	Cumpără un pachet de credite. Vezi Tarife.
`429`	Ai depășit rate limit-ul de 5 cereri/secundă.	Pune un backoff în agent. Dacă ai nevoie de mai mult, discută cu echipa.
Agentul nu cheamă uneltele	De obicei, `tools` din cererea de interaction suprascrie complet uneltele preconfigurate ale agentului.	Verifică că trimiți serverul MCP la fiecare interaction, nu doar la crearea agentului.

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