# Conectarea asistenților AI (MCP)

<span data-t="appName">DM Champ</span> livrează un **server MCP** oficial — un endpoint Model Context Protocol
care permite asistenților AI precum **Claude Code**, **Claude Desktop**, **ChatGPT**,
**Cursor** și propriilor tale aplicații să controleze direct contul tău <span data-t="appName">DM Champ</span>. Întreabă în limbaj natural
("listează campaniile mele active", "adaugă acest lead", "cât m-a costat AI-ul săptămâna aceasta?")
iar asistentul va apela API-ul <span data-t="appName">DM Champ</span> pentru tine.

Este același API v1 documentat în [secțiunea API](../api/getting-started.md), autentificat cu propria cheie API. Serverul MCP construiește un instrument pentru fiecare operațiune din specificația noastră API publicată, deci acoperă majoritatea, dar nu toate, funcționalitățile API v1: contacte, mesaje, campanii, agenți AI, bază de cunoștințe, programări, analize, etichete, liste și sub-conturi. Difuzările, automatizările și tranzacțiile nu sunt încă disponibile ca instrumente MCP — utilizați direct API-ul REST pentru acestea. În cadrul a ceea ce expune, nu există permisiuni per instrument și nicio setare implicită de tip read-only, deci cheia API reprezintă întregul control al accesului.

- **Endpoint:** `https://mcp.youraiconnector.com/mcp`
- **Autentificare:** cheia ta API <span data-t="appName">DM Champ</span> (trimisă ca header `X-API-Key`)
- **Cerințe:** un abonament cu acces API. [Creează o cheie API →](api-access.md#generating-your-api-key)

> Cheia dvs. API acționează asupra **propriului cont**, cu aceleași permisiuni ca restul API-ului — și poate citi conturile clienților pe care îi gestionați, dacă aveți un plan de agenție (consultați mai jos). Tratați-o ca pe o parolă. O puteți revoca oricând din Setări → Integrări → Cheie API, ceea ce întrerupe instantaneu accesul asistentului.

## Claude Code

```bash
claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"
```

Apoi rulează `/mcp` în interiorul Claude Code pentru a confirma că afișează **dm-champ ✓ conectat**.

În mod implicit, serverul este adăugat la nivelul de domeniu **local** (doar tu, acest proiect).
Folosește `--scope user` pentru a-l face disponibil în toate proiectele tale, sau `--scope
project` to commit it to a repo's `.mcp.json` pentru echipa ta:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

## Claude Desktop

Editează fișierul tău `claude_desktop_config.json` (Setări → Dezvoltator → Editare Configurare) și
adaugă:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

Repornește Claude Desktop. Instrumentele <span data-t="appName">DM Champ</span> vor apărea în meniul de instrumente.

## ChatGPT

Conectorii MCP personalizați sunt disponibili în ChatGPT Business, Enterprise și Pro. Un
proprietar de spațiu de lucru sau un administrator trebuie mai întâi să activeze **developer mode / custom connectors**
în setările spațiului de lucru — fără acest lucru, opțiunea de a crea un conector
nu va apărea niciodată.

Apoi creează conectorul cu:

- **URL:** `https://mcp.youraiconnector.com/mcp`
- **Autentificare:** Headere personalizate
- **Nume header:** `X-API-Key`
- **Valoare header:** cheia ta API <span data-t="appName">DM Champ</span>

URL-ul trebuie să se termine în `/mcp`. Lipirea doar a `https://mcp.youraiconnector.com` este cea mai
comună greșeală — ChatGPT verifică acea adresă exactă, nu găsește nimic acolo și
afișează **"Unable to add connector URL"**.

## Cursor și alți clienți MCP

Majoritatea editorilor compatibili cu MCP folosesc aceeași structură `.mcp.json` prezentată mai sus (un server
HTTP cu un `url` și un header `X-API-Key`). Adaugă un server `dm-champ` care indică
spre `https://mcp.youraiconnector.com/mcp` și lipește cheia ta API în header.

## API-ul Claude (integrează-l în propria ta aplicație)

Poți conecta serverul MCP programatic folosind conectorul MCP al API-ului Claude, astfel încât un agent creat de tine să poată utiliza instrumentele <span data-t="appName">DM Champ</span> fără un client separat:

```json
{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}
```

## Ce poți face

În cadrul părții din API-ul v1 pe care o expune serverul MCP, asistentul alege automat instrumentul potrivit:

- **Campanii:** listează, creează, actualizează, întrerupe/reia, inspectează configurația botului.
- **Contacte:** caută, creează, etichetează, adaugă în liste, importă.
- **Baza de cunoștințe / Întrebări frecvente:** adaugă, editează, importă în masă, aprobă sugestiile AI.
- **Mesaje:** citește conversații, trimite un mesaj către un contact.
- **Programări:** listează, rezervă, anulează.
- **Sarcini:** creează, finalizează, listează.
- **Analize:** statistici mesaje, utilizare credite, cost AI.
- **Canale:** verifică starea conexiunii, inițiază un flux de conectare.

## Întrebări despre conturile clienților dvs. (agenții)

O singură conexiune acoperă fiecare cont pe care îl gestionați. Nu adăugați o a doua conexiune per client: pe un plan de agenție, asistentul poate citi orice cont de client aflat sub administrarea dvs., astfel încât puteți întreba despre toate acestea într-o singură conversație.

Doar menționați numele clientului:

- „Câte contacte are Bella's Bistro?”
- „Cât a costat AI-ul pentru fiecare dintre clienții mei săptămâna aceasta?”
- „Ce campanii sunt active pentru Northside Dental și care este starea canalelor lor?”

Aceasta acoperă citirea contactelor, mesajelor, chat-urilor, campaniilor, programărilor, sarcinilor, etichetelor, evenimentelor, întrebărilor frecvente (FAQ), surselor bazei de cunoștințe, numerelor de telefon, canalelor, webhook-urilor și analizelor. Verificăm dacă contul este într-adevăr al dvs. înainte ca orice să ruleze — solicitarea unuia care nu este al dvs. va returna „nu a fost găsit”. Omiteți clientul și asistentul va citi propriul dvs. cont, exact ca înainte.

**Modificarea contului unui client** este mai limitată. Configurarea agenților AI, a funcțiilor personalizate, a șabloanelor WhatsApp, a punctelor de intrare, a conexiunilor de canal, a stării campaniei și achiziționarea unui număr funcționează toate pentru un client numit; majoritatea celorlalte acțiuni de scriere rulează în continuare pe propriul tău cont, așa că efectuează-le folosind cheia acelui client sau prin [REST API](../agency/api-for-agencies.md), care acoperă mai multe aspecte.

Acesta este, de asemenea, răspunsul pentru un client care gestionează **mai multe afaceri sub o singură autentificare**. Oferiți fiecărei afaceri propriul cont, apoi invitați adresa de e-mail a clientului ca membru al echipei pe toate acestea: se autentifică o singură dată și comută între brandurile lor folosind selectorul de cont din bara laterală.

## Oferirea documentației de ajutor asistentului tău

Serverul MCP oferă asistentului **contul** tău; nu îi oferă această documentație. Dacă dorești, de asemenea, ca acesta să răspundă corect la întrebări de tipul „cum fac…”, îndreaptă-l către `https://docs.dmchamp.com/llms.txt` (un index al fiecărei pagini de ajutor cu un link către versiunea Markdown a fiecărei pagini) sau către `https://docs.dmchamp.com/llms-full.txt` (întreaga documentație într-un singur fișier Markdown). Ambele sunt publice, nu necesită cheie și sunt reconstruite la fiecare modificare a documentației. Consultă [Citirea acestor documente ca Markdown](../api/getting-started.md#reading-these-docs-as-markdown).

## Găsirea sau generarea cheii tale API

Cheia API pe care o folosește această conexiune se află în **Setări → Integrări → Cheie API** — o secțiune proprie, separată de Webhooks. Consultă [Acces API](api-access.md#generating-your-api-key) pentru pașii exacți.

## Depanare

- **"Unable to add connector URL" (ChatGPT) / "connection refused"** — adresei îi lipsește `/mcp` la final. Folosiți
  `https://mcp.youraiconnector.com/mcp`, nu `https://mcp.youraiconnector.com`.
- **`Needs authentication` / 401** — cheia dvs. API lipsește sau este incorectă. Adăugați din nou
  serverul cu un `X-API-Key` valid.
- **Un instrument returnează `403`** — planul sau rolul dvs. în echipă nu permite acea acțiune;
  serverul MCP nu impune nimic suplimentar, este aceeași verificare a permisiunilor ca în
  API.
- **Instrument negăsit** — lista de instrumente este generată în timp real din API, deci
  corespunde întotdeauna versiunii curente; reconectați-vă pentru a reîmprospăta.
- **O avertizare de securitate sau de certificat pe propriul domeniu** — indicarea unei înregistrări DNS
  către noi nu este suficientă de la sine: subdomeniul trebuie, de asemenea, să fie verificat
  în tabloul de bord înainte de a putea oferi o conexiune securizată. Agențiile de tip white-label pot plasa adresa MCP pe propriul domeniu (de ex.
  `mcp.youragency.com`) din cardul **Domeniu personalizat** sub **Setări →
  White Labeling** — adăugați mai întâi CNAME la registratorul dvs., apoi introduceți
  numele de gazdă în blocul **Domeniu MCP (asistenți AI)** și faceți clic pe **Verificare**,
  același flux ca și pentru celelalte subdomenii de marcă. Până la verificare, utilizați adresa standard de mai sus — aceasta nu este marcată, deci este sigură pentru a fi partajată cu clienții.

---

## Pașii următori

- [Acces API](api-access.md) — generează sau rotește cheia pe care o folosește această conexiune.
- [Webhooks](webhooks.md) — echivalentul bazat pe push al acestei conexiuni MCP bazate pe pull.