--- title: "Справочник за MCP инструменти на Payhawk - Payhawk Help Center" slug: "payhawk-mcp-tool-reference" description: "Вижте кои инструменти използва MCP на Payhawk, как инструментите за четене се различават от тези за запис, които искат потвърждение, и кои са най-полезни." updated: 2026-11-13T10:06:51Z published: 2026-11-13T10:06:51Z canonical: "payhawk.com/payhawk-mcp-tool-reference" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # Справочник за MCP инструменти на Payhawk Протоколът за контекст на модела (MCP) на Payhawk предоставя набор от структурирани инструменти, групирани по сфери. Списъкът с инструменти, който виждате, е филтриран според вашата роля и настройките на акаунта. Всеки инструмент е от един от двата типа: - Инструментите за четене (`read`) търсят и връщат информация (например извличане на разход или изброяване на картите ви). Те не променят нищо и автоматично се ограничават до разрешенията ви. - Инструментите за писане (`write`) извършват действия от ваше име, за да направят промяна (например актуализиране на полето категория на разход). Те винаги показват предварителен преглед и изискват потвърждение от ваша страна. > [!TIP] > AI асистентът автоматично избира правилния инструмент и не е необходимо да назовавате инструментите. Този справочник за MCP инструментите на Payhawk е предназначен за ИТ специалисти и лица, проверяващи сигурността, както и за любопитните относно техническата част. ## Полезни инструменти, които си струва да познавате Следните инструменти изпълняват наистина полезни функции, за които си струва да знаете. Те фигурират и в [пълния списък с MCP инструменти на Payhawk](/help/payhawk-mcp-tool-reference#full-list-of-supported-payhawk-mcp-tools). | Инструмент | Какво прави | За кого е предназначен | Кога да се използва и кога не | | --- | --- | --- | --- | | `submit_feedback` | Изпраща обратната ви връзка за работата с асистента до Payhawk – с ваши думи, с едно потвърждение и без формуляри. | Всеки, който използва асистента – похвала, недоволство, предложение или оплакване от грешка: всяка реакция, свързана с работата с MCP. | **Предназначение:** В момента, в който изразите мнение за работата с асистента, той предлага да го изпрати в едно кратко изречение. **Да не се използва за:** Въпроси за продукта или заявки за поддръжка (за тях има друг начин) – това е обратна връзка за MCP, а не запитване. | | `product_help` | Отговаря на въпроси от типа „Как да направя“ и „Достъпна ли е функция X за нас“ относно Payhawk, съобразено с това, което е активирано в акаунта ви, и подкрепено с помощни статии, към които може да прави препратки. | Всеки. Особено тези, които иначе биха отворили запитване за поддръжка по въпрос, на който е отговорено в статия: Служител, затруднен с подаването на разход, или Администратор на Payhawk, който проверява дали дадена функция е включена в плана му. | **Предназначение:** Въпроси, свързани с продукта. Как работи дадена функция, дали я имате и как да я активирате. **Да не се използва за:** Диагностициране на конкретно плащане, транзакция или възстановяване на разходи от вашия акаунт (за това е необходима връзка с актуалните данни) или обратна връзка за асистента (за нея има отделен канал). | | `list_card_acceptance_opportunities` | Показва доставчиците, на които плащате с банков превод и за които е известно, че приемат плащания с карта, заедно с банковите разходи, които биха могли да се прехвърлят към карта Payhawk и да носят награди. | Финансови контрольори и финансови администратори, търсещи награди за разходи, които компанията така или иначе прави. Това е инструментът зад въпроса за кешбек. | **Предназначение:** „На кои доставчици бихме могли да плащаме с карта вместо с банков превод?“ **Да не се използва за:** Промяна на начина на плащане (извършва се в настройките за фактуриране на всеки доставчик, а не в Payhawk). Инструментът никога няма да посочи конкретна сума за кешбек, тъй като размерът на наградите не е част от данните в Payhawk. | | `get_spend_benchmark` | Сравнява компанията ви с подобни компании по същия начин като сценария „Сравняване с подобни компании“. Когато счетоводната ви система е свързана с AI асистента, инструментът сравнява и разходите на цялата ви компания с тези на подобни компании и прави оценка колко бихте могли да спестите с Payhawk – в пари на година и в часове на месец. AI асистентът чете данните чрез собствения конектор на счетоводната ви система и не променя нищо в нея. Към Payhawk се изпращат само имената на счетоводните сметки, доставчиците и банковите сметки с техните суми, никога транзакции, фактури, номера на банкови сметки или лични данни. | Финансови контрольори, финансови администратори и финансови директори, които искат да знаят как се сравнява компанията им с подобни компании и къде може да спести. | **Предназначение:** „Как се сравняваме с подобни компании?“ или „Къде бихме могли да спестим?“ **Да не се използва за:** Отчет за разходите за даден период (за това е сценарият „Изготвяне на отчет за разходите“). | | `needs_my_attention` | Входящата ви кутия в Payhawk на едно повикване: Всичко, което ви чака – чакащи одобрения, заявки, задачи, липсващи разписки, както и сигнали от финансовия екип и администратори, свързани с вашата роля. | Всеки, със съдържание, съобразено с ролята: Служителите виждат собствените си елементи и неуспешни плащания с карта; финансовите екипи виждат броя на некатегоризираните и неекспортираните записи; Администраторите на Payhawk виждат сигнали за карти. | **Предназначение:** Всеки път, когато искате да видите какви задачи ви чакат – от сутрешен обзор до разчистване преди отпуск. **Да не се използва за:** Просто показване на броя на чакащите одобрения (за това съществува по-кратко обобщение); Показва някои елементи, върху които не може да действа (например прегледи на пътувания, одобрения от двама служители), като ги маркира за приложението. | | `insights_query_async` | Анализ във времето – общи суми и разбивки по компания/акаунт/екип/лице. За тенденциите в месечния наличен баланс се използва една крайна моментна снимка на баланс и месец, а не сбор от повтарящи се моментни снимки. | – | – | ## Пълен списък с поддържани инструменти Следващата таблица съдържа пълния набор от инструменти, поддържани като част от MCP на Payhawk. | Сфера | Инструменти | | --- | --- | | Разходи и документи | `list_expenses`, `get_expense`, `get_expense_approval_status`, `list_expense_payments`, `list_documents`, `upload_document`, `ingest_and_auto_match_receipt`, `create_expense`, `get_invoice_inbox`, `submit_expense`, `recode_expense`, `list_close_blockers`, `list_expense_reports`, `get_expense_report`, `list_expense_subscriptions`, `confirm_expense_subscription`, `manage_expense_subscription`, `list_mileage_claims` | | Карти, средства и транзакции | `list_cards`, `get_card`, `update_card_status` (замразяване, размразяване, закриване), `list_card_requests`, `get_card_request`, `create_card_request`, `list_fund_accounts`, `get_fund_account`, `list_balances`, `list_fund_account_activity`, `get_upcoming_payments`, `get_transaction`, `get_fx_rate` | | Одобрения и преглед | `review_queue`, `needs_my_attention`, `get_approval_request`, `approve_or_return`, `complete_expense_review`, `return_expense_for_review`, `list_audit_logs`, `out_of_office_delegate` | | Доставчици, поръчки за покупка и търговци | `list_suppliers`, `get_supplier`, `manage_supplier`, `list_purchase_orders`, `get_purchase_order`, `manage_purchase_order`, `list_purchase_order_types`, `list_merchants`, `get_merchant`, `list_card_acceptance_opportunities` | | Счетоводство, експорт и бюджети | `list_export_history`, `list_failed_exports`, `list_export_templates`, `run_export`, `list_account_codes`, `list_tax_rates`, `list_custom_fields`, `list_expense_categories`, `get_expense_category`, `budgets` | | Служители, екипи и политики | `list_accounts`, `list_users`, `get_user`, `list_teams`, `list_team_members`, `list_spend_policies`, `get_spend_policy`, `manage_spend_policy` | | Коментари | `add_comment`, `list_comments` | | Агенти и анализи на Payhawk | `insights_query_async`, `get_job_status` (проверява фоновата работа), `travel_agent` , `procurement_agent`, `payments_agent`, `dispatch_widget_action` (използва се само когато кликнете върху бутон в интерактивна карта, например при избор на полет), `get_agent_job_status` (проверява задачи на агенти и за продължаване на работата на изпълними модули) | | Обратна връзка | `submit_feedback` | | Насоки | `product_help`, `list_playbooks`, `get_playbook`, `draft_playbook`, `manage_playbook`, `get_spend_benchmark` |