Tovább a tartalomhoz
Tudástár

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.

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.

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.

  1. A Claude a /.well-known/oauth-authorization-server címen felderíti az Askalot OAuth-végpontjait
  2. A Claude a POST /register hívással OAuth-kliensként regisztrálja magát (egyszer, automatikusan)
  3. Megnyílik egy böngészőablak, amelyben bejelentkezhet az oidc.platform.askalot.io oldalon
  4. 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.

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

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

  1. Nyissa meg a claude.ai oldalt, majd a Settings menüt
  2. Lépjen az Integrations (vagy Connectors) részre
  3. Kattintson az Add Custom MCP Server gombra
  4. Adja meg:
    • Name: Askalot
    • URL: https://portor.<tenant>.askalot.io/mcp
  5. Kattintson a Connect gombra – megnyílik egy böngészőablak az OAuth-bejelentkezéshez
  6. Jelentkezzen be az Askalot-fiókjával, és engedélyezze a hozzáférést

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.

Szekció neve “Egyéni összekötő hozzáadása (ajánlott)”
  1. Nyissa meg a Settings → Connectors részt (egyes verziókban ez a Customize → Connectors alatt található)
  2. Kattintson az Add custom connector gombra
  3. Adja meg:
    • Name: Askalot
    • Remote MCP server URL: https://portor.<tenant>.askalot.io/mcp
  4. Kattintson az Add gombra – megnyílik egy böngészőablak az OAuth-bejelentkezéshez
  5. 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.

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.

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@askalot

A 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:

Terminál
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.

Ha csak az eszközökre van szüksége (ügynökök, skillek és parancsok nélkül):

Terminál
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcp

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

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.
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%.
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 because
its precondition requires q_satisfied < 3, but q_satisfied
uses a scale of 1-5 with no path setting it below 3.

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=true jelöléssel – a Claude szabadon hívhatja őket
  • Író eszközök (create_*, update_*): destructiveHint=false jelöléssel – biztonságos módosítások
  • Törlő eszközök (delete_*, remove_*): destructiveHint=true jelö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=true jelö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.

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
}