MCP

Připojte Siesta AI k libovolnému AI klientovi kompatibilnímu s MCP (Claude, Cursor, VS Code, Antigravity a další). Jakmile je připojen, klient může spravovat vaše agenty, dovednosti a pracovní postupy, posílat zprávy a číst konverzace přímo z vaší organizace Siesta AI.

Jak nainstalovat

Přidejte jednu z níže uvedených definic připojení do konfigurace MCP vašeho AI klienta. Nahraďte [YOUR-API-KEY] a [YOUR-ORGANIZATION-KEY] hodnotami z vaší organizace Siesta AI.

HTTP

Doporučeno. Žádné externí závislosti, ačkoli několik klientů to ještě nemusí podporovat.

"siesta": {
  "type": "http",
  "url": "https://api.siesta.ai/mcp",
  "headers": {
    "X-Api-Key": "[YOUR-API-KEY]",
    "X-Org-Id": "[YOUR-ORGANIZATION-KEY]"
  }
}

OAuth

Doporučeno pro interaktivní MCP klienty s podporou OAuth. Klient otevře Siesta AI pro přihlášení a souhlas, takže definice neobsahuje hlavičky s API klíčem.

"siesta": {
  "type": "http",
  "url": "https://api.siesta.ai/mcp"
}

npx (náhradní možnost)

Vyžaduje Node.js. Použijte pouze jako náhradní možnost, když se klient nemůže připojit přes HTTP.

"siesta": {
  "command": "npx",
  "args": [
    "-y", "mcp-remote", "https://api.siesta.ai/mcp",
    "--header", "X-Api-Key:[YOUR-API-KEY]",
    "--header", "X-Org-Id:[YOUR-ORGANIZATION-KEY]"
  ]
}

Nejjednodušší způsob instalace

Každý poskytovatel AI (Claude, Antigravity a další) ukládá MCP servery různě a očekává tyto definice ve své vlastní JSON konfiguraci. Nejrychlejší cesta je zkopírovat výše uvedený JSON (s vaším API klíčem a ID organizace ze Siesta AI), vložit jej do chatu klienta a požádat AI o jeho instalaci. Poté postupujte podle jakýchkoli pokynů, které vám poskytne, například restartování klienta pro obnovení MCP nástrojů.

OAuth installation

OAuth použijte, když MCP klient podporuje autorizaci v prohlížeči a připojení má jednat jménem přihlášeného uživatele Siesta AI.

1. V Siesta AI otevřete Profile > Apps & Extensions.
2. Na kartě MCP Server vyberte OAuth a zkopírujte konfiguraci bez hlaviček s API klíčem.
3. Přidejte definici do MCP klienta a spusťte připojení z tohoto klienta.
4. Pokud nejste přihlášeni, přihlaste se účtem, který má připojení autorizovat.
5. Na obrazovce Review connection ověřte název a hostitele klienta.
6. Zkontrolujte oprávnění a vyberte Allow access nebo Cancel.
7. Siesta AI vrátí výsledek klientovi. V klientovi ověřte dostupnost nástrojů Siesta AI.

Scope mcp umožňuje klientovi používat nástroje a data dostupná přihlášenému uživateli přes MCP. Volitelný offline_access umožňuje kompatibilnímu klientovi zůstat připojený, když jej uživatel aktivně nepoužívá.

Schvalte jen požadavek, který jste zahájili ze známého klienta. Pomocí Use another account změňte účet. Cancel vrátí odmítnutí a nic neautorizuje. Neplatný, expirovaný nebo přerušený požadavek spusťte z klienta znovu. Do konfigurace nekopírujte autorizační kódy, request hodnoty ani callback URL.

Tato stránka připojuje externího AI klienta k Siesta AI jako MCP serveru. Pro připojení cizího MCP serveru jako nástroje uvnitř Siesta AI použijte MCP Connection.

Nástroje

Jakmile je připojen, klient může používat níže uvedené nástroje. Všechny fungují v rámci organizace identifikované vaším API klíčem a ID organizace.

Agenti

Nástroj	Popis
list_agents	Vypsat agenty (chatboty) ve vaší organizaci. Použijte k nalezení ID agenta před odesláním zprávy nebo jeho úpravou.
get_agent	Přečíst plnou konfiguraci agenta: systémová zpráva, model, připojení, dovednosti, podagenti a nástroje.
create_agent	Vytvořit nového agenta z názvu a systémové zprávy, volitelně připojit model, dovednosti, podagenty a nástroje.
update_agent	Aktualizovat existujícího agenta. Změní se pouze pole, která předáte; seznamová pole nahradí celou sadu.

Konverzace

Nástroj	Popis
send_message	Odeslat zprávu agentovi a získat jeho odpověď. Předat agentId pro zahájení nové konverzace nebo conversationId pro pokračování v jedné.
list_conversations	Vypsat existující konverzace (od nejnovějších), s volitelným filtrováním podle agenta nebo vyhledávání názvu a stránkování.
get_conversation	Přečíst celou historii zpráv konverzace před jejím obnovením.

Dovednosti

Nástroj	Popis
list_skills	Vypsat dovednosti (pojmenované instrukce plus vázané funkce nástrojů) dostupné ve vaší organizaci.
get_skill	Přečíst plné detaily dovednosti: její instrukce a vázané funkce.
create_skill	Vytvořit novou dovednost z názvu, instrukcí a volitelných vázaných funkcí.
update_skill	Aktualizovat existující dovednost. Změní se pouze pole, která předáte; předání funkcí nahradí celou sadu.
list_skill_functions	Vypsat funkce nástrojů, které mohou být vázány na dovednost, vrátí ID k použití při vytváření nebo aktualizaci jedné.

Pracovní postupy

Nástroj	Popis
list_workflows	Vypsat pracovní postupy ve vaší organizaci. Použijte k nalezení ID pracovního postupu před jeho čtením nebo úpravou.
get_workflow	Přečíst plný graf pracovního postupu: uzly (s ID, typy a mapováním vstupů) a hrany.
create_workflow	Vytvořit pracovní postup z plného grafu uzlů a hran v jednom volání.
update_workflow	Nahradit graf pracovního postupu plnou sadou uzlů a hran, které by měl mít.
describe_node_types	Objevit stavební bloky pracovního postupu (typy uzlů, jejich vstupy/výstupy a volitelné cíle) před vytvořením pracovního postupu.
list_workflow_functions	Vyhledat funkce nástrojů, které mohou podporovat uzel nástroje pracovního postupu, filtrováno podle poskytovatele nebo schopnosti.

Objevování

Nástroj	Popis
list_connections	Vypsat připojení (integrace) dostupná jako poskytovatel modelu agenta nebo jako nástroj.
list_models	Vypsat LLM modely dostupné pro agenta, volitelně filtrováno podle připojení.
list_system_tools	Vypsat vestavěné systémové nástroje (například webové uzemnění a scraping), které mohou být povoleny na agentovi.

Nástroje Graphu

Koncepty Graphu, lifecycle, Explorer, Galaxy View a přiřazení agentům popisuje stránka Graphy.

Siesta AI MCP server zpřístupňuje znalosti Graphu pomocí názvů nástrojů psaných malými písmeny. Tyto nástroje se liší od interních nástrojů Graph_*, které Siesta AI připojuje k agentovi s přiřazenými Graphy. Externí MCP klienti mají používat zveřejněné lowercase nástroje a za autoritativní považovat jejich aktuální schémata a anotace.

Přístup ke Graphu se vyhodnocuje pro identitu reprezentovanou připojením. Pro čtení znalostí jsou vyžadovány Graphs.View i přístupová politika Graphu. Změny navíc vyžadují Graphs.Edit a efektivní oprávnění k zápisu. list_graphs vrací pouze dostupné Graphy a u každého uvádí canWrite. Odpověď not-found u nepřístupných znalostí považujte za hranici přístupu; nezkoušejte alternativní identifikátory.

Sada nástrojů

Nástroj	Účel	Charakter
list_graphs	Vypsat dostupné Graphy a informaci, zda lze každý z nich upravovat.	Pouze čtení
search_graph_nodes	Hledat v jednom Graphu podle textu, typů uzlů, časových filtrů, stránkování a řazení.	Pouze čtení
get_graph_schema	Číst pozorované typy uzlů, typy vztahů, koncové body a volitelně pozorované vlastnosti.	Pouze čtení
get_graph_node	Číst jeden uzel a jeho aktuální verzi.	Pouze čtení
get_graph_edge	Číst jeden vztah a jeho aktuální verzi.	Pouze čtení
get_graph_neighborhood	Číst jednu stránku přímých příchozích, odchozích nebo obousměrných vztahů kolem uzlu.	Pouze čtení
get_graph_subgraph	Číst propojený kontext do tří skoků od uzlu v obou směrech.	Pouze čtení
create_graph_node, create_graph_edge	Vytvořit znalosti s identifikátorem generovaným serverem po dohledání existujících entit nebo koncových bodů.	Zápis, ne-idempotentní
update_graph_node, update_graph_edge	Nahradit úplné znalosti pomocí optimistického řízení souběhu.	Zápis, destruktivní, idempotentní
delete_graph_node, delete_graph_edge	Odstranit znalosti pomocí jejich aktuální verze.	Zápis, destruktivní, idempotentní

Pomocí list_graphs zjistěte graphId a ověřte canWrite. Před vytvořením uzlu zavolejte search_graph_nodes, aby bylo možné znovu použít existující entitu a nevytvořit duplicitu. Hledání vyžaduje alespoň query, typ uzlu nebo filtr data vytvoření či aktualizace. Před vytvořením vztahu zjistěte ID obou uzlů.

Stránkování a omezený výstup

list_graphs ve výchozím nastavení vrací 25 výsledků a přijímá 1–100. search_graph_nodes používá výchozí hodnotu 20 a přijímá 1–100; pro načtení dalších stránek sledujte offset, returnedCount, totalCount a moreAvailable. get_graph_neighborhood ve výchozím nastavení vrací 50 vztahů a přijímá 1–100; pokud potřebujete úplné jednoskokové okolí, zpracujte každý vrácený continuationToken.

get_graph_subgraph vrací kompaktní kontext do tří skoků od jednoho uzlu a vždy prochází oba směry. Výsledek je omezený, nikoli stránkovaný. Hledáním určete výchozí uzel, okolí použijte pro vyčerpávající přímá spojení a subgraph pro zaměřený víceskokový kontext.

Výsledky mohou obsahovat outputTruncated, omittedItemCount, sourceTruncated, sourceTruncationReasons nebo další metadata stránkování. Považujte je za součást kontraktu výsledku. Pokud metadata říkají opak, nepředpokládejte, že je viditelná odpověď úplná; autoritativní je limit oznámený připojeným prostředím.

Úrovně detailu

Nástroje Graphu pro čtení používají omezené úrovně detailu:

• Summary vrací topologii, identitu a verze s nejmenším výstupem.
• Properties přidává vlastnosti, které lze omezit pomocí propertyKeys.
• Full přidává dostupné důkazy a vrací všechny vlastnosti v mezích výstupu.

Začněte s Summary. O Properties nebo Full požádejte pouze pro relevantní uzly a vztahy. list_graphs používá vlastní volbu detailu Summary nebo Full, kde Full přidává omezené popisy.

Bezpečný postup zápisu

1. Vypište Graphy a ověřte cíl a hodnotu canWrite.
2. Před vytvořením čehokoli vyhledejte každou zmíněnou entitu.
3. Před nahrazením nebo odstraněním načtěte existující uzel či vztah s detailem Full a bez propertyKeys.
4. Pokud úplné čtení hlásí outputTruncated, zastavte se; ze zkráceného obsahu nelze vytvořit bezpečnou úplnou náhradu.
5. Odešlete úplnou náhradu, zachovejte autorizované strukturované důkazy a uveďte aktuální expectedVersion.
6. Před další změnou ověřte vrácený identifikátor a verzi.

Create operace nejsou idempotentní a generují nový identifikátor. Update a delete používají optimistické řízení souběhu a místo tichého přepsání novější verze selžou. Pokyny pro extrakci jsou konfigurace, nikoli důkaz nebo autorizace k zápisu.

Bezpečnostní metadata a potvrzení

Anotace read-only, create, destructive, idempotent a open-world popisují zamýšlený efekt nástroje. send_message, run_workflow, aktualizace, mazání a approve_tool_call mohou změnit stav nebo spustit další akce. Destructive anotace může kompatibilnímu klientovi umožnit varování, ale negarantuje jeho approval dialog.

Před stavovým voláním ukažte uživateli cíl a úplné argumenty, použijte potvrzovací policy klienta a potom ověřte výsledný objekt nebo externí efekt. Doporučený režim uvádí MCP governance matice. Endpoint ani klient neoznačujte za marketplace-approved bez samostatně ověřeného publikačního stavu.