Conectarea asistenților AI (MCP)
DM Champ livrează un server MCP oficial — un endpoint Model Context Protocol care permite asistenților AI precum Claude (pe claude.ai și în Claude Desktop), ChatGPT, Claude Code, Cursor și propriilor tale aplicații să controleze direct contul tău DM Champ. Întreabă în limbaj natural (“listează-mi agenții AI”, “adaugă acest lead”, “cât m-a costat AI-ul săptămâna aceasta?”) iar asistentul apelează API-ul DM Champ pentru tine.
Este același API v1 pe care îl accesezi cu o cheie API: te conectezi prin autentificarea în contul tău și apăsarea butonului Allow (Permite), sau cu propria cheie API. Serverul MCP construiește un instrument pentru fiecare operațiune din specificația API publicată, deci acoperă majoritatea, dar nu tot API-ul v1: contacte, mesaje, campanii, agenți AI, funcții personalizate, bază de cunoștințe, programări, analize, etichete, liste, difuzări, tranzacții, conexiuni de canal, sub-conturi și automatizări. O automatizare creată de asistent apare dezactivată ca schiță și devine activă doar când este activată ca pas separat (vezi API-ul de Automatizări). În cadrul a ceea ce expune, nu există permisiuni per instrument și nicio setare implicită de tip read-only, deci autentificarea (sau cheia API) reprezintă controlul total al accesului.
- Endpoint:
https://mcp.youraiconnector.com/mcp - Autentificare: autentifică-te cu contul tău DM Champ sau folosește cheia API ca header
X-API-Key - Cerințe: un plan cu acces API. Creează o cheie API →
Pe DM Champ poți folosi https://mcp.youraiconnector.com/mcp în schimb: același cont, aceeași autentificare, aceeași cheie. La acea adresă, documentația de ajutor încorporată a asistentului include și ghidurile de facturare și agenție, precum și documentația LinkedIn.
O conexiune acționează asupra propriului tău cont, cu aceleași permisiuni ca și cheia ta API — și poate citi conturile clienților pe care îi gestionezi, dacă ai un plan de agenție (vezi mai jos). Tratează cheia API ca pe o parolă. Fiecare conexiune, autentificată sau prin cheie, este listată în Settings → Integrations → API Key, iar revocarea acesteia de acolo întrerupe accesul asistentului.
Claude Code
Calea rapidă: plugin-ul DM Champ
Plugin-ul configurează conexiunea și adaugă o abilitate, un manual pe care Claude îl citește mai întâi: cum este structurat DM Champ, fluxurile de lucru comune pas cu pas și ce trebuie să vă întrebe înainte de a acționa (orice trimite mesaje persoanelor reale, nu poate fi anulat sau consumă credite).
claude plugin marketplace add dm-champ/claude-plugin
claude plugin install dm-champ@dm-champ
Apoi pornește claude, rulează /plugin configure dm-champ@dm-champ și lipește cheia ta API. Aceasta este stocată în portcheiul sistemului tău, nu într-un fișier. Repornește Claude Code, rulează /mcp pentru a vedea serverul conectat și pune întrebări.
Pluginul funcționează în aplicația de terminal Claude Code. Pentru a-l elimina: claude plugin uninstall dm-champ@dm-champ.
Fără plugin
claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \
--header "X-API-Key: YOUR_API_KEY"
Apoi rulați /mcp în Claude Code pentru a confirma că afișează ai-connector ✓ connected.
Î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": {
"ai-connector": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
Claude (claude.ai și Claude Desktop)
Adaugă serverul ca un conector personalizat și autentifică-te cu contul tău DM Champ. Acest lucru funcționează pe site-ul claude.ai și în aplicația Claude Desktop (conturile Claude gratuite pot adăuga un conector personalizat).
- Deschide Customize → Connectors, dă clic pe + Add, apoi pe Add custom connector.
- Dă-i un nume, introdu
https://mcp.youraiconnector.com/mcpca URL și dă clic pe Continue. - Lasă Authentication pe Sign in now sau alege Sign in when needed, și dă clic pe Add.
- Dă clic pe Connect lângă noul conector. Pagina ta de autentificare DM Champ se deschide: autentifică-te dacă nu ești deja conectat.
- Vei vedea Claude wants to connect to your account. Dă clic pe Allow și vei fi trimis înapoi la Claude. Instrumentele DM Champ apar în meniul de instrumente al unei conversații noi.
Conexiunea poate face tot ce poate face cheia ta API, inclusiv accesarea conturilor clienților pe care îi gestionezi într-un plan de agenție; nu există permisiuni per instrument. Aceasta apare sub Settings → Integrations → API Key ca o cheie numită Claude (signed in), iar fiecare autentificare adaugă propria intrare. Revocă acea cheie pentru a deconecta Claude: acesta își pierde accesul la următoarea cerere. Eliminarea conectorului în Claude lasă cheia în acea listă, deci revoc-o și de acolo.
Doar proprietarul contului poate permite conexiunea: unui membru al echipei sau unei agenții care lucrează în contul unui client i se va cere să se autentifice ca proprietar. Contul trebuie să aibă un plan cu acces API.
Claude Desktop cu cheia ta API în schimb
Claude Desktop se poate conecta și cu cheia ta API într-un header de cerere, fără a te autentifica:
- Deschide Customize → Connectors, dă clic pe + Add, apoi pe Add custom connector.
- Dă-i un nume și introdu
https://mcp.youraiconnector.com/mcpca URL. - Sub Authentication, alege No sign-in.
- Sub Request headers, adaugă un header numit
X-API-Keycu cheia ta API ca valoare. - Dă clic pe Add.
Site-ul claude.ai nu are un câmp Request headers, deci pe site folosește pașii de autentificare de mai sus.
Nu există câmpul Request headers? Versiunea dvs. Claude Desktop este mai veche: actualizați-o sau folosiți fișierul de configurare. Fișierul de configurare (claude_desktop_config.json, Settings → Developer → Edit Config) rulează programe doar pe computerul dvs. și ignoră o intrare url, deci are nevoie de micul bridge mcp-remote, care necesită Node.js 18 sau mai nou:
{
"mcpServers": {
"ai-connector": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.youraiconnector.com/mcp",
"--header",
"X-API-Key:${AI_CONNECTOR_KEY}"
],
"env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
}
}
}
Păstrați X-API-Key:${AI_CONNECTOR_KEY} exact așa cum este scris, fără spațiu după două puncte (pe Windows, un spațiu separă antetul) și introduceți cheia doar în env. Apoi închideți complet Claude Desktop (pe Windows, faceți clic dreapta pe pictograma din bara de activități → Quit) și deschideți-l din nou.
ChatGPT
ChatGPT se conectează în același mod, prin autentificare:
- În setările conectorului din ChatGPT, creați un conector personalizat cu
https://mcp.youraiconnector.com/mcpca URL și OAuth ca metodă de autentificare. - Când ChatGPT se conectează, se deschide o fereastră cu pagina dvs. de autentificare DM Champ: conectați-vă dacă nu sunteți deja autentificat.
- Veți vedea ChatGPT dorește să se conecteze la contul dvs. Faceți clic pe Permiteți și veți fi redirecționat înapoi la ChatGPT.
La fel ca în cazul Claude, conexiunea are accesul cheii dvs. API, apare sub Setări → Integrări → Cheie API ca o cheie numită după aplicație și este deconectată prin revocarea acelei chei. Doar proprietarul contului o poate permite, iar contul are nevoie de un abonament cu acces API.
Cursor și alți clienți MCP
Cursor și majoritatea celorlalte editoare compatibile cu MCP continuă să utilizeze cheia dvs. API, cu aceeași formă .mcp.json prezentată mai sus (un server HTTP
cu un url și un antet X-API-Key). Adăugați un server ai-connector care indică
spre https://mcp.youraiconnector.com/mcp și lipiți cheia API în antet.
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 AI agents" }],
"mcp_servers": [
{
"type": "url",
"name": "ai-connector",
"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:
- Agenți AI: listare, creare, actualizare, pauză/reluare, inspectare configurație.
- Contacte: căutare, creare, etichetare, adăugare în liste, importare.
- Bază de cunoștințe / Întrebări frecvente: adăugare, editare, importare în masă, aprobarea sugestiilor AI.
- Mesaje: citirea conversațiilor, trimiterea unui mesaj către un contact.
- Programări: listare, rezervare, anulare.
- Sarcini: creare, finalizare, listare.
- Analize: statistici mesaje, utilizarea creditelor, cost AI.
- Canale: verificarea stării conexiunii, inițierea unui 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?”
- “Care este starea canalelor Northside Dental și câte conversații au avut loc săptămâna aceasta?”
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 funcționează în același mod. Fiecare acțiune care acceptă un cont de client în API este disponibilă pentru un client desemnat: configurarea agenților AI, a bazei de cunoștințe, a funcțiilor personalizate, a șabloanelor WhatsApp, a punctelor de intrare, a conexiunilor de canal, a contactelor, a etichetelor, a transmisiunilor, a programărilor, a ofertelor și sarcinilor, precum și trimiterea de mesaje. Excepțiile sunt acțiunile la nivel de agenție, care rulează întotdeauna pe propriul cont de agenție: gestionarea conturilor clienților (limite, funcționalități, prețuri, suspendare), snapshot-uri, echipa ta și cheile API. Adăugarea sau eliminarea contactelor din lista unui client nu este încă disponibilă pentru un client desemnat; fă acest lucru folosind cheia propriului client sau direct din contul acestuia. Ghidul API pentru agenții enumeră funcționalitățile suportate.
Instrumentele de agenție se află doar la adresa standard, fără branding, https://mcp.youraiconnector.com/mcp. O adresă MCP de tip white label pe propriul tău domeniu (mcp.youragency.com) este creată pentru clienții tăi și nu le include pe acestea, așa că folosește adresa standard, fără branding, atunci când gestionezi conturile clienților.
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ă.
Testarea agentului unui client
Solicită asistentului să testeze agentul unui client („trimite ‘faceți livrări duminica?’ către agentul de panificație al clientului X și arată-mi ce a făcut”). Acesta trimite un mesaj de testare (Try Out) cu cheia ta de agenție și sub_account_id clientului, așteaptă și citește răspunsul, plus orice acțiuni întreprinse de agent. Nu este necesară nicio copie a agentului. Dacă asistentul spune că nu ai un cont de agenție, înseamnă că este conectat cu cheia unui client: reconectează-l cu cheia contului tău de agenție. Vezi Try Out.
Clienți cu o limită de instrumente
Unii clienți AI acceptă doar un server cu un număr limitat de instrumente. Composio, de exemplu, refuză un server care listează mai mult de 500 de instrumente și nu importă niciunul dintre ele. Conexiunea completă a agenției listează mai multe de atât, așa că adăugați ?tags= la adresă doar cu grupurile de instrumente de care aveți nevoie.
Pentru o agenție care dorește să își listeze conturile clienților, să le citească contactele, chaturile și mesajele și să trimită mesaje:
https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages
Aceasta încarcă aproximativ 80 de instrumente. Specificați clientul în cererea dvs., iar asistentul va acționa asupra contului acelui client, așa cum este descris mai sus.
- Separați grupurile prin virgule; atât literele mari, cât și cele mici funcționează.
- Pentru a adăuga instrumente individuale, listați numele lor exacte cu
tools=, de exemplu?tags=Contacts&tools=list_or_get_subaccounts. Veți obține fiecare instrument din oricare listă. - Instrumentele din documentația de ajutor sunt întotdeauna incluse.
- Cheia API se introduce în continuare în antetul
X-API-Key(sauAuthorization: Bearer YOUR_API_KEY), niciodată în adresă.
Documentația de ajutor este integrată
Serverul MCP oferă asistentului contul dumneavoastră și această documentație. Trei instrumente citesc documentația de ajutor în timp real, astfel încât asistentul să poată căuta cum funcționează o funcționalitate sau ce s-a schimbat recent, în loc să ghicească:
docs_search: găsește secțiunile care răspund la o întrebare și le returnează împreună cu link-ul paginii.docs_read: citește o pagină complet sau o secțiune a acesteia.docs_list: listează fiecare pagină pe domenii.
Nu este nimic de configurat, iar instrumentele de documentație nu accesează niciodată datele contului dumneavoastră. Întrebați „cum funcționează punctele de intrare?” sau „ce este nou în automatizări?” și asistentul va căuta mai întâi în documentație. Deoarece instrumentele citesc chiar site-ul de ajutor, o funcționalitate este cunoscută de asistentul dumneavoastră imediat ce ghidul acesteia este publicat.
Un asistent care nu este conectat prin MCP poate citi în continuare documentația: direcționați-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 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.
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
- “Connection refused” sau “not found” — adresei îi lipsește
/mcpla final. Foloseștehttps://mcp.youraiconnector.com/mcp, nuhttps://mcp.youraiconnector.com. Needs authentication/ 401 — cheia ta API lipsește sau este greșită, ori cheia creată la autentificare a fost revocată. Adaugă din nou serverul cu unX-API-Keyvalid sau autentifică-te din nou.- “Your plan does not include API access, which connecting an AI app needs” — conectarea necesită un abonament cu acces API, la fel ca o cheie API. Actualizează abonamentul, apoi începe din nou conectarea din aplicația ta AI.
- “Only the account owner can connect an AI app” — ești conectat ca membru al echipei sau lucrezi în contul unui client din partea agenției tale. Conectează-te cu datele proprietarului contului și începe din nou conectarea.
- “This link no longer works” — pagina de autentificare a expirat (rămâne validă timp de 10 minute) sau a fost deja utilizată. Începe din nou conectarea din aplicația ta AI.
- “Connection issue” imediat după adăugarea conectorului pe claude.ai — pagina de autentificare nu s-a deschis (de exemplu, din cauza unui pop-up blocat). Dă clic pe Reconnect pe acea pagină și se va deschide autentificarea.
- “Add anyway” și apoi o conectare eșuată pe claude.ai — conectorul a fost adăugat cu No sign-in, iar site-ul nu poate trimite cheia ta API. Elimină-l și adaugă-l din nou cu Sign in now, așa cum este descris în Claude.
- Pentru a deconecta Claude, ChatGPT sau altă aplicație conectată — revocă cheia numită după aplicație (de exemplu Claude (signed in)) în Settings → Integrations → API Key. Aplicația își pierde accesul la următoarea cerere.
- Claude Desktop nu afișează instrumente după editarea fișierului de configurare — fișierul de configurare ignoră o intrare
"url"; folosește conectorul personalizat sau formularulmcp-remoteîn Claude, apoi închide complet și redeschide aplicația. - Un instrument returnează
403— abonamentul sau rolul tău în echipă nu permite acea acțiune; serverul MCP nu impune nicio restricție suplimentară, este aceeași verificare a permisiunilor ca la API. - Tool not found — lista de instrumente este generată în timp real din API, deci corespunde întotdeauna versiunii curente; reconectează-te pentru a reîmprospăta.
- O avertizare de securitate sau de certificat pe propriul tău domeniu — direcționarea 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 care folosesc white label pot pune adresa MCP pe propriul domeniu (de ex.
mcp.youragency.com) din cardul Custom domain sub Settings → White Labeling — adaugă mai întâi CNAME la registrarul tău, apoi introdu numele de gazdă în blocul MCP domain (AI assistants) și dă clic pe Verify, același flux ca pentru celelalte subdomenii marcate. Adresa marcată omite instrumentele agenției; continuă să folosești adresa standard, nemarcată, pentru acestea. Până când adresa ta marcată este verificată, folosește adresa standard, nemarcată: este sigur să o partajezi cu clienții.