Claude-integráció
Az Askalot MCP-szervere lehetővé teszi, hogy a Claude közvetlenül, beszélgetésben kezelje a kérdőíveket, a kampányokat, a válaszadókat és az adatelemzést. Ez az útmutató az összes Claude-felület beállítását ismerteti.
Áttekintés
Szekció neve “Áttekintés”Az integráció 127 eszközt tesz elérhetővé, és mindegyik pontosan egy eszközkészlethez tartozik a tizenhét közül. Ugyanezekre a nevekre szűkítheti le egy kapcsolatot a ?toolsets= paraméterrel – lásd: A kapcsolat által látott eszközök szűkítése.
| Eszközkészlet | Eszközök | Példák |
|---|---|---|
sampling |
23 | Válaszadók, válaszadói körök, mintavételi stratégiák – létrehozás, húzás, frissítés, előnézet |
fielding |
21 | Kitöltések, meghívók, a kérdezők munkaterhelése, a válaszadási folyamat, szintetikus kitöltések |
analysis |
20 | Csomagok, a Bronz/Ezüst/Arany adatfolyam, a kódolás kiválasztása, minőség, export |
questionnaire |
17 | QML-fájlok létrehozása és kezelése, validálás Z3-mal, közzététel, feltöltés |
campaign |
8 | Kampányok létrehozása, kérdőív hozzárendelése, válaszadói kör hozzárendelése |
project |
7 | Projektek létrehozása, tulajdonjog kezelése |
documents |
4 | Keresés és olvasás az Ön indexelt kutatási dokumentumaiban |
methodology |
4 | Keresés 24 lektorált módszertani tanulmányban |
audit |
3 | Az auditnapló lekérdezése |
session |
4 | Annak megtekintése, mely szervezetekben dolgozhat a munkamenet, váltás közöttük, felhasználók keresése |
conversation |
4 | Egy ügynökfuttatás beszélgetésének rögzítése és visszaolvasása |
docs |
3 | Keresés és olvasás az Askalot dokumentációjában |
paper |
3 | A projekt kutatási tanulmányának olvasása és horgonyalapú szerkesztése, a megválaszolhatósági lánc követése |
composite |
3 | Egy teljes lánc futtatása egyetlen hívásban – terepmunka, szimuláció vagy az adatkészlet-folyamat |
tasks |
1 | get_task_status – egy hosszan futó feladat lekérdezése a visszakapott task_id alapján |
entitlements |
1 | Annak lekérdezése, mire terjed ki az előfizetése |
discovery |
1 | list_toolsets – mit tartalmaznak az egyes eszközkészletek, és melyeket kért ez a kapcsolat |
Az utolsó nyolc sor minden kapcsolaton elérhető, bármit kér is; a ?toolsets= az első kilencet szűri.
Hitelesítés
Szekció neve “Hitelesítés”Az Askalot OAuth 2.1-et használ PKCE-vel és dinamikus kliensregisztrációval (RFC 7591). A teljes folyamatot a Claude automatikusan kezeli – Önnek csak be kell jelentkeznie az Askalot-fiókjával, amikor a rendszer kéri.
Hogyan működik?
Szekció neve “Hogyan működik?”- A Claude a
/.well-known/oauth-authorization-servercímen felderíti az Askalot OAuth-végpontjait - A Claude a
POST /registerhívással OAuth-kliensként regisztrálja magát (egyszer, automatikusan) - Megnyílik egy böngészőablak, amelyben bejelentkezhet az
oidc.platform.askalot.iooldalon - A bejelentkezés után a Claude hozzáférési tokent kap, és csatlakozik az MCP-szerverhez
Nincs szükség API-kulcsokra vagy kézi tokenkezelésre.
OAuth-végpontok
Szekció neve “OAuth-végpontok”| Végpont | Rendeltetés |
|---|---|
GET /.well-known/oauth-authorization-server |
A szerver metaadatainak felderítése |
GET /.well-known/oauth-protected-resource/mcp |
A védett erőforrás metaadatai |
POST /register |
Dinamikus kliensregisztráció |
GET /authorize |
Engedélyezés (átirányít az OIDC-bejelentkezésre) |
POST /token |
Tokencsere (authorization_code, refresh_token) |
POST /revoke |
Token visszavonása |
Támogatott funkciók: Authorization Code PKCE-vel (S256), frissítési tokenek, hatókörök (mcp:read, mcp:write, mcp:admin).
A bérlő URL-címe
Szekció neve “A bérlő URL-címe”Az alábbi URL-címekben a <tenant> helyére a bérlőazonosítóját írja. Gyakori bérlők:
dev– ingyenes próbaverzió és demó (ACME Corp szervezet)eu1– uniós éles környezet (fizető ügyfelek és egyetemek)
MCP-végpont: https://portor.<tenant>.askalot.io/mcp
Claude.ai (web)
Szekció neve “Claude.ai (web)”- Nyissa meg a claude.ai oldalt, majd a Settings menüt
- Lépjen az Integrations (vagy Connectors) részre
- Kattintson az Add Custom MCP Server gombra
- Adja meg:
- Name:
Askalot - URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Kattintson a Connect gombra – megnyílik egy böngészőablak az OAuth-bejelentkezéshez
- Jelentkezzen be az Askalot-fiókjával, és engedélyezze a hozzáférést
Claude Desktop
Szekció neve “Claude Desktop”A Claude Desktop távoli, egyéni összekötőként kapcsolódik az Askalothoz – ilyenkor csak az MCP-eszközöket / az API-t kapja meg (ügynököket, skilleket és parancsokat nem), és asztali bővítményt (.mcpb) nem kell telepíteni, mivel a Portor távoli szerver.
Egyéni összekötő hozzáadása (ajánlott)
Szekció neve “Egyéni összekötő hozzáadása (ajánlott)”- Nyissa meg a Settings → Connectors részt (egyes verziókban ez a Customize → Connectors alatt található)
- Kattintson az Add custom connector gombra
- Adja meg:
- Name:
Askalot - Remote MCP server URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Kattintson az Add gombra – megnyílik egy böngészőablak az OAuth-bejelentkezéshez
- Jelentkezzen be az Askalot-fiókjával, és engedélyezze a hozzáférést
Az OAuth-hozzájárulás interaktív és egyszeri; a tokent a Claude Desktop tárolja és frissíti Ön helyett. A csatlakozás után a kérdőív-, kampány-, adatkészlet- és elemzőeszközök megjelennek az összekötő eszközlistájában. Sem API-kulcsot, sem statikus tokent nem kell beillesztenie – az Askalot OAuth 2.1-et használ.
Alternatíva: konfigurációs fájl
Szekció neve “Alternatíva: konfigurációs fájl”Ha inkább közvetlenül a konfigurációs fájlt szerkesztené, vegye fel a távoli szervert az mcpServers alá a rendszerének megfelelő fájlban:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}Mentés után indítsa újra a Claude Desktopot. Az első használatkor megnyílik egy böngészőablak az OAuth-bejelentkezéshez.
Claude Code (CLI)
Szekció neve “Claude Code (CLI)”A Claude Code kétféleképpen csatlakozhat.
Az Askalot bővítmény telepítése (teljes felület)
Szekció neve “Az Askalot bővítmény telepítése (teljes felület)”/plugin marketplace add askalot-io/askalot-plugin/plugin install askalot@askalotA bővítmény egy csomagban tartalmazza az Askalot ügynökeit, skilljeit, perjeles parancsait és az MCP-eszközöket. Az MCP-beállítása (.mcp.json) type: http típusú, a ${ASKALOT_MCP_URL} címre mutat, és interaktív OAuth-ot használ – statikus bearer token nélkül. A Claude Code indítása előtt állítsa be az ASKALOT_MCP_URL változót a shellben:
export ASKALOT_MCP_URL="https://portor.<tenant>.askalot.io/mcp"Ha nincs beállítva, a bővítmény az ingyenes próbabérlőhöz csatlakozik. Ha a fiókja egy másik bérlőn van, a bejelentkezés ugyan sikerül, de a csatlakozás user_not_in_tenant hibával zárul. Az üzenet megnevezi az ellenőrzött bérlőt, azt a bérlőt, amelyre a bejelentkezése szólt, valamint ennek pontos URL-címét. Állítsa a változót erre az URL-re, és indítsa újra a Claude Code-ot.
Csak az MCP-szerver hozzáadása
Szekció neve “Csak az MCP-szerver hozzáadása”Ha csak az eszközökre van szüksége (ügynökök, skillek és parancsok nélkül):
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcpAz első használatkor a Claude Code megnyit egy böngészőt az OAuth-bejelentkezéshez. A hitelesítés után a Claude Code helyben tárolja és automatikusan frissíti a tokent.
Használati példák
Szekció neve “Használati példák”Kérdőíves kampány létrehozása
Szekció neve “Kérdőíves kampány létrehozása”You: Create a customer satisfaction campaign with 50 test respondents.
Claude: I'll set up that campaign for you.
→ list_projects() — found "Customer Research" project→ create_campaign("CSAT Q1 2026", project_id, questionnaire_id, admits_volunteers=false, offers_ai_channel=false)→ bulk_create_respondents(50, project_id)→ create_respondent_pool("CSAT Pool", respondent_ids=...)→ assign_pool_to_campaign(campaign_id, pool_id)
Done! Campaign "CSAT Q1 2026" is ready with 50 respondents.A kérdőív eredményeinek elemzése
Szekció neve “A kérdőív eredményeinek elemzése”You: Extract and weight the results from my latest campaign.
Claude: I'll build a Bundle and derive a weighted dataset from your campaign data.
→ list_campaigns(status="completed")→ create_bundle("CSAT Results", project_id, questionnaire_id, campaign_ids=[campaign_id])→ create_bronze_dataset(bundle_id)→ code_open_ends(bundle_id) # codes open-ends, then weights the coded case base→ get_dataset(silver_dataset_id) # poll until "ready" — comparing earlier returns a conflict→ compare_bundle_quality(bundle_id)
The weighted dataset reduced RMSE from 0.08 to 0.02.Gender distribution now matches targets within 1%.Kérdőív validálása
Szekció neve “Kérdőív validálása”You: Check my new questionnaire for logical errors.
Claude: I'll run Z3 analysis on your QML file.
→ validate_qml_file("satisfaction.qml")
The questionnaire has 12 items across 3 blocks.Found 1 issue: Item 'q_followup' is unreachable becauseits precondition requires q_satisfied < 3, but q_satisfieduses a scale of 1-5 with no path setting it below 3.Eszközannotációk
Szekció neve “Eszközannotációk”Minden eszköz MCP-annotációkat tartalmaz a biztonságos MI-interakció érdekében:
- Írásvédett eszközök (
list_*,get_*,search_*):readOnlyHint=truejelöléssel – a Claude szabadon hívhatja őket - Író eszközök (
create_*,update_*):destructiveHint=falsejelöléssel – biztonságos módosítások - Törlő eszközök (
delete_*,remove_*):destructiveHint=truejelöléssel – a Claude végrehajtás előtt megerősítést kér - Külső hatású eszközök (
send_*_invitation):openWorldHint=truejelöléssel – valódi e-maileket küldenek
Az írásvédett annotáció nem csupán tanács a Claude számára: egy lezárt szervezetben maga az Askalot is ez alapján dönti el, mely hívásokat utasítsa el. Ott minden, ami nincs írásvédettként megjelölve, írásnak minősül, és org_sealed választ kap – kivéve azokat a tervezési fázisban használt eszközöket, amelyek csak előnézetet indítanak el vagy visznek végig: ezek semmit sem változtatnak a kutatási nyilvántartásban, és továbbra is működnek.
Lapozás
Szekció neve “Lapozás”A listázó eszközök lapozhatók, hogy a válaszok tömörek maradjanak:
→ list_respondents(name="Smith", limit=10)→ list_campaigns(status="active", limit=5)→ list_surveys(status="completed", limit=20)Minden listázó eszköz alapértéke limit=100, és metaadatokat ad vissza:
{ "items": [...], "count": 10, "limit": 100}