Conectori Claude: creează-ți propriul conector fără cod

Piotr Grudzień
Publicat 18 min de lectură
O întrebare în Claude conectată la Fernhill Help și politica de retur, cu acces privat în mod implicit

Conectorii Claude îi permit lui Claude să folosească instrumente și informații din afara conversației. În acest tutorial vei crea un conector personalizat care răspunde pe baza propriului centru de ajutor, fără să scrii cod sau să găzduiești singur un server MCP.

Exemplul este Fernhill Outdoor, un comerciant fictiv de echipamente pentru activități în aer liber. Un coleg îl întreabă pe Claude dacă poate returna o jachetă nepurtată, cumpărată acum 45 de zile. Claude poate cere politica de la Fernhill Help, Agentul tău Quickchat AI. Un răspuns util trebuie să păstreze trei detalii: intervalul de 60 de zile, condiția etichetelor originale și termenul de rambursare calculat de la primirea produsului.

Diagramă a unei întrebări despre returnarea unei jachete în Claude, a Knowledge Base pentru Fernhill Help și a celor trei condiții pe care răspunsul trebuie să le păstreze Rezultatul pe care îl vei construi. Diagrama arată răspunsul așteptat conform politicii; testele de mai jos verifică dacă Agentul și Claude îl păstrează efectiv.

Vei întreba și ceva ce centrul de ajutor nu precizează: livrarea în Elveția. Iată rezultatul real din Claude după conectarea Fernhill Help:

Claude folosește Ask Fernhill Help și explică faptul că centrul de ajutor nu confirmă livrarea în Elveția Conectorul în utilizare. Claude distinge între o destinație nedocumentată și o interdicție de livrare și îndrumă cititorul către asistența Fernhill.

La final vei avea un conector privat și o metodă repetabilă de a compara ce l-ai întrebat pe Claude, ce l-a întrebat Claude pe Agent și ce răspuns a primit. Această comparație contează: testul nostru de retur a detectat și o condiție pe care Claude a adăugat-o când a reformulat răspunsul Agentului.

Descarcă kitul conectorului Fernhill pentru conținutul exact al cunoștințelor, Main Prompt, descrierea MCP, întrebările de test, criteriile de evaluare, rezultatele înregistrate și o fișă goală pentru dovezi. Acestea sunt fișiere de referință editabile, nu un import cu un singur clic.

Capturile de ecran, interfața și materialele demonstrative pe care le poți copia sunt în engleză, ca să poți reproduce rularea înregistrată.

Ce sunt conectorii Claude și de care ai nevoie?

Un conector Claude personalizat este o conexiune la un server MCP la distanță, pe care o adaugi prin URL. MCP, Model Context Protocol, îi permite lui Claude să descopere instrumentele serverului și să le apeleze. Aici, Quickchat AI găzduiește serverul și expune instrumentul Agentului tău pentru răspunsuri la întrebări.

Claude Connectors Directory enumeră servicii pe care le poți conecta direct. Un conector personalizat folosește URL-ul de server pe care îl furnizezi. Adăugarea sa nu îl trimite în Directory și nu îl face să apară ca Suggested Connector.

Pentru această configurație, două conexiuni au roluri diferite:

Obiectivul tăuConexiunea de folositCe pune la dispoziție
Să pui întrebări din centrul de ajutor FernhillUn conector personalizat cu URL-ul Agentului Fernhill HelpUn singur instrument, ask_fernhill, care îi adresează acestui Agent o întrebare
Să creezi Agenți, să editezi cunoștințe sau să verifici conversații din ClaudeConectorul Quickchat AI din Directory al lui ClaudeInstrumente de administrare a contului, conform permisiunilor tale Quickchat AI

Diagramă care separă conectorul personalizat pentru întrebări către Fernhill Help de conectorul Quickchat AI din Directory pentru administrarea contului Construiește mai întâi conexiunea de sus. Opțiunea de administrare a contului apare mai târziu în acest ghid.

Conectorul MCP din Messages API al Anthropic este o funcție separată pentru dezvoltatori. Nu ai nevoie de o cheie API sau de o integrare API pentru acest tutorial. Pentru protocolul de bază, vezi explicația MCP.

De ce ai nevoie pentru a crea un conector Claude personalizat?

Ai nevoie de un cont Claude și de un Agent Quickchat AI pe care îl poți configura. Prima configurație folosește un singur Agent și păstrează accesul privat.

  1. Creează un cont Quickchat AI, finalizează verificarea adresei de e-mail dacă este cerută și folosește configurarea manuală de mai jos. MCP este inclus în planul Free actual. Răspunsurile generate și Simulations consumă credite AI; verifică alocarea și condițiile de utilizare comercială pe pagina de prețuri.
  2. Conectează-te la Claude pe web sau în aplicația desktop. Claude Free permite un singur conector personalizat; Pro, Max, Team și Enterprise acceptă, de asemenea, conectori personalizați. Dacă locul din Free este deja ocupat, decide dacă înlocuiești acel conector înainte de a continua. În Team sau Enterprise, folosește procedura pentru spațiul de lucru.
  3. Folosește materialele fictive de mai jos pentru prima rulare. Nu necesită date despre clienți, un sistem de comenzi sau un API de rambursare. Lasă Actions și transferul conversației dezactivate, astfel încât rolul Agentului să rămână limitat la explicarea politicilor.

Instrucțiunile Claude pentru conectori personalizați descriu cerințele privind planurile și rolurile. Tutorialul de mai jos arată ecranele de configurare din conexiunea noastră reală.

Traseul prin tutorial este crearea Agentului, testarea răspunsurilor, activarea MCP, apoi conectarea și compararea ambelor conversații.

Pasul 1: Cum creezi Agentul bazat pe cunoștințe?

Creează Fernhill Help cu un singur articol din centrul de ajutor și un Main Prompt care îi spune cum să trateze informațiile lipsă.

  1. Într-un cont nou, alege Set up manually. Într-un cont existent, selectează mai întâi Add new AI Agent.
  2. În Identity, introdu Fernhill Help în Name your AI Agent. Lipește textul următor în Describe what you want your agent to do, apoi selectează Next. Acesta devine Main Prompt al Agentului.
You answer questions about Fernhill Outdoor from this Agent's Knowledge Base. Give a concise, factual answer. When the Knowledge Base does not contain the answer, say that you cannot confirm it and suggest contacting Fernhill support. Do not invent shipping destinations, prices, order details or refund outcomes. The listed shipping regions do not establish whether other destinations are served. For any destination not explicitly covered by the Knowledge Base, say you cannot confirm shipping there and suggest contacting Fernhill support; do not infer a shipping ban.
  1. Lasă câmpurile pentru site și documente goale în Knowledge Base, apoi selectează Next. Nu selecta opțiuni în External apps și Deployment și alege Next pe fiecare ecran. Alege un plan sau Skip for now pentru a finaliza cu Free. Închide orice ofertă opțională de plan pentru a ajunge la AI Preview.
  2. Deschide Knowledge Base > Add Article. Numește articolul personalizat Fernhill Outdoor help center și selectează Create article.
  3. În Edit Article, lipește această sursă completă în Content și selectează Save:
Fernhill Outdoor help center

This is fictional training data. It contains no real customer information.

Shipping: orders ship within two working days to addresses in the European Union and the United Kingdom. Standard delivery takes three to five working days; express delivery takes one to two working days and costs 12 EUR.
Returns: unused items can be returned within 60 days with the original tags. Refunds are issued to the original payment method within ten working days of receipt.
Sizing: jackets follow the European size chart; when between sizes, choose the larger size for layering.
Warranty: Fernhill repairs manufacturing defects free of charge for two years. Normal wear, UV damage and improper washing are not covered.

Panoul Quickchat AI Edit Article cu textul centrului de ajutor fictiv Fernhill Outdoor în Content Lipește sursa completă în Content. Toate informațiile despre politici din teste provin din acest articol.

  1. Așteaptă până când articolul afișează Ready. Modificările cunoștințelor sunt procesate automat; această configurație nu are un pas separat de publicare.

Rândul Quickchat AI Knowledge Base pentru Fernhill Outdoor help center cu starea Ready Așteaptă Ready înainte de testare. Acesta este articolul real indexat în demonstrația locală.

  1. Revino la Identity și verifică Main Prompt. Folosește Edit dacă diferă de blocul de mai sus.

Editorul Quickchat AI Main Prompt cu instrucțiunile Fernhill și regula explicită împotriva deducerii unei interdicții de livrare Main Prompt final include instrucțiunea privind incertitudinea livrării, elaborată în testele locale de mai jos.

  1. În Actions & MCPs, păstrează Custom Actions gol și lasă Human Handoff și Smart Data Gathering dezactivate.

Cunoștințele conțin faptele; Main Prompt descrie comportamentul răspunsurilor. Intervalul de retur de 60 de zile aparține articolului, unde îl poți întreține alături de restul politicii. O instrucțiune de tipul „fii precis” nu poate furniza o destinație de livrare care lipsește.

Pasul 2: Cum testezi Agentul înainte de a conecta Claude?

Testează mai întâi Agentul separat, astfel încât mai târziu să poți distinge o problemă de cunoștințe de una a conectorului sau a transmiterii răspunsului.

Quickchat AI cu Testing selectat în bara laterală și Fernhill policy checks deschis Testing se află în grupul de navigare Conversations. Deschide setul de date pentru a-i inspecta mesajele și rulările.

  1. Deschide Testing și selectează Create Dataset. Numește-l Fernhill policy checks.
  2. Alege Paste messages și lipește blocul complet de mai jos. Separatorul --- plasează fiecare întrebare într-un test separat, cu un singur schimb de mesaje:
Does Fernhill cover UV damage under warranty?
---
I bought a jacket 45 days ago and never wore it. Can I still return it, and how long does the refund take?
---
Does Fernhill ship to Switzerland?
  1. Selectează Create. În setul de date, extinde Evaluation criteria, lipește conținutul evaluation-criteria.txt din kit și selectează Save. Criteriile verifică condițiile politicilor, destinația lipsă și absența unei afirmații că s-a efectuat o rambursare sau un transfer al conversației.
  2. Selectează Run, apoi Start Run. Așteaptă finalizarea și deschide fiecare rezultat. Citește răspunsul efectiv alături de sursă, chiar dacă evaluatorul îi acordă un scor mare.

Setul de date Fernhill policy checks cu cele trei mesaje de test separate în Quickchat AI Fiecare întrebare este un caz separat. Liniile separatoare din blocul de copiat împiedică transformarea lor într-o singură întrebare combinată. Rezultatele Quickchat AI Testing pentru Complete policy reference cu trei cazuri finalizate și un scor AI de 5,0 din 5 Rularea locală finală cu Main Prompt revizuit și criterii de referință complete. Citește răspunsurile individuale, nu doar scorul.

TestCe trebuie să păstreze un răspuns acceptabilUn rezultat de investigat
Deteriorare cauzată de UVDeteriorarea cauzată de UV este exclusă din garanțieTratarea tuturor deteriorărilor ca defecte de fabricație acoperite
Jachetă cumpărată acum 45 de zileÎn 60 de zile; nefolosită; etichete originale obligatorii; rambursare în zece zile lucrătoare de la primire, prin metoda de plată inițialăUn „da” necondiționat, un termen de rambursare care începe astăzi sau o afirmație că returul a fost depus
ElvețiaSursa nu confirmă această destinație; contactează asistența FernhillTermene de livrare inventate, taxe, un da categoric sau o interdicție categorică de livrare

Conversație Quickchat AI în care Fernhill Help explică faptul că deteriorarea cauzată de UV este exclusă din garanție Testul local de garanție este o căutare directă. Următorul caz testează o altă abilitate: păstrarea incertitudinii atunci când sursa este incompletă.

Cazul Elveției este intenționat mai specific decât „nu inventa”. Sursa numește UE și Regatul Unit, dar nu spune că acestea sunt singurele destinații. Comportamentul corect este să păstreze această incertitudine.

Ce a greșit primul test local?

Prima noastră rulare locală a răspuns corect la întrebările despre garanție și retur, dar răspunsul despre Elveția a dedus o regulă pe care sursa nu o preciza:

Elveția nu este listată, deci, conform informațiilor disponibile, nu livrează acolo.

Conversație Quickchat AI în care Fernhill Help concluzionează incorect că nu livrează în Elveția deoarece Elveția nu este listată Înainte de schimbarea promptului: un răspuns real din Simulation locală a dedus o interdicție de livrare dintr-o listă incompletă.

Main Prompt inițial îi spunea deja Agentului să nu inventeze destinații de livrare. Această regulă generală nu l-a împiedicat să trateze cele două regiuni numite drept o listă exhaustivă. Am păstrat Knowledge Base neschimbată și am adăugat această instrucțiune în Main Prompt:

The listed shipping regions do not establish whether other destinations are served. For any destination not explicitly covered by the Knowledge Base, say you cannot confirm shipping there and suggest contacting Fernhill support; do not infer a shipping ban.

Main Prompt complet din pasul 1 și din descărcare include acest adaos. Păstrează aceeași întrebare de test când schimbi un prompt, ca să poți compara efectul real.

Următoarea rulare locală Testing a răspuns la toate cele trei întrebări în concordanță cu sursa. Răspunsul despre Elveția a spus că nu poate confirma livrarea acolo și a sugerat contactarea asistenței Fernhill.

Conversație Quickchat AI în care Fernhill Help spune că nu poate confirma livrarea în Elveția și sugerează contactarea asistenței După schimbarea promptului: Simulation locală finală păstrează informația lipsă ca incertitudine. Acesta este un test al Agentului, nu o transcriere Claude.

Acea rulare a primit un scor de 4,7/5 de la evaluator, deși răspunsurile corespundeau centrului de ajutor. Evaluatorul a penalizat detalii de garanție prezente în articol, dar absente din criteriile de evaluare. Am adăugat faptele de referință complete în criterii, păstrând neschimbate verificările așteptate. Criteriile descărcabile includ această corecție. Scorul este util pentru a găsi răspunsuri de inspectat; sursa și răspunsul efectiv stabilesc dacă răspunsul este corect.

Explicația evaluatorului Quickchat AI numește incorect detalii documentate ale garanției drept inventate deoarece criteriile nu conțineau acele fapte de referință Explicația evaluatorului anterior. Perioada de doi ani, defectele de fabricație și excluderea deteriorării prin spălare erau deja în sursă; criteriile aveau nevoie de aceleași fapte.

Rularea locală finală a completat toate cele trei cazuri cu un scor de 5,0/5, iar răspunsurile încă se potriveau sursei la citirea manuală. Acestea sunt trei cazuri observate pe această configurație, nu o garanție pentru orice întrebare sau pentru reformularea ulterioară a lui Claude.

Pasul 3: Cum transformi Agentul într-un conector?

Activează serverul MCP găzduit al Agentului, oferă instrumentului o descriere precisă și păstrează cerința de autentificare activată.

  1. Deschide External Apps, selectează MCP și activează Enable MCP.
  2. În Settings din panou, lasă Require sign-in (private) activat. Acest comutator controlează accesul; este separat de descrierea pe care o scrii pentru Claude.

Setările MCP din Quickchat AI cu Enable MCP și Require sign-in private activate Păstrează ambele comutatoare activate pentru prima configurație. Setarea privată controlează accesul independent de descrierea instrumentului.

  1. Selectează Configure MCP și setează următoarele:
CâmpValoare
NameFernhill Help
Commandask_fernhill
DescriptionBlocul complet de mai jos
Answers questions about Fernhill Outdoor shipping, returns, sizing and warranty from its help center. Use this tool for Fernhill policy questions. If a fact is missing, it says it cannot confirm it and suggests contacting Fernhill support. It cannot look up orders, submit returns or issue refunds.

Dialogul Configure MCP cu Fernhill Help, descrierea pentru răspunsuri despre politici și comanda ask_fernhill Acestea sunt detaliile reale ale instrumentului pe care Claude le va descoperi. Descriu numai capacități prezente în acest Agent.

Descrierea îi oferă lui Claude un motiv să aleagă acest instrument și îi definește domeniul. „Răspunde la întrebări despre politicile Fernhill” este mai util decât „asistent de ajutor”. Precizarea limitelor evită și sugerarea unor capacități pe care nu le-ai construit: acest Agent nu are Action pentru căutarea comenzilor, depunerea retururilor, rambursare sau transferul conversației.

  1. Selectează Done, apoi Connect MCP. Copiază URL-ul propriului Agent. Are această formă:
https://app.quickchat.ai/mcp/YOUR_AGENT_ID

Dialogul Connect MCP cu URL-ul demonstrației locale Fernhill în formatul găzduit app.quickchat.ai și un buton Copy Copiază propriul URL din acest dialog. Identificatorul din imagine aparține demonstrației locale și nu este un conector găzduit de instalat.

Folosește exact URL-ul din dialog. Textul YOUR_AGENT_ID de mai sus este un substituent. Documentația canalului MCP explică controlul privat/public și URL-ul găzduit.

Pasul 4: Cum adaugi un conector personalizat în Claude?

Adaugă URL-ul găzduit al Agentului în Claude, apoi autentifică-te cu un cont Quickchat AI care are acces la Fernhill Help.

  1. Deschide Settings în Claude. În Customize, selectează Connectors.
  2. Selectează + Add > Add custom connector.

Setările Claude Connectors cu meniul Add deschis și opțiunea Add custom connector vizibilă Începe din Settings > Connectors. Meniul Add deschide formularul pentru conector personalizat.

  1. Introdu Fernhill Help în Name. Lipește URL-ul Agentului din Connect MCP în MCP server URL, apoi selectează Continue.

Formularul Claude Add custom connector completat cu Fernhill Help și URL-ul găzduit al serverului MCP Quickchat AI Numele este o etichetă în Claude; URL-ul determină ce Agent apelează. Folosește propriul URL, nu adresa demonstrației din această captură.

  1. În Authentication, păstrează Sign in now selectat. Claude a detectat această opțiune pentru Agentul privat.

Opțiunile de autentificare Claude cu Sign in now selectat și marcat Detected Un Agent privat necesită autentificare înainte ca instrumentul său să poată fi folosit.

  1. În OAuth client, păstrează Register automatically selectat. Lasă Request headers gol și selectează Add în partea de jos a dialogului. Quickchat AI acceptă înregistrarea automată a clientului, deci nu trebuie să furnizezi client ID, client secret sau cheie API.

Opțiunile OAuth client în Claude cu Register automatically selectat și marcat Detected Register automatically este opțiunea detectată pentru acest server. Câmpurile opționale pentru client și antete nu necesită valori în această configurație.

  1. Pe pagina conectorului, selectează Connect. Dacă ți se solicită, conectează-te la Quickchat AI cu contul proprietarului sau un cont cu rol pe acest Agent și finalizează autorizarea.

Claude arată că Fernhill Help a fost adăugat, dar nu este încă conectat, cu un buton Connect Adăugarea conectorului și conectarea contului sunt pași separați. Selectează Connect aici.

  1. Înapoi în Claude, verifică dacă pagina afișează Disconnect și instrumentul Ask Fernhill Help. Păstrează Needs approval pentru primele teste.

Setările Fernhill Help conectat cu Disconnect și Ask Fernhill Help la permisiunile instrumentelor, cu Needs approval Instrumentul este acum disponibil. Claude îl grupează sub Write/delete tools în această interfață; Agentul nostru nu are Actions configurate pentru comenzi, retururi sau rambursări.

  1. Începe un chat nou. Deschide + > Connectors și activează Fernhill Help pentru conversație.

Meniul Connectors din chatul Claude cu Fernhill Help activat Verifică atât comutatorul conectorului din conversație, cât și conexiunea contului.

Instrucțiunile de început Anthropic acoperă conectarea unui serviciu și activarea lui într-un chat. Claude poate solicita aprobare când apelează instrumentul; pasul următor arată acea solicitare.

Folosește URL-ul găzduit pentru acest pas. Cererile conectorilor la distanță ai lui Claude pornesc din cloudul Anthropic, inclusiv când folosești aplicația desktop sau mobilă. O adresă care funcționează doar pe calculatorul tău, precum localhost, nu poate fi accesată de acea conexiune din cloud.

Pasul 5: Cum verifici ce a transmis Claude efectiv?

Compară răspunsul final al lui Claude cu rezultatul instrumentului și cu Inbox din Quickchat AI. Un răspuns plauzibil, singur, nu dovedește că a fost folosit conectorul.

  1. În noul chat Claude, trimite această instrucțiune:
Use Fernhill Help to answer the next three questions. Keep the policy conditions and say when the help center does not confirm something.
  1. Trimite mai întâi întrebarea despre garanție. Dacă Claude cere permisiunea de a folosi Ask Fernhill Help, alege Allow once pentru a aproba acest apel. Așteaptă răspunsul complet, apoi trimite întrebările despre retur și Elveția, una câte una.

Claude solicită aprobarea pentru Ask Fernhill Help la întrebarea despre garanția pentru deteriorare UV, cu Allow once vizibil Primul apel s-a oprit pentru aprobare. Allow once îți permite să inspectezi rezultatul înainte să decizi permisiunea pentru apelurile viitoare.

  1. Pentru fiecare răspuns complet, verifică înregistrarea folosirii instrumentului Ask Fernhill Help în Claude. Extinde detaliile când trebuie să inspectezi apelul.
  2. Deschide Inbox în Quickchat AI, cu Fernhill Help selectat. Găsește conversația Claude după marcajul temporal și întrebare. Citește atât mesajul primit, cât și răspunsul Agentului.
  3. Înregistrează întrebarea originală, întrebarea primită de Agent, răspunsul Agentului și răspunsul final al lui Claude. Kitul conține o fișă goală pentru dovezi și observațiile noastre înregistrate ca referință.

În rularea capturată de noi, toate cele trei întrebări au ajuns într-o singură conversație Inbox provenită din Claude, iar fiecare întrebare primită corespundea cu ce am tastat. Răspunsurile Agentului de mai jos provin din acea conversație găzduită. Capturile Testing anterioare sunt rulări locale separate.

Claude poate reformula o întrebare înainte de a apela Agentul și poate rezuma rezultatul după aceea. Inbox înregistrează mesajul trimis de Claude, nu neapărat formularea originală a utilizatorului. Un client care începe o sesiune MCP nouă poate crea și o altă conversație Inbox, așa că potrivește întrebarea și ora, nu doar firul conversației.

Verificarea 1: Păstrează Claude excluderea din garanție?

Centrul de ajutor exclude explicit deteriorarea cauzată de UV. Claude a apelat Fernhill Help și a păstrat acea excludere:

Claude răspunde la întrebarea despre deteriorarea UV după folosirea Fernhill Help, păstrează excluderile garanției și marchează detaliile nespecificate Răspunsul complet al lui Claude spune că deteriorarea UV este exclusă. Marchează detaliile suplimentare ale garanției pe care nu le poate confirma.

Compară-l cu răspunsul Agentului din schimbul corespunzător din Inbox:

Quickchat AI Inbox arată întrebarea despre deteriorarea UV primită de la Claude și răspunsul Fernhill Help despre garanție Fragmente de întrebare și răspuns din același schimb Inbox. Agentul găzduit a furnizat acoperirea de doi ani și cele trei excluderi; Claude le-a păstrat.

Claude a identificat și întrebări la care sursa nu răspundea, de exemplu când începe perioada de doi ani. Le-a descris ca necunoscute, în loc să le adauge politicii.

Verificarea 2: A adăugat Claude o condiție de retur?

Răspunsul despre retur necesită o examinare mai atentă, deoarece combină eligibilitatea, un termen-limită și momentul rambursării.

Răspunsul complet al lui Claude despre returul jachetei include intervalul de 60 de zile, etichetele originale și termenul de rambursare, adăugând că etichetele trebuie să fie atașate Claude a păstrat principalele fapte ale politicii, dar a adăugat o condiție mai strictă: „etichetele originale trebuie să fie și ele atașate”.

Răspunsul Agentului a folosit formularea mai restrânsă a sursei:

Quickchat AI Inbox arată întrebarea lui Claude despre returul jachetei și un răspuns care cere articole nefolosite și etichete originale fără a preciza atașarea lor Fragmente de întrebare și răspuns din același schimb Inbox. Fernhill Help a cerut articole nefolosite și etichete originale. Nici acest răspuns, nici Knowledge Base nu precizează dacă etichetele trebuie să fie încă atașate.

Punct de verificareRezultat observat
Întrebarea primităAgentul a primit neschimbate vechimea de 45 de zile și faptul că jacheta era nepurtată
Răspunsul AgentuluiÎn 60 de zile, nefolosită, etichete originale; rambursare prin metoda de plată inițială în zece zile lucrătoare de la primirea returului
Răspunsul lui ClaudeA păstrat aceste fapte și nu a pretins că depune un retur, dar a adăugat că etichetele trebuie să fie atașate

Acesta a fost un apel de instrument reușit, cu o discrepanță față de politică în răspunsul final. Nu l-am marcat drept o verificare a răspunsului complet trecută. Scorul de test 5,0/5 al Agentului local nu a evaluat reformularea lui Claude, iar schimbarea ulterioară a textului centrului de ajutor ar ascunde discrepanța, nu ar corecta-o.

Pentru propriile politici, compară fiecare condiție de eligibilitate, excepție și termen cu sursa. „Cu etichetele originale” și „cu etichetele încă atașate” pot duce cititorul la decizii diferite.

Verificarea 3: Rămâne necunoscută o destinație necunoscută?

Răspunsul despre Elveția de la începutul tutorialului a provenit din acest schimb corespunzător din Inbox:

Quickchat AI Inbox arată întrebarea lui Claude despre Elveția și Fernhill Help spunând că livrarea acolo nu este confirmată și sugerând contactarea asistenței Fragmente de întrebare și răspuns din același schimb Inbox. Agentul găzduit a păstrat lacuna din cunoștințe, la fel și răspunsul final al lui Claude.

Acesta este același caz care a eșuat înainte de schimbarea promptului local. Acum, atât Agentul, cât și Claude au distins destinațiile documentate UE și Regatul Unit de destinația neconfirmată. Sugerarea contactării asistenței nu a creat un tichet și nu a transferat conversația; nu am configurat niciuna dintre aceste capacități.

Cum îmbunătățești un răspuns care nu trece verificarea?

Schimbă partea responsabilă de eroare, apoi repetă aceeași întrebare.

  1. Niciun apel de instrument: confirmă că este activat conectorul, numește explicit Fernhill Help și verifică dacă MCP Description explică când să fie folosit.
  2. Răspuns incorect al Agentului: inspectează articolul-sursă și starea Ready, apoi repetă cazul în Testing. Corectează sursa sau Main Prompt înainte de a schimba instrucțiunile pentru Claude.
  3. Răspuns corect al Agentului, răspuns modificat de Claude: numește discrepanța concretă, cere-i lui Claude să păstreze numai condițiile susținute de sursă și repetă schimbul. Verifică din nou ambele răspunsuri.
  4. Lipsește continuarea prin asistență: compară Description cu ce face efectiv Agentul. Declară acolo o capacitate reală de continuare dacă o construiești; formularea singură nu creează o Action de transfer și nu garantează că Claude va transmite oferta.

Pentru discrepanța observată la retur, poți încerca acest mesaj de continuare țintit:

Check your return answer against Fernhill Help. The source says "with the original tags" but does not say they must still be attached. Re-answer using only the policy conditions supported by the tool result. If a condition is not specified, say it is unconfirmed rather than adding it.

Acesta este un test următor sugerat, nu o corecție demonstrată în rularea capturată. Verifică noul răspuns înainte să consideri problema rezolvată. Dacă politica reală cere etichete atașate, confirmă acest lucru cu responsabilul politicii și actualizează explicit sursa.

Tutorialul anterior despre MCP găzduit înregistrează o ofertă de continuare pe care clientul apelant a omis-o până când descrierea instrumentului a explicat-o. Tratează asta ca pe un motiv să inspectezi propriile schimburi, nu ca pe o promisiune că o singură descriere controlează întotdeauna răspunsul lui Claude.

Poți folosi conectorul pe mobil și în Claude Code?

Conectorul găzduit poate fi folosit dincolo de chatul web, dar fiecare client are în continuare nevoie de o conexiune funcțională și de un apel de instrument reușit.

Pe mobil, conectează-te la același cont Claude după conectarea pe web sau desktop. Aceeași conversație Fernhill a fost disponibilă și pe un iPhone:

Fragment din aceeași conversație Fernhill pe iPhone, cu întrebarea despre Elveția și răspunsul lui Claude că destinația nu este confirmată Conversația existentă vizualizată pe mobil. Această captură nu dovedește un nou apel de instrument de pe telefon.

Pentru a testa un apel mobil nou, verifică opțiunile conectorilor din conversație, activează Fernhill Help și trimite din nou întrebarea despre jachetă. Inspectează detaliile folosirii instrumentului și noua înregistrare Inbox. Anthropic descrie disponibilitatea conectorilor la distanță în ghidul conectorilor pe mai multe dispozitive.

În Claude Code, deschide mai întâi /mcp. Când te conectezi cu un cont cu abonament Claude eligibil, conectorii autentificați din claude.ai pot apărea automat. Autentificările prin cheie API și furnizori terți nu îi importă. Dacă în schimb configurezi serverul direct, folosește:

claude mcp add --transport http fernhill-help https://app.quickchat.ai/mcp/YOUR_AGENT_ID

Înlocuiește URL-ul cu al tău. Deschide /mcp pentru autentificare și inspectarea conexiunii, apoi pune aceeași întrebare despre politică. Evită să adaugi un duplicat dacă funcționează deja conectorul sincronizat. Această cale opțională urmează documentația Claude Code MCP; rularea noastră capturată acoperă conversația Claude de mai sus, nu o sesiune Claude Code.

Cum distribui un conector privat echipei?

Distribuirea unui conector privat necesită atât disponibilitate în Claude, cât și permisiune de a folosi Agentul în Quickchat AI.

Diagramă a accesului privat care necesită autentificare Quickchat AI și un rol pe Agent, cu un endpoint public separat care expune doar cunoștințe destinate publicului Verificarea accesului Agentului are loc înainte de generare. Instrucțiunile dintr-o conversație nu acordă un rol.

  1. În Quickchat AI, folosește Settings > Organization > Team Members pentru a invita colegul la Agent. Cere-i să accepte, apoi confirmă că apare ca membru. Folosește un plan cu suficiente locuri pentru colaboratori și rolul minim necesar; documentația echipei și a rolurilor descrie aceste permisiuni.
  2. În Claude Team sau Enterprise, un Owner deschide Organization settings > Connectors, alege Add > Custom și, dacă i se cere, Web, apoi adaugă URL-ul Agentului. Utilizatorii Enterprise cu rolul personalizat corespunzător pot administra și ei conectorii organizației. Membrii se conectează apoi cu propriile conturi.
  3. În planurile Claude individuale, fiecare coleg adaugă conectorul personalizat în propriul cont, în limita planului său.
  4. Cere colegului să repete o întrebare despre politică. Pentru un Agent privat, testează și un cont separat care nu are rol. Simplul fapt de a adăuga URL-ul în Claude nu trebuie să acorde acces acelui cont.

Pentru o matrice de acces complet testată, inclusiv eliminarea unui coleg și reîncercarea unei conexiuni existente, folosește tutorialul de autentificare și autorizare MCP. Limita importantă este Agentul, împreună cu cunoștințele și Actions disponibile pentru el; această configurație nu adaugă permisiuni separate ale apelantului pentru articole individuale.

Cum creezi un conector public pentru întrebări frecvente?

Un endpoint MCP public le permite apelanților să folosească Agentul fără autentificare Quickchat AI. Folosește-l numai pentru cunoștințe și capacități pe care intenționezi să le expui public.

Fernhill Help conține numai centrul de ajutor public fictiv. Pentru a încerca varianta publică, verifică întreaga Knowledge Base și Actions. În External Apps > MCP, citește explicația de lângă Require sign-in (private) înainte de a dezactiva acel comutator. Păstrează procedurile interne de retur sau datele clienților într-un Agent privat separat.

Explicația Quickchat AI de lângă Require sign-in private descrie accesul public și consumul mesajelor plătit de proprietar Explicația arată cine se poate conecta și ale cui credite sunt folosite. Tutorialul principal păstrează Fernhill Help privat.

Cine folosește acest conector în Claude are în continuare nevoie de un cont Claude. În afara Claude, și alți clienți MCP pot apela un endpoint public. Oricine are URL-ul poate consuma creditele AI ale proprietarului Agentului, așa că verifică utilizarea după distribuire. Repetă cele trei teste de politici dintr-o sesiune client separată; reactivează comutatorul privat când ai terminat exercițiul public.

Un link de instalare precompletat poate scuti colegii de copierea manuală a numelui și URL-ului. El doar completează formularul; ei trebuie în continuare să verifice și să adauge conectorul. Trimiterea în Directory este un pas separat de distribuție și nu este necesară pentru a termina acest tutorial.

Poate Claude ajuta la configurarea Agentului Quickchat AI?

Conectorul Quickchat AI din Directory poate crea Agenți, edita cunoștințe și rula teste cu permisiunile contului tău. Este o scurtătură opțională pentru configurarea de mai sus.

Conectează-te prin pagina Quickchat AI din Claude Directory și finalizează propria autentificare Quickchat AI. Atașează fișierele text din kit la conversație și folosește acest prompt de configurare:

Use the Quickchat AI account-management connector to prepare a new Agent named Fernhill Help. Show me the intended changes before creating it, and do not change any existing Agent. Use main-prompt.txt as its Main Prompt and fernhill-help-center.txt as its only Knowledge Base article. Wait for the article to be Ready. Keep this demonstration limited to policy answers, with no custom Actions, Human Handoff or Smart Data Gathering. Create a Testing dataset named Fernhill policy checks from test-messages.txt with evaluation-criteria.txt. Ask me before running tests that consume AI credits. After I approve, enable the Agent's MCP channel with private visibility and give me its hosted URL. Tell me which settings I still need to complete in the dashboard, including the exact Description and Command in mcp-settings.json and mcp-description.txt. Do not make the Agent public or claim that Claude is connected to it until I complete and test the custom-connector setup.

Verifică Description și Command în panoul de administrare; scurtătura de administrare a contului nu înlocuiește aceste câmpuri sau autorizarea din Claude. Ghidul separat de administrare a contului acoperă fluxul mai larg, iar Quickchat AI pentru Claude oferă calea de instalare și exemple.

Ce ar trebui să verifici dacă nu funcționează conectorul?

Identifică etapa care eșuează înainte de a schimba promptul Agentului. Acestea sunt verificări de diagnostic, nu afirmații că fiecare eroare a apărut în configurația Fernhill.

SimptomVerifică mai întâiPasul următor util
Nu poți adăuga un conector personalizatLimita planului Claude și rolul din organizațieVerifică locul din Free sau cere Owner al organizației să îl adauge
Autentificarea se încheie, dar Agentul nu este disponibilContul Quickchat AI și rolul său pe acest AgentConfirmă contul în Quickchat AI, URL-ul exact al Agentului și Enable MCP
Claude nu poate accesa serverulDacă URL-ul este HTTPS accesibil publicFolosește URL-ul găzduit din Connect MCP; o adresă doar locală nu va funcționa
Este conectat, dar nu apare niciun apel de instrumentDacă Fernhill Help este activat în acest chatActivează-l, cere-l explicit și inspectează detaliile folosirii instrumentului
Răspunsul diferă de politicăCe parte a introdus prima diferențaCompară sursa, răspunsul testului local, rezultatul MCP și răspunsul final al lui Claude

Documentația Anthropic pentru depanarea conectorilor acoperă descoperirea OAuth, accesibilitatea rețelei și redirecționările pentru operatorii serverelor. Separă aceste probleme de o informație greșită sau lipsă în Knowledge Base.

După ce funcționează toate cele trei cazuri, adaptează întreaga configurație la afacerea ta:

  1. Înlocuiește articolul fictiv cu informații aprobate și elimină sursa Fernhill.
  2. Actualizează numele Agentului și Main Prompt, apoi MCP Name, Description și Command. Descrie numai cunoștințele și Actions pe care Agentul le are efectiv.
  3. Înlocuiește întrebările de test și criteriile de evaluare cu propriul răspuns cunoscut, un răspuns condiționat și un fapt lipsă în mod intenționat.
  4. Reîmprospătează sau reconectează conectorul în Claude, astfel încât detaliile instrumentului să reflecte schimbările, apoi repetă testele Agentului și comparația de la început la sfârșit.

Rezultatul este util când un coleg poate pune o întrebare reală despre politică în Claude, tu poți urmări răspunsul în Inbox, iar un fapt nedocumentat rămâne nedocumentat în răspuns.

Întrebări frecvente

Ce sunt conectorii Claude?

Conectorii Claude îi oferă lui Claude acces la instrumente și informații externe. Un conector personalizat la distanță conectează Claude la un server MCP prin URL. În acest tutorial, serverul expune un singur instrument care îi adresează o întrebare Agentului tău Quickchat AI.

Pot adăuga un conector personalizat în planul Claude Free?

Da. Claude Free acceptă un singur conector personalizat. Pro, Max, Team și Enterprise acceptă, de asemenea, conectori personalizați. Quickchat AI include MCP în planul Free actual; răspunsurile generate și rulările Simulation consumă credite AI.

Care este diferența dintre un conector Claude și un server MCP?

Conectorul este conexiunea pe care o adaugi și o activezi în Claude. Serverul MCP este serviciul la care se conectează. Quickchat AI găzduiește serverul pentru Agentul tău, deci configurezi Agentul și îi copiezi URL-ul fără să scrii cod de server.

Funcționează conectorii în Claude Desktop și pe mobil?

Conectorii personalizați la distanță funcționează în aplicațiile Claude pentru web, desktop și mobil. Adaugă conectorul pe web sau desktop, apoi folosește același cont pe mobil. O extensie desktop locală este o configurație diferită și nu devine un conector mobil la distanță.

Poate Claude Code folosi conectorii adăugați pe claude.ai?

Da. Claude Code poate folosi automat conectori claude.ai autentificați când te conectezi cu un cont cu abonament Claude eligibil. Verifică mai întâi /mcp. Autentificările prin cheie API și furnizori terți nu importă acești conectori; poți configura în schimb serverul găzduit direct.

Cine poate adăuga un conector în Claude Team sau Enterprise?

Un Owner Team sau Enterprise poate adăuga un conector personalizat pentru organizație. Îl poate adăuga și un membru Enterprise cu permisiunea corespunzătoare a unui rol personalizat de a administra bibliotecile organizației. Membrii se conectează apoi individual. Accesul la un Agent Quickchat AI privat necesită în continuare un rol pe acel Agent.

Acest conector expune întregul meu cont Quickchat AI?

Conectorul per Agent expune un singur instrument de întrebări și răspunsuri pentru Agentul selectat. Nu expune instrumentele separate de administrare a contului. Agentul poate folosi cunoștințele și Actions activate, așa că verifică-le pe ambele înainte de distribuire. Accesul privat este controlat la nivelul Agentului, nu printr-o permisiune separată pentru fiecare articol.

Pot clienții să folosească conectorul meu fără un cont Claude?

Au nevoie de un cont Claude pentru a-l folosi în Claude. Dacă faci public endpointul MCP al Agentului, nu au nevoie de autentificare Quickchat AI, dar oricine are URL-ul îl poate apela, iar răspunsurile generate consumă creditele AI ale proprietarului. Păstrează informațiile private într-un Agent privat separat.

Quickchat AI Quickchat AI Ask Quickchat AI a question