Conectarea asistenților AI (MCP) #

Your AI Connector livrează un server MCP oficial — un endpoint Model Context Protocol care permite asistenților AI precum Claude Code, Claude Desktop, Cursor și propriilor tale aplicații să controleze direct contul tău Your AI Connector. Î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 va apela API-ul Your AI Connector pentru tine.

Este același API v1 pe care îl accesați cu o cheie API, autentificat cu propria cheie API. Serverul MCP construiește un instrument pentru fiecare operațiune din specificația noastră API publicată, deci acoperă cea mai mare parte, dar nu tot API-ul v1: contacte, mesaje, campanii, agenți AI, funcții personalizate, bază de cunoștințe, programări, analiză, etichete, liste, difuzări, oferte, conexiuni de canal și sub-conturi. Automatizările pot fi listate și citite, dar nu pot fi încă create sau editate prin MCP; creați-le în aplicație. Î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 dvs. API Your AI Connector (trimisă ca antet X-API-Key)
• Necesită: un abonament cu acces API. Creați 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 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 Desktop #

Adăugați serverul ca un conector personalizat. Acesta este configurat în contul dvs. Claude, deci funcționează atât în Claude Desktop, cât și pe claude.ai (conturile Claude gratuite pot adăuga un singur conector personalizat).

1. Deschideți Customize → Connectors, faceți clic pe + Add, apoi pe Add custom connector.
2. Dați-i un nume și introduceți https://mcp.youraiconnector.com/mcp ca URL.
3. La Authentication, alegeți No sign in. Serverul MCP nu are o pagină de conectare: alegerea unei opțiuni de conectare va duce la eroarea “Couldn’t register with … sign-in service”.
4. La Request headers, adăugați un antet numit X-API-Key cu cheia dvs. API drept valoare.
5. Faceți clic pe Add. Instrumentele Your AI Connector vor apărea în meniul de instrumente al unei conversații noi.

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 nu se poate conecta la serverul MCP în acest moment. Formularul său de conector personalizat oferă doar OAuth sau Fără autentificare, iar serverul MCP Your AI Connector se autentifică cu cheia ta API, trimisă ca antet de cerere. Alegerea OAuth eșuează cu eroarea “could not discover OAuth settings”, iar Fără autentificare este refuzată deoarece fiecare cerere necesită cheia.

Folosește un asistent care îți permite să setezi un antet de cerere în schimb: Claude Code, Claude Desktop, Cursor sau un alt client MCP, sau API-ul Claude.

ChatGPT poate citi în continuare documentația de ajutor fără o conexiune: vezi Documentația de ajutor este integrată pentru fișierele publice llms.txt.

Cursor și alți clienți MCP #

Majoritatea editorilor capabili de MCP folosesc 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 Your AI Connector 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.

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 #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

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.youraiconnector.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.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.

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 /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.
• “Could not discover OAuth settings” (ChatGPT) — ChatGPT acceptă doar OAuth sau nicio autentificare pentru conectorii personalizați, iar serverul MCP folosește o cheie API, deci ChatGPT nu se poate conecta momentan. Consultați ChatGPT.
• “Couldn’t register with … sign-in service” sau “add an OAuth Client ID” (Claude Desktop) — conectorul personalizat a fost adăugat cu o opțiune de conectare. Nu există niciun ID de client OAuth de introdus: eliminați conectorul și adăugați-l din nou cu Authentication → No sign in și cheia dvs. API ca antet de cerere X-API-Key, așa cum este descris în Claude Desktop.
• Claude Desktop nu afișează instrumente după editarea fișierului de configurare — fișierul de configurare ignoră o intrare "url"; folosiți conectorul personalizat sau formularul mcp-remote din Claude Desktop și închideți complet și redeschideți aplicația.
• 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 la 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.
• Un avertisment de securitate sau certificat pe propriul 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 de tip white-label pot pune adresa MCP pe propriul domeniu (de ex. mcp.youragency.com) din cardul Custom domain sub Settings → White Labeling — adăugați mai întâi CNAME-ul la registratorul dvs., apoi introduceți numele de gazdă în blocul MCP domain (AI assistants) și faceți clic pe Verify, același flux ca pentru celelalte subdomenii de marcă. Adresa de marcă omite instrumentele agenției; continuați să folosiți adresa standard, fără marcă, pentru acestea. Până când adresa dvs. de marcă este verificată, folosiți adresa standard, fără marcă: 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.