Conectarea asistenților AI (MCP)

DM Champ 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 DM Champ. Î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 DM Champ pentru tine.

Este același API v1 documentat în secțiunea API, 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 DM Champ (trimisă ca header X-API-Key)
Cerințe: un abonament cu acces API. Creează o cheie API →

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

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:

{
  "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ă:

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

Repornește Claude Desktop. Instrumentele DM Champ 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 DM Champ

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 DM Champ fără un client separat:

{
  "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, 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.youraiconnector.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.youraiconnector.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.

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 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 — generează sau rotește cheia pe care o folosește această conexiune.
Webhooks — echivalentul bazat pe push al acestei conexiuni MCP bazate pe pull.

Conectarea asistenților AI (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor și alți clienți MCP #

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

Ce poți face #

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

Oferirea documentației de ajutor asistentului tău #

Găsirea sau generarea cheii tale API #

Depanare #

Pașii următori #