Pripojenie AI asistenta cez MCP

Kedy to použijem

Chcete, aby AI asistent mimo Dakoty pracoval priamo s údajmi vašej organizácie — napríklad Claude v desktopovej aplikácii, na claude.ai alebo v termináli (Claude Code). Asistent potom vie vyhľadať klienta, založiť úlohu alebo pripraviť prehľad faktúr po splatnosti.

Pripája sa cez MCP (Model Context Protocol) na adresu https://api.dakoty.com/mcp a prihlasuje sa vaším osobným MCP tokenom. Vstavaný AI asistent priamo v aplikácii Dakoty žiadny token nepotrebuje.

Kde to nájdem

MCP tokeny spravujete vo svojom profile: otvorte menu používateľa vpravo hore, zvoľte položku Upraviť profil a prejdite na kartu Osobné tokeny a AI.

Adresa v aplikácii: /profile?tab=api-tokens

Postup

Na karte Osobné tokeny a AI kliknite na Vytvoriť MCP token.
Vyplňte Názov, podľa ktorého token neskôr spoznáte v zozname, napríklad Claude – pracovný notebook.
V poli Organizácia vyberte organizáciu. Token bude fungovať len v nej.
V poli Expirácia ponechajte predvolený dátum o rok alebo zvoľte kratší. Token prestane platiť na začiatku zvoleného dňa. Prázdne pole znamená token bez expirácie.
Potvrďte tlačidlom Vytvoriť. Otvorí sa okno Token vygenerovaný s tokenom, adresou MCP servera a hotovým príkazom pre Claude Code.
Token hneď skopírujte a uložte na bezpečné miesto. Po zatvorení okna ho už nezobrazí nikto — ani podpora Dakoty.

Pripojenie: Claude cez vlastný konektor

Vlastný konektor pridáte vo svojom účte Claude a funguje v desktopovej aplikácii aj na claude.ai. Spojenie s Dakoty nadväzujú servery Anthropic, nie váš počítač.

V Claude otvorte Customize > Connectors a zvoľte Add custom connector.
Zadajte názov (napríklad Dakoty) a adresu https://api.dakoty.com/mcp.
Ak Claude ponúkne prihlásenie, zvoľte No sign-in.
V časti Request headers pridajte hlavičku authorization s hodnotou Bearer <váš token> — vrátane slova Bearer a medzery.
Uložte konektor a v konverzácii ho zapnite cez tlačidlo + a položku Connectors.

Časť Request headers je v Claude zatiaľ v beta verzii a nemusíte ju mať k dispozícii. V takom prípade použite konfiguračný súbor Claude Desktop.

Pripojenie: Claude Desktop cez konfiguračný súbor

Tento spôsob potrebuje v počítači Node.js. Komunitný nástroj mcp-remote (nie je od Anthropic ani od Dakoty) premosťuje Claude Desktop na vzdialený server.

V Claude Desktop otvorte Settings > Developer a kliknite na Edit Config.
Do súboru claude_desktop_config.json doplňte:

{
  "mcpServers": {
    "dakoty": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.dakoty.com/mcp", "--header", "Authorization:${DAKOTY_AUTH}"],
      "env": { "DAKOTY_AUTH": "Bearer <váš token>" }
    }
  }
}

Claude Desktop úplne ukončite a znova spustite.

Hlavička je zapísaná bez medzery za dvojbodkou zámerne — Claude Desktop na Windows inak argument rozdelí.

Pripojenie: Claude Code

V termináli spustite (token vložte za slovo Bearer):

claude mcp add --transport http dakoty https://api.dakoty.com/mcp --header "Authorization: Bearer <váš token>"

Prepínač --scope user sprístupní Dakoty vo všetkých vašich projektoch. Stav overíte príkazom claude mcp list (pri serveri dakoty uvidíte Connected) alebo príkazom /mcp priamo v Claude Code.

Token nevkladajte do súboru .mcp.json, ktorý sa ukladá do repozitára. Ak ho potrebujete v projekte, použite premennú prostredia: "headers": { "Authorization": "Bearer ${DAKOTY_MCP_TOKEN}" }.

Pripojenie: iné MCP klienty

Dakoty funguje s každým MCP klientom, ktorý podporuje transport Streamable HTTP a vlastné HTTP hlavičky:

adresa servera: https://api.dakoty.com/mcp
hlavička: Authorization: Bearer <váš token>

Klienty, ktoré vedia spúšťať len lokálne (stdio) servery, pripojíte cez mcp-remote rovnako ako Claude Desktop. Starší transport SSE Dakoty nepodporuje. Prihlásenie cez OAuth je dostupné len pre klientov, ktorých zaregistroval správca Dakoty — bežne použite MCP token.

Výsledok

Asistent vidí nástroje Dakoty a volá ich vaším menom. Pripojenie overíte napríklad tak, že asistenta požiadate o overenie pripojenia k Dakoty: zavolá nástroj ping a odpovie vaším menom a priezviskom s e-mailom, názvom organizácie a názvom vašej roly (napr. „Vlastník“). Ping zároveň ukáže rozsah prístupu tokenu – pri plnom prístupe „Plný prístup podľa roly …“, pri obmedzenom tokene zoznam povolených nástrojov.

Na karte Osobné tokeny a AI sa pri tokene po prvom použití vyplní dátum v stĺpci Naposledy použitý.

Čo asistent dokáže

Server ponúka 1248 nástrojov v 51 oblastiach (stav k októbru 2026). Asistent však uspeje len pri akciách, na ktoré máte oprávnenie vo svojej role — rovnako ako keby ste klikali v aplikácii sami. Nástroje na mazanie vyžadujú výslovné potvrdenie (confirm=true), takže asistent nič nezmaže omylom bez vášho pokynu.

Aktuálny zoznam vráti klient sám (napríklad /mcp v Claude Code). Prehľad podľa oblastí obsahujú nasledujúce časti tohto článku.

Nástroje: CRM, úlohy a používatelia

Overenie: ping
Klienti: clients_list, clients_get, clients_create, clients_update, clients_delete
Leady: leads_list, leads_list_active, leads_list_today, leads_get, leads_create, leads_update, leads_archive, leads_restore, leads_delete, leads_tags_set, leads_tags_bulk_set, leads_create_from_companies, leads_origins_list, leads_tags_list
Spoločnosti: companies_list, companies_autocomplete, companies_get, companies_create, companies_update, companies_delete, companies_tags_list
Kontaktné osoby: companies_persons_create, companies_persons_update, companies_persons_delete
Dodávatelia: suppliers_list, suppliers_list_active, suppliers_get, suppliers_create, suppliers_update, suppliers_toggle_active, suppliers_statistics
Používatelia a role: users_list, users_autocomplete, roles_list
Aktivity: activities_list, activities_calendar, activities_get, activities_create, activities_update, activities_toggle_status, activities_toggle_priority, activities_delete
Úlohy: tasks_list, tasks_get, tasks_create, tasks_update, tasks_move, tasks_toggle_status, tasks_delete, tasks_assignees_add, tasks_assignees_remove
Komentáre a poznámky: comments_list, comments_create, comments_update, comments_delete, notes_append

Nástroje: úlohy – doplnky

Úlohy – doplnky: tasks_workload, tasks_labels_list, tasks_labels_create, tasks_labels_add, tasks_labels_remove, tasks_archive, tasks_unarchive, tasks_archive_completed, tasks_subtasks_list, tasks_subtasks_create, tasks_checklist_add, tasks_checklist_update, tasks_checklist_delete, tasks_followers_add, tasks_followers_remove, tasks_dependencies_list, tasks_project_dependencies, tasks_dependencies_add, tasks_dependencies_remove, tasks_custom_fields_list, tasks_custom_fields_set, tasks_schedule_activity

Nástroje: projekty

Projekty: projects_list, projects_get, projects_create, projects_update, projects_delete, projects_duplicate_as_template, projects_create_from_template, projects_members_add, projects_members_remove, projects_stages_create, projects_stages_update, projects_stages_delete, projects_stages_reorder, projects_custom_fields_list, projects_custom_fields_create, projects_budget_set, projects_budget_report, projects_billing_rates_list, projects_billing_rates_set, projects_invoice_draft, projects_portal_links_list, projects_portal_links_send, projects_portal_links_revoke

Nástroje: výkazy času

Výkazy času: time_current, time_start, time_pause, time_resume, time_stop, time_manual_add, time_update, time_delete, time_activity_history, time_activity_summary, time_report_by_user, time_report_by_item

Nástroje: financie a doklady

Doklady: budget_documents_list, budget_documents_get, budget_documents_create, budget_documents_update, budget_documents_delete, budget_documents_mark_paid, budget_documents_send, budget_documents_convert, budget_documents_related
Cenové ponuky: budget_quotes_accept, budget_quotes_reject, budget_quotes_create_invoice, budget_quotes_create_advance, budget_quotes_duplicate
Kategórie, rozpočty a kredity: budget_categories_list, budget_categories_get, budget_categories_create, budget_categories_update, budget_categories_delete, budget_plans_list, budget_plans_for_year, budget_plans_for_month, budget_plans_create, budget_plans_update, credit_balance, credit_transactions, credit_statistics
Analytika: analytics_overview, analytics_cash_flow, analytics_category_breakdown, analytics_top_customers, analytics_top_suppliers, analytics_payment_status, analytics_budget_comparison

Nástroje: produkty, pošta a notifikácie

Produkty: products_list, products_autocomplete, products_lookup_by_ean, products_get, products_create, products_update, products_toggle_active, products_delete, products_categories_list, products_units_list
Obrázky produktu (vyžadujú zapnutý e-shop): products_images_list, products_images_add, products_images_remove
E-mailové schránky: mailboxes_list, mailbox_folders, messages_list, messages_get, messages_thread, messages_send, messages_reply, messages_forward, messages_mark_read, messages_mark_unread, messages_toggle_flag, messages_mark_bulk_read
Komunikácia a notifikácie: communication_log_list, communication_log_get, notifications_list, notifications_unread, notifications_unread_count, notifications_mark_read, notifications_mark_all_read

Nástroje: sklad a katalóg

Sklady a skladové miesta: warehouses_list, warehouses_create, warehouses_update, warehouses_toggle_active, warehouses_delete, warehouses_set_bins_enabled, warehouse_bins_list, warehouse_bins_products, warehouse_bins_create, warehouse_bins_update, warehouse_bins_delete
Zásoby produktu: products_stock_get, products_stock_config_set, products_preferred_bin_set, products_lots_list, products_kit_components_get, products_kit_components_set, products_kit_availability
Zásoby a pohyby: stock_levels_list, stock_levels_summary, stock_report, stock_audit_log, stock_movements_list, stock_movements_get, stock_movements_create, stock_movements_delete, stock_reservations_list, stock_reservations_create, stock_reservations_release
Inventúry, vychystávanie a dodacie listy: stocktakes_list, stocktakes_get, stocktakes_create, stocktakes_start, stocktakes_record_counts, stocktakes_approve, stocktakes_cancel, picking_lists_list, picking_lists_get, picking_lists_create, picking_lists_start, picking_lists_pick_item, picking_lists_complete, picking_lists_cancel, delivery_notes_list, delivery_notes_get, delivery_notes_update
Kategórie a jednotky produktov (zápis): products_categories_get, products_categories_create, products_categories_update, products_categories_delete, products_units_create, products_units_delete

Nástroje: objednávky, nákup a reklamácie

Objednávky: orders_list, orders_get, orders_create, orders_update, orders_confirm, orders_ship, orders_cancel, orders_set_status, orders_set_payment_status, orders_create_invoice
Objednávky dodávateľom: purchase_orders_list, purchase_orders_get, purchase_orders_create, purchase_orders_send, purchase_orders_receive, purchase_orders_cancel
Vratky a reklamácie: returns_list, returns_get, returns_create, returns_approve, returns_receive, returns_inspect, returns_resolve, returns_reject, returns_cancel

Nástroje: doklady – doplnky

Doklady: budget_documents_pdf, budget_documents_statistics, budget_documents_next_number, budget_documents_email_template, budget_documents_batch_mark_paid, budget_documents_batch_convert
Upomienky: budget_invoices_reminder_preview, budget_invoices_send_reminder
Dobropisy: budget_credit_notes_eligible_invoices, budget_credit_notes_credit_info, budget_credit_notes_from_invoice
Cenové ponuky: budget_quotes_conversion_info, budget_quotes_create_final
Odkazy na online prijatie ponuky: budget_quotes_public_link_create, budget_quotes_public_links_list, budget_quotes_public_link_revoke. Ponuku vie asistent prepojiť s leadom cez pole lead_uuid v nástrojoch budget_documents_create a budget_documents_update.
Predajky a prijaté faktúry: budget_sales_receipts_daily_summary, budget_received_invoices_link_receipt, budget_received_invoices_unlink_receipt
Dodávatelia: suppliers_autocomplete, suppliers_delete, suppliers_vat_info

Nástroje: rozpočty, cenníky a kurzy

Kategórie rozpočtu: budget_categories_move, budget_categories_reorder, budget_categories_ensure_defaults
Rozpočtové plány: budget_plans_get, budget_plans_delete, budget_plans_available_years, budget_plans_yearly_comparison, budget_plans_category_comparison, budget_plans_recalculate, budget_plans_copy_from_previous_year
Cenníky: price_lists_list, price_lists_get, price_lists_resolve, price_lists_create, price_lists_update, price_lists_delete, price_lists_items_upsert, price_lists_items_delete
Kurzy mien: exchange_rates_list, exchange_rates_history, exchange_rates_override_set, exchange_rates_override_delete
Nastavenia fakturácie: invoicing_numbering_variables, invoicing_numbering_preview, invoicing_filename_variables, invoicing_filename_preview, invoicing_reminder_variables, invoicing_reminder_preview, invoicing_reminder_settings_get, invoicing_reminder_settings_update

Nástroje: banka a e-faktúry

Bankové účty: banking_accounts_list, banking_accounts_create, banking_accounts_update, banking_accounts_delete, banking_accounts_email_channel_enable, banking_accounts_email_channel_disable
Výpisy a pohyby: banking_statements_upload, banking_statements_list, banking_transactions_list, banking_transactions_get, banking_transactions_suggestions, banking_transactions_match, banking_transactions_matches, banking_transactions_unmatch, banking_transactions_ignore
Import e-faktúr: einvoice_preview_import, einvoice_import

Modul Banka musí byť pre organizáciu zapnutý, inak asistent dostane odpoveď „modul nie je aktivovaný“.

Nástroje: OCR

Úlohy: ocr_imports_upload, ocr_imports_credit_info, ocr_imports_statistics, ocr_imports_segments, ocr_imports_confirm, ocr_imports_change_method, ocr_imports_correct, ocr_imports_complete, ocr_imports_complete_batch, ocr_imports_reject_batch, ocr_imports_delete
Odoslanie výsledku: ocr_imports_send_to_budget_batch, ocr_imports_send_to_contact, ocr_imports_send_to_products
Šablóny: ocr_templates_list, ocr_templates_get, ocr_templates_for_select, ocr_templates_presets, ocr_templates_models, ocr_templates_preview_complexity, ocr_templates_create, ocr_templates_create_from_preset, ocr_templates_update, ocr_templates_delete, ocr_templates_delete_batch, ocr_templates_clone, ocr_templates_validate_schema

Nástroje: dokumenty a zmluvy klienta

Dokumenty a šablóny: documents_get, documents_create, documents_update, documents_delete, documents_import, documents_templates_autocomplete, documents_preview, documents_extract_variables
Verzie šablón: documents_versions_list, documents_versions_get, documents_versions_restore
Zmluvy (všetky): contracts_list, contracts_stats, contracts_numbering_preview, contracts_delete
Zmluvy klienta: client_contracts_list, client_contracts_get, client_contracts_create, client_contracts_update, client_contracts_send, client_contracts_mark_signed, client_contracts_preview_html, client_contracts_regenerate, client_contracts_delete

Nástroje: mailingy a SMS klienta

Mailingy: client_mailings_list_all, client_mailings_list, client_mailings_get, client_mailings_logs, client_mailings_variables, client_mailings_preview, client_mailings_create, client_mailings_update, client_mailings_activate, client_mailings_deactivate, client_mailings_pause, client_mailings_send_test, client_mailings_send_now, client_mailings_delete, client_mailings_delete_batch
SMS notifikácie: client_sms_list_all, client_sms_list, client_sms_get, client_sms_logs, client_sms_variables, client_sms_preview, client_sms_create, client_sms_update, client_sms_activate, client_sms_deactivate, client_sms_pause, client_sms_send_test, client_sms_send_now, client_sms_delete, client_sms_delete_batch

Nástroje: súbory a prílohy

Súbory: files_upload, files_get, files_download
Prílohy úloh, firiem a produktov: attachments_list, attachments_add, attachments_remove

Súbor sa posiela priamo v požiadavke (kódovaný ako base64) a má najviac 10 MB. Nahrá sa do Správcu súborov rovnako, ako keby ste ho nahrali v aplikácii, takže sa vám započíta do kvóty úložiska a platia oprávnenia na priečinok. attachments_add ho zároveň priloží:

k úlohe — objaví sa v záložke Prílohy úlohy; odobratím sa súbor len odpojí a ostane v Správcovi súborov,
k firme — súbor sa uloží do priečinka záložky Prílohy firmy; odobratím sa súbor zmaže (presunie do koša),
k produktu — len obrázky a videá, alebo dokument (napríklad PDF) ako externý odkaz (url). Asistent odkaz nikdy sám nestiahne, len ho uloží k produktu.

files_get vráti údaje o súbore a dočasný odkaz na stiahnutie (platí 15 minút), files_download vráti obsah súboru do 5 MB, aby ho asistent mohol prečítať. Uložený súbor sa dá poslať aj ako príloha e-mailu (messages_send, messages_reply, messages_forward) alebo dokladu (budget_documents_send) cez pole attachment_file_uuids (najviac 10 súborov).

Prílohy majú aj hromadné verzie: files_bulk_upload, attachments_bulk_add, attachments_bulk_remove, products_images_bulk_add a products_images_bulk_remove. Nahrávanie je obmedzené na 5 súborov na jedno volanie, odoberanie na 50 položiek.

Nástroje: dokumenty, importy, automatizácia a prehľady

E-faktúry a dokumenty: einvoice_formats, einvoice_can_export, einvoice_export, einvoice_export_batch, documents_templates, documents_variables, documents_list
Importy a OCR: imports_list, imports_get, imports_logs, imports_start, imports_cancel, imports_retry, imports_modules_list, imports_module_fields, imports_file_upload, imports_rows_upload, imports_auto_map, imports_validate, imports_execute, imports_rollback, ocr_imports_list, ocr_imports_needs_action, ocr_imports_get, ocr_imports_send_to_budget, ocr_imports_reject
Automatizácia a pohľady: dataflow_list, dataflow_get, dataflow_execute, dataflow_dry_run, dataflow_executions_list, dataflow_execution_get, datatable_views_list, calendar_feeds_list
Dashboard a vyhľadávanie: dashboard_activities_today, dashboard_activities_upcoming, dashboard_invoices_overdue, dashboard_leads_stats, dashboard_invoices_stats, dashboard_revenue_stats, spotlight_search

Nástroje: firmy a leady – doplnky

Adresy firmy: companies_addresses_create, companies_addresses_update, companies_addresses_set_default, companies_addresses_set_hq, companies_addresses_delete
Firemný e-mail a telefón: companies_contacts_create, companies_contacts_update, companies_contacts_delete
Štítky firiem: companies_tags_create, companies_tags_update, companies_tags_delete, companies_tags_set
Zlúčenie a prepojenie: companies_merge_preview, companies_merge, companies_linked_list, companies_linked_add, companies_linked_remove
Súvisiace zoznamy firmy: companies_activities_list, companies_contracts_list, companies_clients_list, companies_invoices_list
Leady: leads_list_archived, leads_merge_preview, leads_merge
Zdroje a štítky leadov: leads_origins_create, leads_origins_update, leads_origins_delete, leads_origins_reorder, leads_tags_create, leads_tags_update, leads_tags_delete, leads_tags_reorder

Zlúčenie firiem aj leadov je nevratné a vyžaduje confirm=true; najprv ho ukáže náhľad (*_merge_preview). Leady sa dajú zlúčiť len v rámci tej istej firmy.

Nástroje: Obchodný register (monitoring zmien)

Monitoring Obchodného registra sleduje vybrané firmy a dodávateľov a ukazuje zmeny z registra. Vyžaduje platený doplnok Monitoring Obchodného registra a oprávnenie na firmy a dodávateľov v rozsahu „všetko“. Zmeny sa zapisujú len ako úpravy; nič sa nemaže.

br_monitoring_summary — prehľad: počty sledovaných subjektov, čakajúce zmeny a dátum posledného importu registra.
br_monitoring_changes_list — zoznam sád zmien, filtrovateľný podľa stavu a typu, s hľadaním podľa IČO či názvu.
br_monitoring_changes_get — detail sady: stará a nová hodnota z registra a hodnota v CRM, vrátane konfliktu.
br_monitoring_changes_resolve — prijme alebo zamietne položky jednej sady; vyžaduje potvrdenie (confirm=true).
br_monitoring_changes_resolve_all — hromadne vyrieši 1 až 200 sád (prijať bez konfliktov, alebo zamietnuť všetko); vyžaduje potvrdenie (confirm=true).
br_monitoring_target_get — stav sledovania jednej firmy alebo dodávateľa vrátane dôvodu, ak sa nesleduje.
br_monitoring_target_set_enabled — zapne alebo vypne sledovanie v registri; záznam v CRM sa nemení.
br_monitoring_target_decide_identity — potvrdí alebo zamietne, že názov v registri patrí záznamu v CRM; potvrdenie zhody vyžaduje confirm=true.
br_monitoring_identity_checks_list — záznamy s nezhodným názvom, ktoré čakajú na potvrdenie zhody.
br_monitoring_compare_start — spustí porovnanie CRM s registrom bez zápisu do CRM; dá sa spustiť raz za 24 hodín.

Nástroje: obchodné fázy leadov

Obchodné fázy a pipeline: lead_pipelines_list, lead_pipelines_create, lead_pipelines_update, lead_pipelines_delete, lead_pipelines_reorder, lead_stages_create, lead_stages_update, lead_stages_delete, lead_stages_reorder
Dôvody prehry: lead_lost_reasons_list, lead_lost_reasons_create, lead_lost_reasons_update, lead_lost_reasons_delete, lead_lost_reasons_reorder
Nástenka, presuny a prehľad: leads_board, leads_pipeline_report, leads_stage_history, leads_list_stale, leads_move, leads_batch_move, leads_mark_won, leads_mark_lost, leads_reopen

Pri zmazaní fázy alebo pipeline s leadmi treba uviesť, kam sa leady presunú. Nástroje leads_create a leads_update vedia nastaviť aj fázu a očakávané uzavretie a leads_archive prijme dôvod prehry. Presun do fázy Prehraný pri pipeline s povinným dôvodom vyžaduje dôvod prehry. Rovnako ako v aplikácii platí oprávnenie Spravovať obchodné fázy - Leady pre zmeny fáz a dôvodov.

Nástroje: aktivity – doplnky

Typy aktivít (najviac 25): activity_types_list, activity_types_create, activity_types_update, activity_types_delete, activity_types_reorder
Komunikačné kanály (najviac 20): communication_methods_list, communication_methods_create, communication_methods_update, communication_methods_delete, communication_methods_reorder
Štítky aktivít: activity_tags_list, activity_tags_create, activity_tags_update, activity_tags_delete, activity_tags_reorder
Priradenie a termín: activities_tags_set, activities_communication_methods_set, activities_communication_methods_batch_update, activities_reschedule, activities_history
Pozvánky: activities_invites_recipients, activities_invites_list, activities_invites_send, activities_invites_cancel, activities_invites_batch_send
Opakované aktivity: activities_series_pause, activities_series_activate, activities_series_delete

Typ alebo kanál, ktorý sa používa, sa zmazať nedá. Zmena poradia (*_reorder) vyžaduje celý zoznam uuid. Odoslanie a zrušenie pozvánky posiela skutočný e-mail s ICS prílohou, preto vyžaduje confirm=true.

Nástroje: kalendáre a porady

Kalendáre: calendars_list, calendars_create, calendars_update, calendars_delete
Udalosti: calendar_events_list, calendar_events_create, calendar_events_update, calendar_events_delete
Zdieľanie kalendára: calendars_shares_list, calendars_shares_set, calendars_shares_delete
Porady: meetings_list, meetings_get, meetings_create, meetings_update, meetings_cancel, meetings_pricing, meetings_share_link_create, meetings_recordings_list, meetings_transcript_get
Kalendárové feedy (ICS): calendar_feeds_list, calendar_feeds_create, calendar_feeds_update, calendar_feeds_delete, calendar_feeds_regenerate_token

Úprava udalosti vyžaduje jej pôvodný začiatok (current_starts_at z calendar_events_list). Poradu s externým účastníkom, zrušenie porady aj nový verejný odkaz potvrdzujete cez confirm=true; externému účastníkovi odíde e-mail. Zapnutie nahrávania alebo prepisu porady (record_enabled, transcribe_enabled) stojí kredity, preto aj to vyžaduje confirm=true; cenu ukáže meetings_pricing. Samotné nahrávanie a pripojenie do porady asistent neovláda (nahrávky a prepis dokáže len prečítať). Feed vráti tajnú adresu ics_path; nový token zneplatní starú adresu.

Nástroje: pošta a notifikácie – doplnky

Pošta: mail_drafts_save, messages_delete, messages_attachments_download
Notifikácie: notifications_delete, notifications_delete_all, notifications_settings_get, notifications_settings_update
Komunikačný log: communication_log_delete; communication_log_list má navyše filtre podľa zdroja, stavu, dátumov, firmy a používateľa

Koncept sa uloží len v Dakoty (priečinok Drafts), neodošle sa. messages_delete odstráni správy len z Dakoty, nie z poštového servera, a pri ďalšej synchronizácii sa môžu vrátiť. Príloha sa dá stiahnuť do 5 MB. Nastavenia notifikácií platia pre používateľa vo všetkých jeho organizáciách. Mazanie všetkých notifikácií vyžaduje confirm=true.

Nástroje: dataflow a pohľady – doplnky

Podklady: dataflow_node_types_list, dataflow_event_types_list
Dataflow: dataflow_create, dataflow_update, dataflow_delete, dataflow_validate, dataflow_duplicate, dataflow_set_active
Behy: dataflow_executions_cancel, dataflow_executions_delete, dataflow_executions_entities, dataflow_executions_stats
Plány spúšťania: dataflow_schedules_list, dataflow_schedules_create, dataflow_schedules_update, dataflow_schedules_delete
Sledované priečinky: dataflow_file_triggers_list, dataflow_file_triggers_create, dataflow_file_triggers_update, dataflow_file_triggers_delete
Uložené pohľady tabuliek: datatable_views_create, datatable_views_update, datatable_views_delete, datatable_views_unset_default

Nový dataflow vzniká vypnutý a kópia (dataflow_duplicate) vzniká rovno vypnutá, takže nikdy nie je ani na okamih živá. Odporúčaný postup: vytvoriť, dataflow_validate, dataflow_dry_run, až potom dataflow_set_active. Hlavičky webhookov (napríklad API kľúče) asistentovi nezobrazíme, v odpovediach sú ako <redacted>, a do auditného záznamu sa ich hodnoty neukladajú. Zmena celého grafu, rušenie behov a mazanie vyžadujú confirm=true.

Nástroje: smernice a formuláre

Články smerníc: handbook_articles_list, handbook_articles_get, handbook_articles_create, handbook_articles_update, handbook_articles_delete
Štítky a prístupy: handbook_tags_list, handbook_tags_create, handbook_tags_update, handbook_tags_delete, handbook_tags_set_grants, handbook_principals_list
Formuláre: forms_list, forms_get, forms_create, forms_update, forms_delete, forms_duplicate
Odoslania formulárov: forms_submissions_list, forms_submissions_get

Nový článok je predvolene koncept. Formulár s akciou na vytvorenie zmluvy sa nastavuje vo webe (vyžaduje krajinu). Zmazaný formulár prestane na verejnom odkaze fungovať, preto mazanie vyžaduje confirm=true.

Nástroje: správca súborov

Prehliadanie: files_browse, files_trash_list, files_trash_restore
Priečinky: files_directories_create, files_directories_ensure_path, files_directories_rename, files_directories_move, files_directories_delete
Súbory: files_rename, files_move, files_delete
Verejné odkazy: files_shares_list, files_shares_create
Oprávnenia a hostia: files_permissions_list, files_permissions_grant, files_invite_external, files_guests_list, files_guests_revoke

Súbor nahráte nástrojom files_upload. Mazanie presúva súbory a priečinky do koša. Verejný odkaz, pozvánka externej osoby a udelenie oprávnenia owner vyžadujú confirm=true. Zrušenie verejného odkazu, odobratie oprávnenia a zmenu jeho úrovne zatiaľ urobte vo webe.

Import súborov a tabuliek

Väčšie množstvo dát (napríklad tabuľku firiem s kontaktnými osobami) asistent nahrá cez import: najprv ukáže návrh priradenia stĺpcov a výsledok kontroly a import spustí až s vaším potvrdením. Súbor môže byť CSV, XLSX, XLS alebo ODS do 10 MiB, alebo tabuľka priamo z konverzácie (najviac 5 000 riadkov). Import beží na pozadí; jeho stav a chyby jednotlivých riadkov asistent vypíše na požiadanie a dokončený import vie vrátiť späť (potvrdenie confirm=true). Vyžaduje oprávnenie na správu importov. Na menej ako 50 záznamov použije hromadné nástroje.

Projekty, úlohy a výkazy času

Asistent zvládne to, čo robíte v module Projekty: založí projekt (so štyrmi predvolenými stĺpcami nástenky alebo zo šablóny), pridá členov a stĺpce, nastaví poradie stĺpcov, vlastné polia, rozpočet a hodinové sadzby a pripraví návrh faktúry z výkazov (nič neuloží, doklad vytvoríte samostatne). Pri úlohách pridá podúlohy, položky checklistu, štítky, sledujúcich a závislosti, archivuje a obnovuje úlohy a nastaví hodnoty vlastných polí; hodnotu najprv skontroluje podľa typu poľa (číslo, dátum, výber z možností, používateľ, text).

Čo asistent robí len s vaším výslovným potvrdením (confirm=true): zmazanie projektu, stĺpca, položky checklistu alebo časového záznamu, zrušenie odkazu na klientsky portál, archivácia všetkých dokončených úloh v stĺpci a odoslanie e-mailu s odkazom na portál klientovi. Projekt s priradenými členmi sa nedá zmazať — najprv treba členov odobrať; stĺpec so zapísanými úlohami tiež nie.

Časovač (time_start) beží vždy len jeden: nový štart zastaví predošlý. Čas môže merať a zapisovať len riešiteľ úlohy alebo aktivity; ručný záznam môže trvať najviac 24 hodín. Čas bez časového pásma asistent berie ako lokálny čas Europe/Bratislava. Cudzie záznamy smiete upravovať len s oprávnením na zobrazenie času všetkých používateľov.

Objednávky a sklad

Asistent vie viesť objednávku od založenia po faktúru: vytvoriť ju (aj s okamžitým potvrdením a rezerváciou tovaru), potvrdiť, posunúť stav (zabalená, pripravená na odber, doručená), expedovať, zrušiť a vystaviť z nej faktúru. Zmena stavu na potvrdenú, expedovanú alebo zrušenú má vlastný nástroj. Úprava objednávky nahradí všetky položky naraz a funguje len pre novú objednávku. Objednávku v stave „pripravená na odber“ najprv nastavte na „zabalená“, až potom ju možno expedovať.

Sklad: založenie skladov a skladových miest, nastavenie minimálnej zásoby, príjem, výdaj, presun a korekcia zásob, rezervácie, inventúra (založiť, spustiť, zapísať počty, schváliť), vychystávanie s dodacím listom, objednávky dodávateľom s príjmom tovaru a vratky či reklamácie od prijatia po vybavenie. Úpravu skladu aj kategórií a jednotiek smie robiť len ten, kto má oprávnenie na nastavenia.

Potvrdenia v obchode a sklade

Čo asistent robí len s vaším výslovným potvrdením (confirm=true) v obchode a sklade: expedícia a storno objednávky, faktúra z objednávky, stav „vrátená“, schválenie a storno inventúry, dokončenie vychystávania, príjem tovaru od dodávateľa, výdaj a korekcia skladu, prijatie, vybavenie (môže vystaviť dobropis), zamietnutie a storno vratky, zmazanie skladov, skladových miest, kategórií, jednotiek a pohybov. Hromadná zmena stavu objednávok potvrdenie vyžaduje vždy.

Financie a doklady

Asistent vie založiť a upraviť doklad ktoréhokoľvek typu, vytvoriť jeho PDF (dostane dočasný odkaz na stiahnutie, platí 15 minút), označiť doklady ako zaplatené, skonvertovať ich a poslať e-mailom. Dobropis vystaví len k faktúre, pričom sa kontroluje zostatok; druhý dobropis nad zostatok backend odmietne. Bez zadaných položiek sa dobropisujú všetky položky pôvodnej faktúry; ak je faktúra už čiastočne dobropisovaná, asistent musí položky zadať (najprv si pozrie súhrn dobropisov). Stav dokladu (zaplatený, storno) sa mení len cez na to určené akcie s potvrdením, nie bežnou úpravou dokladu. Z cenovej ponuky vie vystaviť zálohovú, bežnú aj konečnú faktúru. K nezaplatenej vydanej faktúre vie pripraviť a odoslať upomienku. Rozpočtové plány, kategórie, cenníky (aj hromadné nahratie položiek) a ručné kurzy mien sa spravujú rovnako ako v aplikácii.

Pri rozpočtových porovnaniach a prepočte treba vždy zadať rok. Číselné identifikátory z odpovedí dokladov (napríklad tracking_id) asistent nedostane.

Banka, OCR a e-faktúry

Výpis asistent nahrá a spracuje sa na pozadí; potom vie ukázať nespárované pohyby, návrhy dokladov a platbu spárovať, čím sa doklad môže označiť ako zaplatený. Zrušenie spárovania cez asistenta nie je dostupné.

OCR: asistent nahrá doklad, ale platené spracovanie sa spustí až po potvrdení. Hromadné schválenie do rozpočtu vyžaduje výber konkrétnych úloh. E-faktúru (súbor .xml, .isdoc, .isdocx alebo .zip) najprv zobrazí v náhľade a až potom z nej vytvorí koncept prijatého dokladu.

Zmluvy, mailingy a SMS

Z dokumentu typu šablóna zmluvy asistent vytvorí zmluvu klienta, ukáže jej náhľad, odošle ju e-mailom a označí ako podpísanú. Mailingy a SMS notifikácie sa vytvárajú neaktívne; aktivovať sa dajú len s potvrdením. Testovací mailing príde na e-mail používateľa tokenu, nie zákazníkovi. SMS sa účtujú z kreditu organizácie — odhad dá client_sms_preview (počet častí). Obnovenie kurzov mien (refresh) a zrušenie spárovania platby asistent nevie.

Potvrdenia vo financiách a komunikácii

Len s výslovným potvrdením (confirm=true) asistent urobí: odoslanie dokladu, zmluvy alebo upomienky zákazníkovi, vystavenie dobropisu, označenie dokladu za zaplatené (aj v dávke), schválenie OCR úlohy do rozpočtu, spárovanie platby, zmazanie (dokladov, plánov, kategórií, cenníkov, dokumentov, zmlúv, mailingov, SMS, dodávateľov, bankových účtov, OCR úloh a šablón), ručný kurz meny, kopírovanie plánov z minulého roka, zapnutie automatických upomienok aj akúkoľvek zmenu už zapnutých upomienok, aktiváciu mailingu či SMS, okamžité odoslanie mailingu a SMS, potvrdenie platenej OCR úlohy a import e-faktúry. Hromadná verzia týchto nevratných akcií žiada jedno potvrdenie pre celú dávku; platené SMS hromadnú verziu nemajú.

Hromadné operácie

Takmer každý nástroj, ktorý niečo vytvára, mení alebo maže, má hromadnú verziu s _bulk_ v názve (napríklad tasks_bulk_create, companies_persons_bulk_update). Spracuje najviac 50 záznamov naraz, postupne, a vráti výsledok pre každý záznam; chyba jedného záznamu nezastaví ostatné, pokiaľ to nepožiadate (stop_on_error). Najprv môže všetko len skontrolovať (dry_run), mazanie vyžaduje potvrdenie (confirm=true). Ak token obmedzujete na konkrétne nástroje, hromadnú verziu treba povoliť zvlášť.

Výnimkou sú nástroje, ktoré hromadne pracujú už samy (až 500 položiek): leads_archive, leads_restore, leads_delete, leads_batch_move, leads_tags_bulk_set a leads_create_from_companies. Podobne zoznam uuid berú messages_delete, dataflow_delete, dataflow_executions_delete, forms_delete, files_delete a files_trash_restore (najviac 50). files_trash_restore na rozdiel od mazania nevyžaduje confirm, lebo súbory len vracia z koša.

Riešiteľov úlohy nastavíte priamo pri vytvorení úlohy. Ak na priraďovanie nemáte oprávnenie, úloha sa vytvorí bez riešiteľa a asistent vám to oznámi.

Nástroj leads_list_today považuje za „dnes“ kalendárny deň v časovom pásme Europe/Bratislava a prehľadá najviac 500 dnešných aktivít. Pri väčšom počte môžu niektoré leady vo výsledku chýbať.

Zmena vstupov pre existujúcich klientov

Nástroje na firmy a leady už nepoužívajú číselné identifikátory. Ak máte skripty alebo uložené pokyny, upravte ich:

country_id (číslo) nahradil country_code (dvojpísmenový kód krajiny, napríklad SK),
tag_ids (čísla) nahradili tag_uuids (UUID štítkov z companies_tags_list alebo leads_tags_list),
ostatné väzby (firma, kontaktná osoba, zdroj, vlastník, riešitelia) sa zadávajú ako UUID (company_uuid, origin_uuid, owner_uuid, assignee_uuids); namiesto UUID vlastného používateľa možno zadať me.

Staré vstupy už nefungujú — použite nové polia.

Zmeny vo financiách: budget_documents_delete maže jeden doklad (uuid), na viac použite budget_documents_bulk_delete; budget_documents_send vyžaduje confirm=true; budget_documents_create neakceptuje dobropis — použite budget_credit_notes_from_invoice.

Bezpečnosť

Rovnaké oprávnenia ako vy: token nedostane viac práv, než máte vo svojej role. Ak ste vlastník organizácie, asistent smie všetko, čo vy.
Jedna organizácia: token funguje len v organizácii, ktorú ste zvolili pri vytváraní. Pre ďalšiu organizáciu vytvorte samostatný token.
Expirácia: po dátume expirácie server token odmietne. Vytvorte nový a pôvodný zrušte.
Zrušenie: akcia Zrušiť token token okamžite zneplatní. Zrušte ho pri strate zariadenia, pri podozrení na únik alebo keď ho už nepotrebujete.
Jednorazové zobrazenie: Dakoty ukladá len odtlačok tokenu, nie jeho text, preto sa token nedá znova zobraziť.
Záznam a limity: každé volanie nástroja sa zapisuje do auditného záznamu. Počet volaní za minútu môže byť obmedzený; po prekročení server odpovie chybou 429. Hromadné volanie sa počíta ako jedno.
Čo sa do auditu neukladá: obsah súborov (len názov, veľkosť a odtlačok), heslá verejných odkazov, hodnoty hlavičiek webhookov a obsah konceptov e-mailov.
Súbory: najviac 10 MB; spustiteľné súbory a webové stránky (exe, js, html, svg) server odmietne.
Potvrdenie confirm=true: e-maily tretím stranám (pozvánky, porady s externými účastníkmi, pozvánky k súborom), verejné odkazy, prístup pre externú adresu a nahrávanie či prepis porady (stoja kredity).
Automatizácie: nové dataflow aj jeho kópia vznikajú vypnuté.
Token neposielajte e-mailom ani chatom a nevkladajte ho do zdieľaných súborov.

Časté problémy

Chyba 401 — token je zrušený, expirovaný alebo nesprávne skopírovaný, prípadne v hlavičke chýba slovo Bearer s medzerou. Tokeny iného typu ako MCP sa na MCP nepripoja.
Konektor v Claude nemá časť Request headers — funkcia je v Claude v beta verzii. Použite konfiguračný súbor Claude Desktop alebo Claude Code.
Asistent hlási, že akciu nesmie vykonať — vaša rola na ňu nemá oprávnenie. Rovnakú akciu by ste nemohli urobiť ani v aplikácii.
Pri tokene je štítok Expirovaný — token už neplatí; vytvorte nový.

Súvisiace

Môj profil — všetky karty profilu vrátane karty Osobné tokeny a AI.
AI asistent — vstavaný asistent priamo v aplikácii.
Role a oprávnenia — čo smie vaša rola, a teda aj asistent.