Tovább a tartalomhoz
Tudástár

Integrációs pontok

Az Askalot három, egymást kiegészítő integrációs felületet kínál. Ugyanazokon a platformképességeken és jogosultsági modellen osztoznak – válassza azt, amelyik illeszkedik ahhoz, ahogyan a rendszere az Askalottal kommunikál.

Integráció Mire a legalkalmasabb Hitelesítés
Claude (MCP + bővítmény) MI-ügynökök, amelyek beszélgetésben viszik végig a kutatási életciklust OAuth 2.1 böngészős bejelentkezés
REST API Szerverek közötti automatizálás, CI, egyedi alkalmazások Személyes API-token (X-Api-Token fejléc)
A kérdőív megjelenítési formátuma Élő kérdőívek megjelenítése az Ön saját alkalmazásának felületén Ugyanazok a REST-hitelesítő adatok

Az Askalot MCP-szervere lehetővé teszi, hogy a Claude (Claude.ai, Claude Desktop, Claude Code) közvetlenül, beszélgetésben kezelje a projekteket, a kérdőíveket, a kampányokat és az adatelemzést. A Claude Code felhasználói ezenfelül telepíthetik az Askalot bővítményt (plugin) is – a skilleket, a perjeles parancsokat és az MCP-eszközöket egyetlen csomagban. A hitelesítés interaktív OAuth 2.1 folyamattal történik; API-kulcsot nem kell kezelnie.

→ Útmutató a Claude-integrációhoz

Minden platformentitás – projektek, kérdőívek, kampányok, válaszadók, kitöltések, csomagok, válaszadói körök, stratégiák – elérhető a https://portor.<tenant>.askalot.io/api/v1 címen, OpenAPI 3.0 specifikációval és a /api/v1/docs címen interaktív Swagger UI-val.

A hitelesítés személyes API-tokennel történik:

  1. Jelentkezzen be a https://roundtable.<tenant>.askalot.io címen, és nyissa meg a Profilbeállítások → API-tokenek oldalt
  2. Hozzon létre egy tokent (a lejáratot Ön választja meg; a token csak egyszer jelenik meg)
  3. Minden kérésben küldje el az X-Api-Token fejlécben

A token örökli a fiókja szerepköreit és jogosultságait, és bármikor visszavonható – a visszavonás azonnal érvénybe lép. A REST API-n az Authorization: Bearer fejléc az OAuth-hozzáférési tokenek (az MCP-átvitel által használt hitelesítő adat) számára van fenntartva; az API-tokeneket mindig az X-Api-Token fejlécben kell küldeni.

→ A REST API referenciája

Ahelyett, hogy egy Askalot-stílusú kérdőívoldalt ágyazna be, az alkalmazása elemről elemre vezérelheti a kitöltést, és minden kérdést a saját UI-komponenseivel jeleníthet meg. Minden lépés önálló JSON-dokumentumként érkezik – a kérdés felirata, a beviteli vezérlő leírása és az érvényes opciók –, miközben a menet logikája, az elágazások és a validáció az Askalot motorjában, a szerveroldalon marad.

→ A kérdőív megjelenítési formátuma

Az MI-ügynökök és -eszközök HTML helyett egyszerű Markdownként is olvashatják ezt a dokumentációt:

Mire van szüksége Hol találja
Az összes oldal jegyzéke, mindegyik egysoros összefoglalóval https://docs.askalot.io/llms.txt
A teljes dokumentáció egyetlen fájlban https://docs.askalot.io/llms-full.txt
Egyetlen oldal Fűzze hozzá az index.md részt az oldal címéhez, például https://docs.askalot.io/integrations/claude/index.md
Egyetlen oldal, a címe megváltoztatása nélkül Kérje le az oldalt az Accept: text/markdown fejléccel

A Markdown ugyanazt a tartalmat hordozza, amelyet az oldalon lát, a benne lévő hivatkozások pedig abszolútak, így egy ügynök bármely kiindulópontról követheti őket. Az MCP-n keresztül csatlakoztatott Claude a dokumentációs eszközökkel is kereshet és olvashat a dokumentációban.