Cadourile.ro

npx add-mcp 'https://cadourile.ro/mcp'

Poți conecta un asistent AI compatibil cu protocolul MCP (Model Context Protocol) — Claude Code, Claude Desktop, ChatGPT, Gemini, Groq, Cursor, Codex CLI sau altul — la contul tău Cadourile.ro. Asistentul poate atunci să-ți creeze liste de cadouri, să adauge cadouri și să gestioneze rezervări, direct dintr-o conversație.

Ce poate face un asistent conectat

Liste

Creează, citește și actualizează liste de cadouri.

Cadouri

Adaugă, citește și actualizează cadouri dintr-o listă. Dă-i asistentului un link către un produs și poate extrage automat titlul, descrierea, imaginea și prețul — la fel ca formularul de pe site.

Rezervări

Rezervă sau anulează rezervarea unui cadou, pe propriile tale liste.

Ca invitat

Pe liste ale altcuiva la care ești invitat, actualizează sau anulează propriile rezervări/confirmări de prezență — nu poate rezerva cadouri noi și nu poate atinge rezervările altor invitați.

Ce NU poate face: un asistent conectat prin token nu poate șterge liste sau cadouri — acțiunile de ștergere sunt permise doar din contul tău, autentificat direct pe cadourile.ro. Pe listele altcuiva, nu poate face nimic altceva decât actualiza propriile rezervări/confirmări existente.

Cum se configurează

1. Din Setări cont → Integrări (asistenți AI), generează un token nou. Alege ce acces are (citire și scriere, sau doar citire) și, opțional, o expirare.
2. Token-ul e afișat o singură dată. Copiază-l imediat — nu va mai putea fi recuperat ulterior (poți oricând genera altul).
3. Configurează clientul tău AI cu adresa https://cadourile.ro/mcp și tokenul — alege clientul tău mai jos. Serverul rulează pe infrastructura Cadourile.ro: nu trebuie să clonezi cod, să instalezi Python sau să întreții vreun proces pe mașina ta.

Claude Code

Din terminal:

claude mcp add --scope user --transport http cadourile https://cadourile.ro/mcp \
  --header "Authorization: Bearer cad_mcp_..."

Verifică conexiunea cu /mcp în Claude Code.

Claude Desktop / claude.ai (web, mobil)

Din Settings → Connectors → Add custom connector: introdu URL-ul https://cadourile.ro/mcp, alege „No sign-in" la autentificare, apoi la secțiunea „Request headers" adaugă header-ul Authorization cu valoarea Bearer cad_mcp_....

Secțiunea „Request headers" e în beta la Anthropic și poate să nu fie încă disponibilă pentru toate conturile — dacă nu o vezi în dialog, opțiunea nu a ajuns încă la organizația ta.

ChatGPT

Din Settings → Apps & Connectors → Create: introdu URL-ul https://cadourile.ro/mcp, alege metoda de autentificare „Access token / API key" și lipește tokenul (fără „Bearer" — ChatGPT îl adaugă automat). Disponibil pe planurile Plus, Pro, Business, Enterprise și Edu.

Cursor

În ~/.cursor/mcp.json (sau .cursor/mcp.json din proiect):

{
  "mcpServers": {
    "cadourile": {
      "url": "https://cadourile.ro/mcp",
      "headers": {
        "Authorization": "Bearer cad_mcp_..."
      }
    }
  }
}

OpenAI Codex CLI

În ~/.codex/config.toml:

[mcp_servers.cadourile]
url = "https://cadourile.ro/mcp"
http_headers = { Authorization = "Bearer cad_mcp_..." }

Gemini (aplicația Gemini)

Din gemini.google.com (pe web): Settings → Connected apps → Add a custom app → introdu URL-ul https://cadourile.ro/mcp. Cadourile.ro nu oferă înregistrare automată (OAuth Dynamic Client Registration), așa că la pasul de autentificare deschide „Show more" → „Advanced features" și adaugă manual header-ul Authorization cu valoarea Bearer cad_mcp_.... Conexiunea configurată în web e disponibilă apoi și în aplicația mobilă Gemini. Interfața e relativ nouă la Google și denumirile pașilor se pot schimba — dacă nu găsești exact aceste opțiuni, caută „Connected apps" sau „custom app" în Settings.

Conectorii personalizați din aplicația Gemini sunt disponibili doar pentru conturi Google personale (nu de organizație/școală), utilizatori de 18+ ani, cu regiunea contului în SUA, iar interfața acelui flux e doar în engleză. Dacă nu îndeplinești condițiile, folosește Gemini CLI mai jos.

Gemini CLI

În ~/.gemini/settings.json (sau .gemini/settings.json din proiect):

{
  "mcpServers": {
    "cadourile": {
      "httpUrl": "https://cadourile.ro/mcp",
      "headers": {
        "Authorization": "Bearer cad_mcp_..."
      }
    }
  }
}

Tokenul nu trebuie scris niciodată într-un mesaj de chat către asistent. El intră direct în configurația clientului (ca header HTTP) — asistentul primește doar rezultatele acțiunilor, nu tokenul în sine.

Prin API (pentru dezvoltatori)

Groq și API-ul OpenAI brut nu au o interfață de chat cu conectori de tip „lipește URL-ul și gata" — accesul la serverul MCP se face din codul propriu, per cerere, prin Responses API. Util dacă construiești propria aplicație sau bot peste aceste modele.

Groq

Remote MCP e în beta pe Groq Responses API (endpoint compatibil OpenAI):

from openai import OpenAI

client = OpenAI(
    api_key="your_groq_api_key",
    base_url="https://api.groq.com/openai/v1",
)

response = client.responses.create(
    model="openai/gpt-oss-120b",
    input="Creează-mi o listă de cadouri pentru ziua de naștere",
    tools=[{
        "type": "mcp",
        "server_label": "cadourile",
        "server_url": "https://cadourile.ro/mcp",
        "headers": {"Authorization": "Bearer cad_mcp_..."},
        # "never" execută automat orice acțiune, inclusiv scriere, fără confirmare —
        # folosește un token doar-citire cât testezi, sau "always" pentru confirmare manuală.
        "require_approval": "always",
    }],
)

OpenAI API (Responses API)

Aceeași structură, direct pe API-ul OpenAI (diferit de aplicația ChatGPT descrisă mai sus, unde conectorii se adaugă din Settings, nu din cod):

from openai import OpenAI

client = OpenAI(api_key="your_openai_api_key")

response = client.responses.create(
    model="gpt-5.1",  # orice model care suportă Responses API + tool-ul "mcp"
    input="Creează-mi o listă de cadouri pentru ziua de naștere",
    tools=[{
        "type": "mcp",
        "server_label": "cadourile",
        "server_url": "https://cadourile.ro/mcp",
        "headers": {"Authorization": "Bearer cad_mcp_..."},
        # "never" execută automat orice acțiune, inclusiv scriere, fără confirmare —
        # folosește un token doar-citire cât testezi, sau "always" pentru confirmare manuală.
        "require_approval": "always",
    }],
)

Revocare

Poți revoca oricând un token din Setări cont → Integrări — efectul e imediat, orice cerere ulterioară cu acel token e respinsă.

Pagina principală · Funcționalități · Întrebări frecvente